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看 得 懂 学 得 会 做 得 出 


1， 经 验 丰富 ， 针 对 性 强 
笔者 既 担任 过 软件 开发 的 技术 经 理 ， 也 担任 过 软件 公司 的 培训 导师， 还 从 事 过 职业 培训 的 专职 讲师 。 
这 些 经 验 影 响 了 笔者 写 书 的 目的 ， 不 是 一 本 学 院 派 的 理论 读物 ， 而 是 一 本 实际 的 开发 指南 。 


2， 内 容 实际 ， 实 用 性 强 


本 书 所 介绍 的 Java EE 应 用 范例 ， 采 用 了 目前 企业 流行 的 开发 架构 ， 绝 对 严格 遵守 Java EE 开发 规范 ,而 
不 是 将 各 种 技术 杂乱 地 粳 合 在 一 起 号 称 Java EE。 读 者 参考 本 书 的 架构 ， 完 全 可 以 身 临 其 境地 感受 企业 实际 
开发 。 


3， 高 屋 建 领 ， 启 发 性 强 
本 书 介绍 的 几 种 架构 模式 ， 几 平 是 时 下 最 全 面 的 Java EE 架 构 模 式 。 这 些 架构 模式 可 以 直接 提升 读者 对 
系统 架构 设计 的 把 握 。 


阅读 此 书 有 任何 技术 问题 ， 都 可 以 登录 如 下 站 点 获得 解决 : 
疯狂 Java 联 盟 : http://www.crazyit.org 
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内 容 简介 


本 书 是 《 轻 量 级 Java EE 企业 应 用 实战 》 的 第 3 版 , 第 3 版 保持 了 第 2 版 内 容 全面 、 深 入 的 特点 ， 主 要 完成 全 部 知 
识 的 升级 。 

本 书 介绍 了 JavaEE 领域 的 三 个 开源 框架 :Struts 2、Spring 和 Hibemate。 其 中 Struts 2 升级 到 2.2.1，Spring 升级 到 
3.0.5，Hibernate 升级 到 了 3.6.0。 本 书 还 全 面 介 绍 了 Servlet 3.0 的 新 特性 ， 以 及 Tomeat 7.0 的 配置 和 用 法 ， 本 书 的 示例 
应 该 在 Tomcat 7.0 上 运行 。 

本 书 重 点 介绍 如 何 整合 Struts 2.2+Spring 3.0+Hibernate 3.6 进行 Java EE 开发 , 主要 包括 三 部 分 。 第 一 部 分 介绍 Java 
EE 开发 的 基础 知识 ， 以 及 如 何 搭建 开发 环境 。 第 二 部 分 详细 讲解 Struts 2.2、Spring 3.0 和 Hibernate 3.6 三 个 框架 的 用 
法 , 介绍 三 个 框架 时 ， 从 Eclipse IDE 的 使 用 来 上 手 , 一 步 步 带领 读者 深入 三 个 框架 的 核心 。 这 部 分 内 容 是 笔者 讲授 “ 疯 
狂 Java 实 训 ” 的 培训 讲义 ， 因 此 是 本 书 的 重点 部 分 ， 既 包含 了 笔者 多 年 开发 经 历 的 领悟 ， 也 融入 了 丰富 的 授课 经 验 。 
第 三 部 分 示范 开发 了 一 个 包含 7 个 表 、 表 之 间 具 有 复杂 的 关联 映射 、 继 承 映 射 等 关系 ， 且 业务 也 相对 复杂 的 工作 流 案 
例 , 希望 让 读者 理论 联系 实际 , 将 三 个 框架 真正 运用 到 实际 开发 中 去 ,该 案例 采用 目前 最 流行 、 最 规范 的 Java EE 架构 ， 
整个 应 用 分 为 领域 对 象 层 、DAO 层 、 业 务 逻 辑 层 、MVC 层 和 视图 层 ， 各 层 之 间 分 层 清晰 ， 层 与 层 之 间 以 松 耦 合 的 方 
法 组 织 在 一 起 。 该 案例 既 提 供 了 IDE 无 关 的 、 基 于 Ant 管理 的 项 目 源码 ， 也 提供 了 基于 Eclipse IDE 的 项 目 源码 ， 最 大 
限度 地 满足 读者 的 需求 。 

本 书 不 再 介绍 Struts 1.X 相关 内 容 ， 如 果 读 者 希望 获取 《 轻 量 级 J2EE 企业 应 用 实战 》 第 一 版 中 关于 Struts 1.X 的 知 
识 ， 请 登录 http://www.crazyit.org 下 载 。 当 读者 阅读 此 书 时 如 果 遇 到 技术 难题 ， 也 可 登录 http://www.crazyit.org 发 帖 ， 
笔者 将 会 及 时 予以 解答 。 

阅读 本 书 之 前 ， 建 议 先 认真 阅读 笔者 所 著 的 《疯狂 Java 讲义 》 一 书 。 本 书 适合 于 有 较 好 的 Java 编程 基础 ， 或 有 初 
步 JSP、Servlet 基础 的 读者 。 尤 其 适合 于 对 Struts 2、Spring、Hibemate 了 解 不 够 深入 ， 或 对 Struts 2+Spring+Hibernate 
整合 开发 不 太 熟 悉 的 开发 人 员 阅 读 。 


未 经 许可 ， 不 得 以 任何 方式 复制 或 抄袭 本 书 之 部 分 或 全 部 内 容 。 
版 权 所 有 ， 侵 权 必 究 。 
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Sj 销量 说 明 一 切 


《 轻 量 级 Java EE 企业 应 用 实战 》( 第 2 版 ) 销售 情况 : 
2008 年 11 月 第 1 次 印刷 ，4000 册 ; 
2009 年 3 月 ”第 2 次 印刷 ，2000 册 ; 
2009 年 6 月 ”第 3 次 印刷 ，2000 册 ; 
2009 年 9 月 第 4 次 印刷 ，2000 册 ; 
2009 年 11 月 第 5 次 印刷 ，2000 册 ， 
2010 年 5 月 ”第 6 次 印刷 ，2000 册 ; 
2010 年 8 月 第 7 次 印刷 ，3000 册 ; 
2010 年 12 月 第 8 次 印刷 ，2000 册 ; 


截至 2011 年 2 月 , 《 轻 量 级 Java EE 企业 应 用 实战 》( 第 2 版 ) 销量 接近 20000 册 ， 获 得 了 各 
培训 机 构 及 读者 的 广泛 好 评 。 
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> 前 


经 过 多 年 沉淀 ，Java EE 平台 已 经 成 为 电信 、 人 金融、 电子 商务 、 保 险 、 证 券 等 各 行业 的 大 型 应 
用 系统 的 首选 开发 平台 。 目 前 Java 行业 的 软件 开发 已 经 基本 稳定 ， 这 两 三 年 内 基本 没有 出 现 什 么 
具有 广泛 影响 力 的 新 技术 。Java EE 开发 大 致 可 分 为 两 种 方式 ， 以 Spring 为 核心 轻 量 级 Java EE 企 
业 开 发 平台 ; 以 EJB 3+JPA 为 核心 的 经 典 Java EE 开发 平台 。 无 论 使 用 哪 种 平台 进行 开发 ， 应 用 的 
性 能 、 稳 定性 都 有 很 好 的 保证 ， 开 发 人 群 也 有 很 稳定 的 保证 。 

本 书 介绍 的 开发 平台 , 就 是 以 Struts 2.2+Spring 3.0+Hibernate 3.6 (实际 项 目 中 可 能 以 JPA 来 代 
替 Hibernate) 为 核心 的 轻 量 级 Java EE， 这 种 组 合 在 保留 经 典 Java EE 应 用 架构 、 高 度 可 扩展 性 、 
高 度 可 维护 性 的 基础 上 ， 降 低 了 Java EE 应 用 的 开发 、 部 署 成 本 ， 对 于 大 部 分 中 小 型 企业 应 用 是 首 
选 。 在 一 些 需 要 具有 高 度 伸缩 性 、 高 度 稳定 性 的 企业 应 用 (比如 银行 系统 、 保 险 系 统 ) 里 ， 以 EJB 
3+JPA 为 核心 的 经 典 Java EE 应 用 则 具有 广泛 的 占有 率 。 本 书 的 姊妹 篇 《经 典 Java EE 企业 应 用 实 
战 》 主 要 介绍 了 后 一 种 Java EE 开发 平台 。 

本 书 主要 升级 了 《 轻 量 级 Java EE 企业 应 用 实战 》 的 知识 ， 采 用 最 新 的 Tomcat 7 作为 Web 服 
务 器 ,全 面 而 细致 地 介绍 了 Servlet 3.0 的 新 特性 ,并 将 Struts 升级 到 Struts 2.2.1, Spring 升级 到 3.0.5， 
Hibernate 升级 到 3.6.0。 书 中 详细 介绍 了 Spring 和 Hibernate 的 “ 零 配 置 "特性 , 并 充分 介绍 了 Struts 
2 的 Convention (约定) 支持 。 本 书 不 仅 介绍 了 Spring 2.x 的 AOP 支持 ， 详 细 介 绍 了 Spring 2.x 中 
Schema 配置 所 支持 的 util、aop、tx 等 命名 空间 ， 还 简要 讲解 了 Aspect 的 相关 内 容 。 本 书 也 重点 
介绍 了 Spring 3.0 的 新 功能 :SpEL，SpEL 不 仅 可 以 作为 表达 式 语 言 单独 使 用 ， 也 可 与 Spring 容器 


结合 来 扩展 Spring 容器 的 功能 。 


笔者 首先 要 感谢 广大 读者 对 本 书 第 2 版 的 认同 ， 在 将 近 2 年 的 时 间 内 ， 本 书 第 2 版 的 销量 高 
达 178 万 码 洋 ， 得 到 无 数 Java 学 习 者 的 认同 ， 成 为 Java EE 开发 者 首选 的 经 典 图 书 。 考 虑 到 目前 
技术 的 升级 ， 笔 者 现 将 本 书 的 全 部 技术 升级 到 最 新 版 、 最 前 沿 ， 以 维 读者 。 

还 有 一 个 值得 介绍 的 消息 : 本 书 姊妹 篇 《经 典 Java EE 企业 应 用 实战 》( 由 电子 工业 出 版 社 出 
版 ，ISBN 978-7-121-11534-9) 现 已 上 市 。 学 习 本 书 时 可 以 采用 “ 轻 经 合 参 ”的 方式 来 学 习 :“ 轻 ” 
指 的 是 以 “SSH” 整 合 的 轻 量 级 Java EE 开发 平台 ,“ 经 ” 指 的 是 以 “EJB 3+JPA” 整 合 的 经 典 Java 
EE 开发 平台 ; 这 两 种 平台 本 身 具 有 很 大 的 相似 性 ， 将 两 种 Java EE 开发 平台 结构 放 在 一 起 参考 、 
对 照 着 学 习 ， 能 更 好 地 理解 Spring、Hibemate 框架 的 设计 思想 ， 从 而 更 深入 地 掌握 它们 。 与 此 同 
时 ， 也 可 以 深入 理解 EJB 3 与 Spring 容器 中 的 Bean、EJB 容器 与 Spring 容器 之 间 的 联系 和 区 别 ， 
从 而 融会 贯通 地 掌握 EJB 3+JPA 整合 的 开发 方式 。 

经 常 有 读者 写 邮件 来 问 笔者 ， 为 何 你 能 快 而 且 全 面 地 掌握 各 种 Java 开发 技术 ? 笔者 以 前 做 过 
一 些 零 散 的 回复 。 这 里 简单 地 介绍 笔者 学 习 Java 的 一 些 历史 与 方法 ， 希 望 广大 读者 从 中 借鉴 值得 
学 习 的 地 方 ， 避 开 一 些 弯路 。 

笔者 大 约 是 1999 年 开始 接触 Java， 开 始 主要 做 点 Applet 玩 〈 当 时 笔者 对 Applet 做 出 来 的 动 
画 十 分 倾心 )。 后 来 开始 流行 ASP、JSP， 笔 者 再 次 喜欢 上 ASP、JSP 那 种 极其 简单 的 语法 、 短 期 
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内 的 快速 上 手 ， 后 来 断断续续 用 ASP、JSP 写 了 多 个 小 型 企业 网 站 、BBS、OA 系统 之 类 一 一 不 知 
道 其 他 人 是 什么 经 历 ， 笔 者 选择 编程 一 方面 是 因为 个 人 爱好 和 “自豪 感 ”( 觉 得 能 做 出 各 种 软件 ， 
有 点 成 就 感 )， 另 一 方面 是 因为 编写 软件 可 以 轻易 地 卖点 钱 〈 是 不 是 很 俗 ? )， 但 这 个 目的 笔者 无 
法 回避 一 一 由 于 出 生 在 湖北 一 个 贫穷 的 乡下 ， 所 以 在 同济 念书 时 笔者 常常 为 了 开饭 而 写 代码 ， 或 
许 有 一 些 程序 员 和 笔者 会 有 相同 的 感触 。 

在 后 来 的 开发 过 程 中 ， 笔 者 发 现 纯粹 的 JSP 开发 虽然 前 期 很 方便 ， 但 由 于 开发 时 代码 重复 得 
厉害 ， 所 以 后 期 升级 、 维 护 很 痛苦 ， 于 是 开始 大 规模 地 修改 自己 写 的 一 堆 “ 垃 圾 ”代码 ， 不 断 地 
思考 怎样 对 JSP 脚本 进行 提取 、 封装 到 Java Bean 中 , 这 个 过 程 并 不 顺利 , 经 常 遭 遇 各 种 性 能 问题 、 
并 发 问题 。 原 本 可 以 运行 良好 的 应 用 ， 反 而 被 改 得 经 常 出 现 问 题 。 

大 约 到 了 2000 年 ， 笔 者 接触 到 EJB， 对 EJB 许 下 的 “承诺 ”无 比 欣 姜 ， 于 是 义无反顾 地 投入 
EJB 的 怀抱 ， 不 过 EJB 的 学 习 并 不 顺利 ， 当 时 用 的 好 像 是 WebLogic 5 的 服务 器 ， 那 时 候 觉 得 
WebLogic 5 所 报 的 错误 上 涩 、 难 以 阅读 ， 动 频 几 屏 的 错误 信息 ， 让 人 感觉 很 有 压力 。 

不 过 笔者 是 一 个 顽固 的 人 ， 过 到 错误 总 是 不 断 地 修改 、 不 断 地 尝试 ， 在 这 样 的 尝试 中 ， 不 知 
不 觉 中 ， 天 色 已 经 发 白 。 说 来 居 愧 ， 第 一 个 Hello World 级 的 Entity EJB 居然 花 了 将 近 一 个 月 的 时 
间 才 弄 完 ( 绝 不 建议 读者 从 EJB 1.1 或 EJB 2 开始 学 习 , 这 只 会 给 学 习 徒 增 难 度 , 而 且 现 在 EJB 1.1、 
EJB 2 都 已 被 淘汰 )。 在 那 段 时 间 内 ， 笔 者 连 最 心爱 的 C 几乎 完全 没 碰 过 。 

在 接 下 来 的 2 年 多 时 间 内 ， 笔 者 一 直 沉浸 在 EJB 中 ， 不 断 地 搜寻 各 种 关于 EJB 的 资料 、 不 断 
地 深入 钻研 着 关于 EJB 规范 、EJB 的 运行 、EJB 容器 的 运行 机 制 。 随 着 时 间 的 流逝 ，EJB、EJB 容 
器 的 运行 原理 逐渐 明朗 起 来 。 

那 是 一 段 让 人 怀念 的 “神话 ” 般 的 岁月 ， 年 轻 的 人 ， 似 乎 拥有 无 穷 的 精力 ， 那 也 是 笔者 Java 
技术 增长 最 迅速 的 3 年 ， 笔 者 的 Java EE 功底 也 是 在 那 3 年 内 打下 的 ， 后 来 接触 的 各 种 “新 ”技术 
只 是 在 那个 基础 上 “ 修 修 补 补 ”， 或者“ 温 故而 知 新 ”。 

2004 年 初 ， 笔 者 开始 接触 到 Spring 框架 ， 从 接触 Spring 的 第 一 天 开始 ， 直 到 今天 ， 笔 者 一 直 
觉得 Spring 和 EJB 之 间 有 很 大 的 相似 性 : 

加 Spring 本 身 也 是 一 个 容器 ， 只 是 EJB 容器 管理 的 是 EJB，Spring 容器 管理 的 是 普通 Java 

对 象 。 


昌 Spring 对 Bean 类 的 要 求 很 少 , EJB 容器 对 EJB 的 要 求 咯 多 一 些 一 所 以 初学 者 学 习 EJB 
上 和 手 较 难 ， 但 学 习 Spring 就 简单 得 多 。 

因为 找到 这 种 类 比 性 ， 笔 者 学 习 Spring 时 ， 总 是 不 断 地 将 EJB 与 Spring 进行 类 比 ， 然 后 再 找 
出 它们 之 间 的 不 同 之 处 。 由 于 采用 了 这 种 “ 温 故 而 知 新 ”的 学 习 方式 ， 所 以 笔者 很 容易 就 理解 了 
Spring 的 设计 ， 而 且 更 加 透彻 。 

很 多 Java 学 习 者 在 学 习 过 程 中 往往 容易 感觉 Java 开发 内 容 纷繁 芜 杂 ， 造 成 这 种 感觉 的 原因 就 
是 因为 没有 进行 很 好 的 归纳 、 总 结 、 类 比 。 为 了 避免 “知识 越 学 越 多 ”的 混乱 感 ， 读 者 应 该 充分 
利用 已 掌握 的 知识 , 温 故而 知 新 一 一 一 方面 对 已 有 的 知识 进行 归纳 、 总 结 ， 另 一 方面 将 新 的 内 容 与 
已 掌握 的 知识 进行 类 比 ， 这 样 既 能 把 已 有 的 知识 掌握 得 更 有 条 理 、 更 系统 ， 也 能 更 快 、 更 透彻 地 
掌握 新 的 知识 。 

出 于 以 上 理由 ， 笔 者 在 介绍 非常 专业 的 编程 知识 之 时 ， 总 会 通过 一 些 浅显 的 类 比 来 帮助 读者 
更 好 地 理解 “简单 、 易 读 ” 成 为 笔者 一 贯 坚持 的 创作 风格 ， 也 是 疯狂 Java 体系 丛书 的 特色 。 另 一 
方面 , 疯狂 Java 体系 图 书 的 知识 也 很 全 面 、 实 用. 笔者 希望 读者 在 看 完 疯狂 Java 体系 的 图 书 之 后 ， 
可 以 较为 轻松 地 理解 书 中 所 介绍 的 知识 ， 并 切实 学 会 一 种 实用 的 开发 技术 ， 进 而 将 之 应 用 到 实际 
开发 中 。 如 果 读 者 在 学 习 过 程 中 遇 到 无 法 理解 的 问题 , 可 以 登录 疯狂 Java 联盟 (http://www.crazyit. 

se 
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org) 与 广大 Java 学 习 者 交流 ， 笔 者 也 会 通过 该 平台 与 大 家 一 起 交流 、 学 习 。 


本 书 保持 了 《 轻 量 级 Java EE 企业 应 用 实战 ) 第 2 版 简单 、 实 用 的 优势 , 同样 坚持 让 案例 说 话 、 
以 案例 来 介绍 知识 点 的 风格 ， 在 书 的 最 后 同样 示范 开发 了 企业 工作 流 案例 ， 希 望 读者 通过 该 案例 
真正 步 入 实际 企业 开发 的 殿堂 。 

本 书 依然 保留 了 《 轻 量 级 J2EE 企业 应 用 实战 》 第 2 版 的 三 个 特色 。 

1. 经 验 丰 富 ， 针 对 性 强 

笔者 既 担 任 过 软件 开发 的 技术 经 理 ， 也 担任 过 软件 公司 的 培训 导师 ， 还 从 事 过 职业 培训 的 
专职 讲师 ， 这 些 经 验 影 响 了 笔者 写 书 的 目的 ， 不 是 一 本 学 院 派 的 理论 读物 ， 而 是 一 本 实际 的 开 
发 指南 。 

2. 内 容 实际 ， 实 用 性 强 

本 书 所 介绍 的 Java EE 应 用 范例 ， 采 用 了 目前 企业 流行 的 开发 架构 ， 绝 对 严格 遵守 Java EE 开 
发 规范 ， 而 不 是 将 各 种 技术 杂乱 地 炎 合 在 一 起 号 称 Java EE。 读 者 参考 本 书 的 架构 ， 完 全 可 以 身 临 
其 境地 感受 企业 实际 开发 。 

3， 高 屋 建筑 ， 启 发 性 强 

本 书 介绍 的 几 种 架构 模式 ， 几乎 是 时 下 最 全 面 的 Java EE 架构 模式 。 这 些 架构 模式 可 以 直接 提 
升 读者 对 系统 架构 设计 的 把 握 。 


CE 4 


如 果 你 已 经 掌握 了 Java SE 内 容 ， 或 已 经 学 完了 《疯狂 Java 讲义 》 一 书 ， 那 么 你 非常 适合 阅 
读 此 书 。 除 此 之 外 , 如 果 你 已 有 初步 的 JSP、Servlet 基础 ,甚至 对 Struts 2、Spring 3.0、Hibernate 3.6 
有 所 了 解 ， 但 希望 掌握 它们 在 实际 开发 中 的 应 用 ， 本 书 也 将 非常 适合 你 。 如 果 你 对 Java 的 掌握 还 


不 熟练 ， 则 建议 遵从 学 习 规律 ， 循 序 渐进 ， 暂 时 不 要 购买 、 阅 读 此 书 。 


Ve 
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> 光盘 说 明 


一 、 光 盘 内 容 


本 光盘 是 《 轻 量 级 Java EE 企业 应 用 开发 实战 》 一 书 的 配 书 光盘 , 书 中 的 代码 按 章 、 按 节 存 放 ， 
即 第 2 章 、 第 2 节 所 使 用 的 代码 放 在 codes 文件 夹 的 02\2.2 文件 夹 下 ， 依 此 类 推 。 

另 ; 书 中 每 份 源 代码 也 给 出 与 光盘 源 文件 的 对 应 关系 ， 方 便 读者 查找 。 

本 光盘 codes 目录 下 有 10 个 文件 夹 ,其 内 容 和 含义 说 明 如 下 : 

(1) 01 一 10 个 文件 夹 名 对 应 于 《 轻 量 级 Java EE 企业 应 用 开发 实战 》 中 的 章 名 ， 即 第 二 章 所 
使 用 的 代码 放 在 codes 文件 夹 的 02 文件 夹 下 ， 依 此 类 推 。 

(2)10 文 件 夹 下 有 HRSystem 和 HRSystem_Eclipse 两 个 文件 夹 , 它们 是 同一 个 项 目的 源 文件 ， 
其 中 HRSystem 是 IDE 平台 无 关 的 项 目 ， 使 用 Ant 来 编译 即 可 ， 而 HRSystem_Eclipse 是 该 项 目 在 
Eclipse IDE 工具 中 的 项 目 文件 。 

(3) codes\03W3.2\Struts2Demo 目录 、codes\05\5.2\HibernateDemo 目录 、codes\07\7.2\myspring 
目录 和 codes\10\HRSystem_Eclipse 目录 下 有 .classpath、.project 等 文件 ， 它 们 是 Eclipse 项 目 文件 ， 
请 不 要 删除 。 

二 、 运 行 环境 

本 书 中 的 程序 在 以 下 环境 调试 通过 : 

(1) 安装 jdk-6u22-windows-i586-p.exe， 安 装 完成 后 ， 添 加 CLASSPATH 环境 变量 ， 该 环境 
变量 的 值 为 ;%JAVA_HOME%/lib/toolsjar;%JAVA_HOME%Y/lib/dt.jar。 如 果 为 了 可 以 编译 和 运行 Java 
程序 ， 还 应 该 在 PATH 环境 变量 中 增加 %JAVA_HOME%/bin。 其 中 JAVA_HOME 代表 JDK (不 是 
JRE) 的 安装 路 径 。 

(2) 安装 Apache 的 Tomcat7.0.6， 不 要 使 用 安装 文件 安装 ， 而 是 采用 解压 缩 的 安装 方式 。 安 
装 Tomcat 请 参看 第 一 章 。 安 装 完成 后 ， 将 Tomcat 安装 路 径 的 lib 下 的 jsp-apijar 和 servlet-apijar 
两 个 JAR 文件 添加 到 CLASSPATH 环境 变量 之 后 。 

(3) 安装 apache-ant-1.8.1。 

将 下 载 的 Ant 压缩 文件 解压 缩 到 任意 路 径 ， 然 后 增加 ANT_HOME 的 环境 变量 ， 让 变量 的 值 
为 Ant 的 解压 缩 路 径 。 并 在 PATH 环境 变量 中 增加 %ANT_HOME%/bin 环境 变量 。 
(4) 安装 MySQL5.1 或 更 高 版 本 ， 安 装 MysSQL 时 候选 择 GBK 的 编码 方式 。 
(5) 安装 Eclipse-jee-helios 版 (也 就 是 Eclipse 3.6 for Java EE Developers)。 
关于 如 何 安装 上 面 工具 ， 请 参考 本 书 的 第 1 章 。 
三 、 注 意 事项 
(1) 独立 应 用 程序 的 代码 中 都 包括 build.xml 文件 , 在 Dos 或 Shell 下 进入 build.xml 文件 所 在 


路 径 ， 执 行 如 下 命令 : 


ant compile -- 编译 程序 
ant run -- 运 行程 序 


(2) 对 于 Web 应 用 ,将 该 应 用 复制 到 %TOMCAT_HOME%/webapps 路 径 下 ,然后 进入 build.xml 
所 在 路 径 ， 执 行 如 下 命令 : 
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ant compile -- 编译 应 用 
启动 Tomcat 服务 器 ， 使 用 浏览 器 即 可 访问 该 应 用 。 

(3) 对 于 Eclipse 项 目 文件 ， 导 入 Eclipse 开发 工具 即 可 。 

(4) 第 10 章 的 案例 ， 请 参看 项 目下 的 readme.txt。 

(5) 代码 中 有 大 量 代码 需要 连接 数据 库 ， 读 者 应 修改 数据 库 URL 以 及 用 户 名 、 密 码 让 这 些 
代码 与 读者 运行 环境 一 致 。 如 果 项 目下 有 SQL 脚本 ， 导 入 SQL 脚本 即 可 ， 如 果 没 有 SQL 脚本 ， 
系统 将 在 运行 时 自动 建 表 ， 读 者 只 需 创建 对 应 数据 库 即 可 。 

(6) 在 使 用 本 光盘 的 程序 时 ， 请 将 程序 复制 到 硬盘 上 ， 并 去 除 文件 的 只 读 属性 。 

四 、 技 术 支持 


如 果 您 使 用 本 光盘 中 遇 到 不 懂 的 技术 问题 ， 您 可 以 登录 如 下 网 站 与 作者 联系 ; 
网 站 : http://www.crazyit.org 


=Vllle 


第 1 章 Java EE 应 用 和 开发 环境 
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时 至 今日 ， 轻 量 级 Java EE 平台 在 企业 开发 中 占有 绝对 的 优势 ，Java EE 应 用 以 其 稳定 的 性 能 、 良 
好 的 开放 性 及 严格 的 安全 性 ， 深 受 企业 应 用 开发 者 的 青睐 。 实 际 上 ， 对 于 信息 化 要 求 较 高 的 行业 ， 如 
银行 、 电 信 、 证 券 及 电子 商务 等 行业 ， 都 不 约 而 同 地 选择 了 Java EE 开发 平台 。 

对 于 一 个 企业 而 言 ， 选 择 Java EE 构建 信息 化 平台 ， 更 体现 了 一 种 长 远 的 规划 : 企业 的 信息 化 是 
不 断 整 合 的 过 程 ， 在 未 来 的 日 子 里 ， 经 常会 有 不 同 平台 、 不 同系 统 的 异 构 系 统 需要 整合 。Java EE 应 用 
提供 的 跨 平台 性 、 开 放 性 及 各 种 远程 访问 的 技术 ， 为 异 构 系统 的 良好 整合 提供 了 保证 。 

2006 年 ，Sun 提出 了 Java EE 的 概念 ， 与 之 同步 出 现 了 两 个 主要 规范 : JSF 1.2 和 EJB 3.0， 但 应 用 
依然 不 如 SSH (Stmuts+Spring+Hibernate) 组 合 的 应 用 广泛 。SSH 组 合 是 一 种 轻 量 级 的 Java EE 平台 ， 
具有 高 度 的 实用 性 和 可 扩展 性 基于 轻 量 级 Java EE 平台 的 应 用 可 以 运行 在 普通 Web 容器 中 , 无须 EJB 
容器 的 支持 ， 且 一 样 具 有 稳定 的 性 能 和 极 高 的 可 扩展 性 、 可 维护 性 。 

本 书 作为 《 轻 量 级 Java EE 企业 应 用 实战 》 的 第 3 版 , 将 全 面 升 级 SSH 组 合 里 三 个 开源 框架 的 版 本 ; 
Struts 将 全 面 升级 到 2.2，Spring 将 升级 到 3.0，Hibernate 将 升级 到 3.6， 尽 量 让 读者 走 在 技术 的 最 前 沿 。 


1.1 Java EE 应 用 概述 


今天 我 们 所 说 的 Java EE 应 用 ， 往 往 超出 了 Sun 所 提出 的 经 典 Java EE 应 用 规范 ， 而 是 一 种 更 广 
泛 的 开发 规范 。 经 典 Java EE 应 用 往往 以 EJB (企业 级 Java Bean) 为 核心 ， 以 应 用 服务 器 为 运行 环境 ， 
所 以 通常 开发 、 运 行 成 本 较 高 。 本 书 所 介绍 的 轻 量 级 Java EE 应 用 具备 了 Java EE 规范 的 种 种 特征 ， 例 
如 面向 对 象 建 模 的 思维 方式 、 优 秀 的 应 用 分 层 及 良好 的 可 扩展 性 、 可 维护 性 。 轻 量 级 Java EE 应 用 保 
留 了 经 典 Java 应 用 的 架构 ， 但 开发 、 运 行 成 本 更 低 。 


>>1.1.1 JavaEE 应 用 的 分 层 模 型 


不 管 是 经 典 的 Java EE 架构 ， 还 是 本 书 所 介绍 的 轻 量 级 Java EE 架构 ， 大 致 上 都 可 分 为 如 下 几 层 。 

> ”Domain Object (领域 对 象 ) 层 ， 此 层 由 系列 的 POJO (Plain Old Java Object， 普 通 的 、 传 
统 的 Java 对 象 ) 组 成 , 这 些 对 象 是 该 系统 的 Domain Object, 往往 包含 了 各 自 所 需要 实现 的 
业务 逻辑 方法 。 

> DAO (Data Access Object， 数 据 访 问 对 象 ) 层 : 此 层 由 系列 的 DAO 组 件 组 成 ， 这 些 DAO 
实现 了 对 数据 库 的 创建 、 查 询 、 更 新 和 删除 (CRUD) 等 原子 操作 。 

i Java EE 应 用 中 ，DAO 层 也 被 改称 为 EAO 层 ，EAO 层 组 件 的 作用 与 DAO 层 

组 件 的 作用 基本 相似 。 只 是 EAO 层 主要 完成 对 实体 (Entity ) 的 CRUD 操作 ， 因 此 简称 为 

| EAO 层 . J 

> ”业务 逻辑 层 :此 层 由 系列 的 业务 逻辑 对 象 组 成 ， 这 些 业务 逻辑 对 象 实现 了 系统 所 需要 的 业务 
逻辑 方法 .这 些 业务 逻辑 方法 可 能 仅仅 用 于 暴露 Domain Object 对 象 所 实现 的 业务 逻辑 方法 ， 
也 可 能 是 依赖 DAO 组 件 实现 的 业务 逻辑 方法 。 

> ”控制 器 层 ， 此 层 由 系列 控制 器 组 成 ， 这 些 控制 器 用 于 拦截 用 户 请 求 ， 并 调用 业务 逻辑 组 件 的 
业务 逻辑 方法 ， 处 理 用户 请 求 ， 并 根据 处 理 结果 转发 到 不 同 的 表现 层 组 件 。 

> ”表现 层 :此 层 由 系列 的 JSP 页 面 、Velocity 页 面 、PDF 文档 视图 组 件 组 成 ， 负 责 收集 用 户 请 
求 ， 并 将 显示 处 理 结果 。 

大 致 上 ，Java EE 应 用 的 架构 如 图 1.1 所 示 。 

各 层 的 Java EE 组 件 之 间 以 松 耦合 的 方式 耦合 在 一 起 ， 各 组 件 并 不 以 硬 编码 方式 耦合 ， 这 种 方 
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式 是 为 了 应 用 以 后 的 扩展 性 。 从 上 向 下 ， 上 面 组 件 的 实现 依赖 于 下 面 组 件 的 功能 ; 从 下 向 上 ， 下 面 
组 件 支持 上 面 组 件 的 实现 。 

至 于 以 EJB 3、JPA 为 核心 的 Java EE 应 用 的 结构 ， 和 图 1.1 所 示 的 应 用 结构 大 致 相似 ， 只 是 它 的 
DAO 层 一般 称 为 EAO 层 ) 组 件 、 业 务 逻辑 层 组 件 都 由 EJB 充当 。 关 于 经 典 Java EE 应 用 的 详细 介 
绍 请 参看 本 书 姊妹 篇 《经 典 Java EE 企业 应 用 实战 》。 


“i 
EE 


EL 


wa 
2 
图 1.1 Java EE 应 用 的 架构 


>>1.1.2 Java EE 应 用 的 组 件 


通过 上 一 节 的 讲解 ,我们 可 以 看 到 Java EE 应 用 提供 了 系统 架构 上 的 飞跃 ，Java EE 架构 提供 了 良 
好 的 分 离 ， 隔 离 了 各 组 件 之 间 的 代码 依赖 。 

总 体 而 言 ，Java EE 应 用 大 致 包括 如 下 几 类 组 件 。 

> ”表现 层 组 件 ， 主 要 负责 收集 用 户 输入 数据 ， 或 者 向 客户 显示 系统 状态 。 最 常用 的 表现 层 技术 
是 JSP, 但 JSP 并 不 是 唯一 的 表现 层 技术 。 表 现 层 还 可 由 Velocity、FreeMarker 和 Tapestry 
等 技术 完成 ， 或 者 使 用 普通 的 应 用 程序 充当 表现 层 组 件 ， 甚 至 可 以 是 小 型 智能 设备 。 

> ”控制 器 组 件 ， 对 于 Java EE 的 MVC 框架 而 言 ， 框 架 提供 一 个 前 端 核 心 控制 器 ， 而 核心 控制 
器 负责 拦截 用 户 请 求 ， 并 将 请 求 转 发 给 用 户 实现 的 控制 器 组 件 。 而 这 些 用 户 实现 的 控制 器 则 
负责 处 理 调用 业务 逻辑 方法 ， 处 理 用 户 请 求 。 

> ”业务 逻辑 组 件 ， 是 系统 的 核心 组 件 ， 实 现 系统 的 业务 逻辑 。 通 常 ， 一 个 业务 逻辑 方法 对 应 一 
次 用 户 操作 。 一 个 业务 逻辑 方法 应 该 是 一 个 整体 的 ， 因 此 我 们 要 求 对 业务 逻辑 方法 增加 事务 
性 。 业 务 逻 辑 方法 仅仅 负责 实现 业务 逻辑 ， 不 应 该 进行 数据 库 访 问 。 因 此 ， 业 务 逻 辑 组 件 中 
不 应 该 出 现 原始 的 Hibernate、JDBC 等 API。 


保证 业务 带 图 组件 之 中 不 出 现 Hibemate 和 JDBC 等 API， 有 一 个 更 重要 的 原因 ， 保 
证 业务 运 辑 方法 的 实现 ， 与 具体 的 持久 层 访问 技术 分 离 。 当 系统 需要 在 不 同 持久 层 技术 
之 间 切 换 时 ， 系 统 的 业务 去 辑 组 件 无 须 任何 改变 。 笔 者 有 时 见 到 一 些 所 谓 的 Java EE 应 


用 ， 在 JSP 页 面 里 调用 Hibernate 的 Configuration 接口 ， 这 无 疑 是 非常 荒唐 的 ， 这 种 应 
用 仅仅 是 使 用 Hibernate， 完 全 没有 脱离 Model 1 的 JSP 开发 模式 一 这 是 相当 失败 的 结 
构 . 实际 上 ， 不 仅 JSP，Servlet 中 也 不 要 出 现 持久 层 API， 包 括 JDBC、Hibemnate、Entity 
EJB API. 最 理想 的 情况 是 业务 远 辑 组 件 中 都 不 要 出 现 持久 层 API. 
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> ”DAO 组 件 : Data Access Object， 也 被 称 为 数据 访问 对 象 。 这 个 类 型 的 对 象 比较 缺乏 变化 ， 
每 个 DAO 组 件 都 提供 Domain Object 对 象 基本 的 创建 、 查 询 、 更 新 和 删除 等 操作 ， 这 些 操 
作对 应 于 数据 表 的 CRUD 〈 创 建 、 查 询 、 更 新 和 删除 ) 等 原子 操作 。 当 然 ， 如 果 采 用 不 同 的 
持久 层 访问 技术 ，DAO 组 件 的 实现 会 完全 不 同 。 为 了 业务 逻辑 组 件 的 实现 与 DAO 组 件 的 实 
现 分 离 ， 我 们 为 每 个 DAO 组 件 都 提供 接口 ， 业 务 逻 辑 组 件 面向 DAO 接口 编程 ， 从 而 提供 更 
好 的 解 耦 。 

> 领域 对 象 组 件 : 领域 对 象 《Domain Object) 抽象 了 系统 的 对 象 模型 。 通 常 而 言 ， 这 些 领域 
对 象 的 状态 都 必须 保存 在 数据 库 里 。 因 此 ， 每 个 领域 对 象 通常 对 应 一 个 或 多 个 数据 表 ， 领 域 
对 象 通常 需 要 提供 对 数据 记录 访问 方式 。 


1.1.3 Java EE 应 用 的 结构 和 优势 


对 于 Java EE 的 初学 者 而 言 ， 常 常 有 一 个 问题 : 我 可 以 使 用 JSP 完成 这 个 系统 ， 为 什么 我 还 要 使 
用 Hibernate 等 技术 ? 难道 仅仅 是 为 了 听 起 来 高 深 一 点 ? 我 完全 可 以 使 用 纯粹 的 JSP 完成 整个 系统 , 为 
什么 还 要 将 系统 分 层 ? 

要 回答 这 些 问题 ， 我 们 不 能 仅仅 考虑 系统 开发 过 程 ， 还 需要 考虑 系统 后 期 的 维护 、 扩 展 ; 我 们 不 
能 仅 考虑 那些 小 型 系统 ， 还 要 考虑 大 型 系统 的 协同 开发 。 对 于 个 人 学 习 、 娱 乐 性 的 个 人 站 点 ， 的 确 没 
有 必要 使 用 复杂 的 Java EE 应 用 架构 ， 采 用 纯粹 的 JSP 就 可 以 实现 整个 系统 。 

对 于 大 型 的 信息 化 系统 而 言 ， 采 用 Java EE 应 用 架构 则 有 很 大 的 优势 。 

软件 不 是 一 次 性 系统 ， 不 仅 与 传统 行业 的 产品 有 较 大 的 差异 ， 甚 至 与 硬件 产品 也 有 较 大 的 差异 。 
硬件 产品 可 以 随时 间 的 流逝 而 宣布 过 时 ， 更 换 新 一 代 硬件 产品 。 但 是 软件 不 能 彻底 替换 ， 只 能 在 其 原 
来 基础 上 延伸 ， 因 为 软件 往往 是 信息 的 延续 ， 是 企业 命脉 的 延伸 。 如 果 支 撑 企 业 系 统 的 软件 不 具备 可 
扩展 性 ， 当 企业 平台 发 生 改变 时 ， 我 们 如 何 面 对 这 种 改变 ? 如 果 我 们 新 开发 的 系统 不 能 与 老 系统 有 机 
地 融合 在 一 起 ， 那 么 老 系统 的 信息 如 何 重 新 利用 ? 这 种 损失 将 无 法 用 金钱 来 衡量 。 

对 于 信息 化 系统 ， 前 期 开发 工作 对 整个 系统 工作 量 而 言 ， 仅 仅 是 小 部 分 ， 而 后 期 的 维护 、 升 级 往 
往 占 更 大 的 比重 。 更 极端 的 情况 是 ， 可 能 在 前 期 开发 期 间 ， 企 业 需 求 已 经 发 生 改变 …… 这 种 改变 是 客 
观 的 ， 而 软件 系统 必须 适应 这 种 改变 ， 这 要 求 软件 系统 具有 很 好 的 伸缩 性 。 

最 理想 的 软件 系统 应 该 如 同 计算 机 的 硬件 系统 ， 各 种 设备 可 以 支持 热 插 拔 ， 各 设备 之 间 的 影响 非 
常 小 ， 设 备 与 设备 之 间 的 实现 完全 透明 ， 只 要 有 通用 的 接口 ， 设 备 之 间 就 可 以 良好 协作 。 虽 然 ， 目 前 
软件 系统 还 达 不 到 这 种 理想 状态 ， 但 这 应 该 是 软件 系统 努力 的 方向 。 

上 面 介绍 的 这 种 框架 ， 致 力 于 让 应 用 的 各 组 件 以 松 耦 合 的 方式 组 织 在 一 起 ， 让 应 用 之 间 的 耦合 停 
留 在 接口 层次 ， 而 不 是 代码 层次 。 


>》1.1.4 常用 的 JavaEE 服务 器 


本 书 将 介绍 一 种 优秀 的 轻 量 级 Java EE 架构 ，Struts 2+Spring+Hibernate。 采 用 这 种 架构 的 软件 系 
统 ， 无 须 专业 的 Java EE 服务 器 支持 ， 只 需要 简单 的 Web 服务 器 就 可 以 运行 。Java 领域 常见 的 Web 
服务 器 都 是 开源 的 ， 而 且 具 有 很 好 的 稳定 性 。 
常见 的 Web 服务 器 有 如 下 三 个 。 
> Tomcat: Tomcat 和 Java 结合 得 最 好 ， 是 Sun 官方 推荐 的 JSP 服务 器 。Tomcat 是 开源 的 
Web 服务 器 ， 经 过 长 时 间 的 发 展 ， 性 能 、 稳 定性 等 方面 都 非常 优秀 。 

> ”Jetty: 另 一 个 优秀 的 Web 服务 器 。Jetty 有 个 更 大 的 优点 就 是 ，Jetty 可 作为 一 个 嵌入 式 服务 
器 ， 即 : 如 果 在 应 用 中 加 入 Jetty 的 JAR 文件 ， 应 用 可 在 代码 中 对 外 提供 Web 服务 。 

> Resin: 目前 最 快 的 JSP、Servlet 运行 平台 ， 支 持 EJB。 个 人 学 习 该 服务 器 是 免费 的 ， 但 如 
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果 想 将 该 服务 器 作为 商业 使 用 ， 则 需要 交纳 相应 的 费用 。 
除了 上 面 的 Web 服务 器 外 ， 还 有 一 些 专业 Java EE 服务 器 ， 相 对 于 Web 服务 器 而 言 ，Java EE 服 
务 器 支持 更 多 的 Java EE 特性 ， 例 如 分 布 式 事务 、EJB 容器 等 。 常 用 的 Java EE 服务 器 有 如 下 儿 个 。 
> ”JBoss: 开源 的 Java EE 服务 器 ， 目 前 支持 EJB 3.0 技术 。 
> WebLogic 和 WebSphere: 这 两 个 是 专业 的 商用 Java EE 服务 器 , 价格 不 菲 。 但 在 性 能 等 各 
方面 也 是 相当 出 色 。 
对 于 轻 量 级 Java EE 而 言 , 没有 必要 使 用 Java EE 服务 器 ， 使 用 简单 的 Web 容器 已 经 完全 能 胜任 。 


1.2” 轻 量 级 Java EE 应 用 相关 技术 


轻 量 级 Java EE 应 用 以 传统 的 JSP 作为 表现 层 技术 ， 以 系列 开源 框架 作为 MVC 层 、 中 间 层 、 持 
久 层 解决 方案 ， 并 将 这 些 开源 框架 有 机 地 组 合 在 一 起 ， 使 得 Java EE 应 用 具有 高 度 的 可 扩展 性 、 可 维 
护 性 。 


>>1.2.1 JSP、Servlet3.0 和 JavaBean 及 替代 技术 


JSP 是 最 早 的 Java EE 规范 之 一 ， 也 是 最 经 典 的 Java EE 技术 之 一 ， 直 到 今天 ，JSP 依然 广泛 地 应 
用 于 各 种 Java EE 应 用 中 ， 充 当 Java EE 应 用 的 表现 层 角色 。 

JSP 具有 简单 、 易 用 的 特点 ，JSP 的 学 习 路 线 平 坦 ， 而 且 国 内 有 大 量 JSP 学 习 资料 ， 所 以 大 部 分 
Java 学 习 者 学 习 Java EE 开发 都 会 选择 从 JSP 开始 。 

Servlet 和 JSP 其 实 是 完全 统一 的 , 二 者 在 底层 的 运行 原理 是 完全 一 样 的 , 实际 上 , JSP 必须 被 Web 
服务 器 编译 成 Servlet， 真 正在 Web 服务 器 内 运行 的 是 Servlet。 从 这 个 意义 上 来 看 ， 我 们 可 以 把 JSP 
当成 一 个 “草稿 "文件 , Web 服务 器 根据 该 草稿 "文件 来 生成 Servlet, 真正 提供 HTTP 服务 的 是 Servlet， 
因此 广义 的 Servlet 包含 了 JSP 和 Servlet。 

就 目前 的 Java EE 应 用 来 看 ,纯粹 的 Servlet 已 经 很 少 使 用 了 ， 毕 竟 Servlet 的 开发 成 本 太 高 ， 而 且 
使 用 Servlet 充当 表现 层 将 导致 表现 层 页 面 难 以 维护 ， 不 利于 美工 人 员 参 与 Servlet 开发 ， 所 以 实际 开 
发 中 大 都 使 用 JSP 充当 表现 层 技术 。 

Servlet 3.0 规范 的 出 现 ， 再 次 为 Java Web 开发 带 来 了 巨大 的 便捷 ，Serviet 3.0 提供 了 异步 请 求 、 
Annotation 标注 、 增 强 的 Servlet API， 这 些 功 能 都 很 好 地 简化 了 Java Web 开发 。 

由 于 JSP 只 负责 简单 的 显示 逻辑 , 所 以 JSP 无 法 直接 访问 应 用 的 底层 状态 , Java EE 应 用 会 选择 使 
用 JavaBean 来 传输 数据 ， 在 严格 的 Java EE 应 用 中 ， 中 间 层 的 组 件 会 将 应 用 底层 的 状态 信息 封装 成 
JavaBean 集 ， 这 些 JavaBean 也 被 称 为 DTO 〈Data Transfer Object， 数 据 传 输 对 象 )， 并 将 这 些 DTO 集 
传 到 JSP 页 面 ， 从 而 让 JSP 可 以 显示 应 用 的 底层 状态 。 

在 目前 阶段 ，Java EE 应 用 除了 可 以 使 用 JSP 作为 表现 层 技术 之 外 ， 还 可 以 使 用 FreeMarker 或 
Velocity 充当 表现 层 技术 ， 这 些 表现 层 技术 更 加 纯粹 ， 使 用 更 加 简洁 ， 完 全 可 作为 JSP 的 替代 。 


>>1.2.2 Struts 2.2 及 替代 技术 


Struts 是 全 世界 最 早 的 MVC 框架 , 其 作者 是 JSP 规范 的 制定 者 , 并 参与 了 Tomcat 开发 ,所 以 Struts 
从 诞生 的 第 一 天 起 ， 就 备 受 Java EE 应 用 开发 者 的 青睐 。 多 年 来 ，Struts 确实 是 Java EE 应 用 中 使 用 最 
广泛 的 MVC 框架 ， 拥 有 广泛 的 市 场 支持 。 

Struts 框架 学 习 简单 ， 而 且 是 全 世界 应 用 最 方便 的 MVC 框架 ， 所 以 互联 网 上 充斥 着 大 量 Struts 的 
学 习 资料 ， 这 使 得 普通 学 习 者 可 以 非常 容易 地 掌握 Struts 的 用 法 。 

从 另 一 方面 来 看 ，Struts 框架 毕竟 太 老 了 ， 无 数 设计 上 的 硬 伤 使 得 该 框架 难以 胜任 更 复杂 的 需求 ， 
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于 是 古老 的 Struts 结合 了 另 一 个 优秀 的 MVC 框架 : WebWork， 分 娩出 了 全 新 的 Struts 2，Struts 2 拥有 
众多 优秀 的 设计 ， 而 且 吸 收 了 传统 Struts 和 WebWork 两 者 的 精华 ， 迅 速成 为 MVC 框架 中 新 的 王者 。 
Struts 2 框架 目前 的 最 新 版 本 是 Struts 2.2， 这 也 是 本 书 所 采用 的 版 本 。 
虽然 Struts 2.2 如 此 优秀 ， 但 在 MVC 框架 领域 还 有 另外 两 个 替代 者 : JSF 和 Tapestry。 
> JSF 是 Sun 所 推荐 的 Java EE 规范 ， 拥 有 最 纯正 的 血统 ， 而 且 Apache 也 为 JSF 提供 了 
MyFaces 实现 ， 这 使 得 JSF 具有 很 大 的 吸引 力 。 


发 ) 理念 。 只 是 Struts 早 就 深入 人 心 ， 所 以 导致 JSF 在 市 场 占有 率 上 略 进 一 筹 。 | 

> ”Tapestry 是 Apache 组 织 下 的 另 一 个 优秀 的 MVC 框架 ，Tapestry 框架 已 经 完全 脱离 了 传统 
Servlet API， 是 一 种 纯粹 的 、 组 件 式 的 MVC 框架 ，Tapestry 同时 提供 了 控制 器 和 页 面 模板 
的 解决 方案 ， 使 用 Tapestry 无 须 使 用 JSP 等 其 他 表现 层 技术 ，Tapestry 也 是 非常 有 吸引 力 
的 MVC 框架 。 


>>1.2.3 ”Hibernate 3.6 及 替代 技术 


传统 的 Java 应 用 都 是 采用 JDBC 来 访问 数据 库 的 ， 但 传统 的 JDBC 采用 的 是 一 种 基于 SQL 的 操 
作 方式 ， 这 种 操作 方式 与 Java 语言 的 面向 对 象 特征 不 太一 致 ， 所 以 Java EE 应 用 需要 一 种 技术 ， 通 过 
这 种 技术 能 让 Java 以 面向 对 象 的 方法 操作 关系 数据 库 。 

这 种 特殊 的 技术 就 是 ORM (Object Relation Mapping)， 最 早 的 ORM 是 Entity EJB (Enterprise 
JavaBean)，EJB 就 是 经 典 Java EE 应 用 的 核心 ,从 EJB 1.0 到 EJB 2.X, 许多 人 觉得 EJB 非常 烦琐 ， 所 
以 导致 EJB 备 受 诉 病 。 

在 这 种 背景 下 ，Hibernate 框架 应 运 而 生 ，Hibernate 框架 是 一 种 开源 的 、 轻 量 级 的 ORM 框架 
允许 将 普通 的 、 传 统 的 Java 对 象 〈(POJO) 映射 成 持久 化 类 ， 人 允许 应 用 程序 以 面向 对 象 的 方式 来 操作 
POJO， 而 Hibernate 框架 则 负责 将 这 种 操作 转换 成 底层 的 SQL 操作 。 

经 过 长 时 间 的 发 展 ， 现 在 的 Hibernate 已 经 逐渐 稳定 下 来 ，Hibernate 的 最 新 版 本 是 3.6， 这 是 本 书 
所 使 用 的 Hibernate 版 本 。 

再 后 来 , Sun 公司 果断 地 抛弃 了 EJB 2.X 规范 , 引入 了 JPA 规范 。JPA 规范 其 实 是 一 种 ORM 规范 ， 
因此 它 的 底层 可 以 使 用 Hibemate、TopLink 等 任意 一 种 ORM 框架 作为 实现 。 很 明显 ， 如 果 应 用 程序 
面向 JPA 编程 ， 将 可 以 让 应 用 程序 既 可 利用 Hibemate 的 持久 层 技术 一 一 因为 可 以 用 Hibernate 作为 实 
现 ， 也 可 以 让 应 用 程序 保持 较 好 的 可 扩展 性 一 一 因为 可 以 在 各 种 ORM 技术 之 间 自 由 切换 。 

除了 可 以 使 用 Hibemate 这 种 ORM 框架 之 外 ， 轻 量 级 Java EE 应 用 通常 还 可 选择 iBATIS 框架 作 
为 持久 层 框架 ，iBATIS 是 Apache 组 织 提供 的 男 一 个 轻 量 级 持久 层 框架 ，iBATIS 允许 将 SQL 语句 映 
射 成 对 象 ， 所 以 我 们 常常 也 将 iBATIS 称 为 SQL Mapping 工具 。 

除 此 之 外 ，Oracle 的 TopLink、Apache 的 OJB 都 可 作为 Hibernate 的 替代 方案 ,但 由 于 种 种 原因 ， 
它们 并 未 得 到 广泛 的 市 场 支持 ， 所 以 这 两 个 框架 的 资料 、 文 档 相对 较 少 ， 选 择 它们 需要 一 定 的 勇气 和 
技术 功底 。 


>》>1.2.4 Spring 3.0 及 替代 技术 


如 果 你 有 5 年 以 上 的 Java EE 开发 经 验 、 并 主持 过 一 些 大 型 项 目的 设计 ， 你 会 发 现 Spring 框架 似 
曾 相识 ，Spring 甚至 没有 太 多 的 新 东西 ， 它 只 是 抽象 了 大 量 Java EE 应 用 中 常用 代码 ， 将 它们 抽象 成 
一 个 框架 ， 通 过 使 用 Spring 可 以 大 幅度 地 提高 开发 效率 ， 并 可 以 保证 整个 应 用 具有 良好 的 设计 。 


http://52pdf.taobao.com 


| 


Spring 框架 里 充满 了 各 种 设计 模式 的 应 用 ， 如 单 例 模式 、 工 厂 模式 、 抽 象 工厂 模式 、 命 令 模式 、 
职责 链 模式 、 代 理 模 式 等 ，Spring 框架 的 用 法 、 源 码 则 更 是 一 道 丰盛 的 Java 大 餐 。 

Spring 框架 号 称 Java EE 应 用 的 一 站 式 解决 方案 ，Spring 本 身 提供 了 一 个 设计 优良 的 MVC 框架 
SpringMVC， 使 用 Spring 框架 则 可 直接 使 用 该 MVC 框架 。 但 实际 上 ，Spring 并 未 提供 完整 的 持久 层 
框架 一 一 这 可 以 理解 成 一 种 “ 空 ”， 但 这 种 “ 空 ” 正 是 Spring 框架 的 魅力 所 在 一 一 Spring 能 与 大 部 分 持 
久 层 框架 无 缝 整合，Hibernate? JPA? iBATIS? TopLink? 更 甚至 直接 使 用 JDBC? 随便 你 喜欢 ， 无 论 
选择 哪 种 持久 层 框架 ，Spring 都 会 为 你 提供 无 缝 的 整合 以 及 极 好 的 简化 。 

从 这 个 意义 上 来 看 ，Spring 更 像 一 种 中 间 层 容器 ，Spring 向 上 可 以 与 MVC 框架 无 颖 整合 ， 向 下 
可 以 与 各 种 持久 层 框架 无 缝 整合， 的确 具有 强大 的 生命 力 。 由 于 Spring 框架 的 特殊 地 位 ， 所 以 轻 量 级 
Java EE 应 用 通常 都 不 会 拒绝 使 用 Spring。 实 际 上 ， 轻 量 级 Java EE 这 个 概念 也 是 由 Spring 框架 衍生 出 
来 的 ，Spring 框架 暂时 没有 较 好 的 替代 框架 。 

Spring 的 最 新 版 本 是 3.0.5， 本 书 所 介绍 的 Spring 也 是 基于 该 版 本 的 。 

上 面 我 们 介绍 的 Struts 2.2、Hibernate 3.6 和 Spring 3.0 都 是 Java 领域 最 常见 的 框架 ， 这 些 框架 具 
有 广泛 的 开发 者 支持 ， 能 极 好 地 提高 Java EE 应 用 的 开发 效率 ， 并 能 保证 应 用 具有 稳定 的 性 能 。 

但 常常 有 些 初学 者 ， 甚 至 包括 一 些 所 谓 的 企业 开发 人 士 提 出 : 为 什么 需要 使 用 框架 ? 我 用 JSP 和 
Servlet 已 经 足够 了 。 

提出 这 些 疑 问 的 人 通常 还 未 真正 进入 企业 开发 ， 或 者 从 未 开发 一 个 真正 的 项 目 。 因 为 真实 的 企业 
应 用 开发 有 两 个 重要 的 关注 点 ， 可 维护 性 和 复 用 。 

先 从 软件 的 可 维护 性 来 考虑 这 种 说 法 ， 对 于 全 部 采用 JSP 和 Servlet 的 应 用 ， 因 为 分 层 不 够 清晰 ， 
业务 逻辑 的 实现 没有 单独 分 离 出 来 ， 造 成 系统 后 期 维护 困难 。 甚 至 在 开发 初期 ， 如 果 多 个 程序 员 各 自 
习惯 过 异 ， 也 可 能 造成 业务 逻辑 实现 位 置 不 同 而 冲突 。 

从 软件 复 用 角度 来 考虑 ， 这 是 一 个 企业 开发 的 生命 ， 企 业 以 追求 利润 为 最 大 目标 ， 企 业 希 望 以 最 
快 的 速度 ， 开 发 出 最 稳定 、 最 实用 的 软件 。 因 为 系统 没有 使 用 任何 框架 ， 每 次 开发 系统 都 需要 重新 开 
发 ， 重 新 开发 的 代码 具有 更 多 的 漏洞 ， 这 增加 了 系统 出 错 的 风险 ， 另 外 ， 每 次 开发 新 代码 都 需要 投入 
更 多 的 人 力 和 物力 。 

就 笔者 多 年 的 实际 开发 经 验 来 看 ， 即 使 在 早期 使 用 PowerBuilder 和 Delphi 开发 的 时 代 ， 每 个 公司 
都 会 有 自己 的 基础 类 库 一 一 这 些 就 是 软件 的 复 用 ， 这 些 基础 类 库 将 在 后 续 开发 中 多 次 重复 使 用 。 对 于 
信息 化 系统 而 言 ， 总 有 一 些 开发 过 程 是 重复 的 ， 为 什么 不 将 这 些 重复 开发 工作 抽象 成 基础 类 库 ? 这 种 
抽象 既 提高 了 开发 效率 ， 而 且 因为 重复 使 用 ， 也 降低 了 引入 错误 的 风险 。 

因此 只 要 是 一 个 有 实际 开发 经 验 的 软件 公司 ， 就 一 定 会 有 自己 的 一 套 基础 类 库 ， 这 就 是 需要 使 用 
框架 的 原因 。 从 某 个 角度 来 看 ， 框 架 也 是 一 套 基础 类 库 ， 它 抽象 了 软件 开发 的 通用 步骤 ， 让 实际 开发 
人 员 可 以 直接 利用 这 部 分 实现 。 当 然 ， 即 使 使 用 JSP 和 Servlet 开发 的 公司 ， 也 可 以 抽象 出 自己 的 一 套 
基础 类 库 ， 那么 这 也 是 框架 ! 一 个 从 事实 际 开发 的 软件 公司 ,不 管 他 是 否 意识 到 ,他 已 经 在 使 用 框架 。 
区 别 只 有 使 用 的 框架 到 底 是 别人 提供 的 ， 还 是 自己 抽象 出 来 的 。 

到 底 是 使 用 第 三 方 提供 的 框架 更 好 ， 还 是 使 用 自己 抽象 的 框架 更 好 ? 这 个 问题 就 见仁见智 了 ， 通 
常 而 言 , 使 用 第 三 方 提 供 的 框架 更 稳定 , 更 有 保证 ,因为 第 三 方 提供 的 框架 往往 经 过 了 更 多 人 的 测试 。 
而 使 用 自己 抽象 的 框架 则 更 加 熟悉 底层 运行 原理 ， 出 了 问题 更 好 把 握 。 如 果 不 是 有 非常 特殊 的 理由 ， 
还 是 推荐 使 用 第 三 方 框架 ,特别 是 那些 流行 的 、 广 泛 使 用 的 、 开 源 的 框架 。 


1.3 ” Tomcat 的 下 载 和 安装 


Tomcat 是 Java 领域 最 著名 的 开源 Web 容器 ， 简 单 、 易 用 ， 稳 定性 极 好 ， 既 可 以 作为 个 人 学 习 
之 用 ， 也 可 以 作为 商业 产品 发 布 。Tomcat 不 仅 提供 了 Web 容器 的 基本 功能 ， 还 支持 JAAS 和 JNDI 
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绑 定 等 。 
Tomcat 最 新 的 发 布 版 本 为 7.0.6， 笔 者 所 介绍 的 应 用 也 是 基于 该 版 本 的 Tomcat， 建 议 读者 安装 这 


个 版 本 的 Tomcat。 
>>1.3.1 安装 Tomcat 服务 器 


因为 Tomecat 完全 是 纯 Java 实现 , 因此 它 是 平台 无 关 的 , 在 任何 平台 上 运行 完全 相同 。 在 Windows 
和 Linux 平台 上 的 安装 和 配置 基本 相同 。 本 节 以 Windows 平台 为 示范 ， 介 绍 Tomcat 的 下 载 和 安装 。 

人 @G 登录 httpWtomcatapache.org 站 点 ， 下 载 Tomcat 合适 的 版 本 ， 本 书 使 用 了 JDK 1.6、 而 且 需 要 
使 用 Servlet 3.0 规范 ， 因 此 必须 使 用 Tomcat 7.0.X 或 更 新 的 版 本 系列 。 


提示 
得 前 Tomcat 有 几 个 稳定 的 产品 版 本 ， 通 常 JDK 1.4 建议 使 用 Tomcat 5.0.X 系列 ，JDK : 
1.5 建议 使 用 Tomcat 5.5.X 系 列 ，JDK 1.6 则 建议 使 用 Tomcat 6.0.X 系列 。 而 Tomcat 只 有 


Tomcat 7.0.X 的 最 新 稳定 版 本 是 7.0.6， 建 议 下 载 该 版 本 ，Windows 平台 下 载 ZIP 包 ，Linux 平台 
下 载 TAR 包 。 建 议 不 要 下 载 安 装 文件 ， 因 为 安装 文件 的 Tomcat 看 不 到 启动 、 运 行 时 控制 台 的 输出 ， 
不 利于 开发 者 使 用 。 
全 解压 缩 刚 下 载 到 的 压缩 包 ， 解 压缩 后 应 有 如 下 文件 结构 。 
> bin， 存放 启动 和 关闭 Tomcat 的 命令 的 路 径 。 
> ”conf; 存放 Tomcat 的 配置 ， 所 有 的 Tomcat 的 配置 都 在 该 路 径 下 设置 。 
> lib: 存放 着 Tomcat 服务 器 的 核心 类 库 (JAR 文件 ) ， 如 果 需 要 扩展 Tomcat 功能 ， 也 可 将 
第 三 方 类 库 复制 到 该 路 径 下 。 
> “logs: 这 是 一 个 空 路 径 ， 该 路 径 用 于 保存 Tomcat 每 次 运行 后 产生 的 日 志 。 
> ”temp: 保存 Web 应 用 运行 过 程 中 生成 的 临时 文件 。 
> ” webapps: 该 路 径 用 于 自动 部 署 Web 应 用 ， 将 Web 应 用 复制 在 该 路 径 下 ，Tomcat 会 将 该 
应 用 自动 部 署 在 容器 中 。 
> ”work: 保存 Web 应 用 运行 过 程 中 ， 编 译 生成 的 class 文件 。 该 文件 夹 可 以 删除 ， 但 每 次 启动 
Tomcat 服务 器 时 ， 系 统 将 再 次 建立 该 路 径 。 
> ”LICENSE 等 相关 文档 。 
将 解压 缩 后 的 文件 夹 放 在 任意 路 径 下 。 
运行 Tomcat 只 需要 一 个 环境 变量 ，JAVA_HOME.。 不 管 是 Windows， 还 是 Linux， 只 需要 增加 该 
环境 变量 即 可 ， 该 环境 变量 的 值 指向 JDK 安装 路 径 。 


提示 < 
“和 如果 读 者 还 不 懂 如 何 配置 环境 变量 ， 请 读者 先 阅读 疯狂 Java 体系 的 《疯狂 Java 讲义 》 
一 书 的 第 1 章 。 本 书 由 于 篇 幅 关 系 ， 将 不 会 详细 介绍 如 何 配置 环境 变量 的 相关 步骤 。 | 


此 处 JAVA_HOME 环境 变量 应 指向 JDK 安装 路 径 ， 不 是 JRE 的 安装 路 径 。JDK 


安装 路 径 下 应 该 包含 bin 目录 ， 该 目录 下 应 该 有 javac.exe、native2ascii.exe 等 程序 ; JDK : 
的 安装 路 径 下 还 含有 一 个 lib 目录 ， 该 目录 下 应 该 有 dtjar 和 toolsjar 两 个 文件 ，JDK 安 要 


装 路 径 下 还 应 该 包含 jre 目录 ， 这 个 jre 目录 就 是 JDK 自 带 的 JRE 
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@ 启动 Tomcat， 对 于 Windows 平台 ， 只 需要 双击 Tomcat 安装 路 径 下 bin 路 径 中 的 startup.bat 文 


件 即 可 。 
启动 Tomcat 之 后 ， 打 开 浏览 器 ， 在 地 址 栏 输入 http://localhost:8080， 然 后 回 车 ， 浏 览 器 中 出 现 如 


图 1.2 所 示 的 界面 ， 即 表示 Tomcat 安装 成 功 。 


图 1.2 ”Tomecat 安装 成 功 界面 


Tomcat 安装 成 功 后 ， 必 须 对 其 进行 简单 的 配置 ， 这 些 配置 包括 Tomcat 的 端口 、 控 制 台 等 ， 下 面 
详细 介绍 这 些 配置 过 程 。 

虽然 Tomcat 是 一 个 免费 的 Web 服务 器 ， 但 也 提供 了 图 形 界面 控制 台 ， 通 过 控制 台 ， 用 户 可 以 方 
便 地 部 署 Web 应 用 、 监 控 Web 应 用 的 状态 等 。 但 对 于 一 个 开发 者 而 言 ， 笔 者 还 是 建议 通过 修改 配置 
文件 来 管理 Tomcat 配置 ， 而 不 是 通过 图 形 界面 。 


>》>1.3.2 配置 Tomcat 的 服务 端口 


Tomcat 的 默认 服务 端口 是 8080， 可 以 通过 管理 Tomcat 配置 文件 来 改变 该 服务 端口 ， 其 至 可 以 通 
过 修改 配置 文件 让 Tomcat 同时 在 多 个 端口 提供 服务 。 

Tomcat 的 配置 文件 都 放 在 conf 目录 下 ， 控 制 端 口 的 配置 文件 也 放 在 该 路 径 下 。 打 开 conf 下 的 
server.xml 文件 ， 务 必 使 用 记事 本 或 vi 等 无 格式 的 编辑 器 ， 不 要 使 用 如 写字 板 等 有 格式 的 编辑 器 。 定 
位 server.xml 文件 的 68 行 处 看 到 如 下 代码 : 


<Connector port="8080" protocol="HTTP/1:1" 
connectionTimeout="20000" 
redirectPort="8443" /> 


其 中 , port=8080 就 是 Tomcat 提供 Web 服务 的 端口 , 将 8080 修改 成 任意 的 端口 , 建议 要 使 用 1024 
以 上 的 端口 ,避免 与 公用 端口 冲突 。 笔 者 将 此 处 修改 为 8888, 即 Tomcat 的 Web 服务 的 提供 端口 为 8888。 

修改 成 功 后， 重新 启动 Tomcat 后 ， 在 浏览 器 地 址 栏 输入 http://localhost:8888， 回 车 将 再 次 看 到 如 
图 1.2 所 显示 的 界面 ， 即 显示 Tomcat 端口 修改 成 功 。 


提示 : 
“如 果 需 要 让 Tomcat 运行 多 个 服务 ， 只 需要 复制 Serverxml 文件 中 的 <Service> 元 素 ， 并 : 
修改 相应 的 参数 便 可 以 实现 一 个 Tomcat 运行 多 个 服务 ， 当 然 必 须 在 不 同 的 端口 提供 服务 ， | 
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在 Web 应 用 的 开发 阶段 ， 通 常 希望 Tomcat 能 列 出 Web 应 用 根 路 径 下 的 所 有 页 面 ， 这 样 能 更 方便 
地 选择 需要 调试 的 JSP 页 面 。 默 认 情 况 下 ， 出 于 安全 考虑 ，Tomcat 并 不 会 列 出 Web 应 用 根 路 径 下 的 
所 有 页 面 ， 为 了 让 Tomcat 列 出 Web 应 用 根 路 径 下 的 所 有 页 面 ， 可 以 打开 Tomcat 的 conf 目录 下 的 
web.xml 文件 ， 在 该 路 径 下 104、105 两 行 ， 看 到 一 个 listings 参数 ， 该 参数 的 值 默认 是 false， 将 该 参 
数 改 为 true 即 可 让 Tomecat 列 出 Web 应 用 根 路 径 下 的 所 有 页 面 。 即 将 这 两 行 改 为 如 下 形式 即 可 : 


<init-param> 
<param-name>listings</param-name> 
<param-value>true</param-value> 
</init-param> 


>>1.3.3 进入 控制 台 


在 图 1.2 右上 角 , 显示 有 三 个 控制 台 : 一 个 是 Server Status 控制 台 , 另 一 个 是 Manager App 控制 台 ， 
还 有 一 个 是 Host Manager 控制 台 。Status 控制 台 用 于 监控 服务 器 的 状态 , 而 Manager 控制 台 可 以 部 署 、 
监控 Web 应 用 ， 因 此 我 们 通常 只 使 用 Manager 控制 台 即 可 。 

如 图 1.2 左上 角 所 示 的 第 二 个 按钮 ， 即 是 进入 Manager 控制 台 的 链接 ， 单 击 该 按钮 将 出 现 如 图 1.3 
所 示 的 登录 界面 。 

这 个 控制 台 必须 输入 用 户 名 和 密码 才 可 以 登录 , 控制 台 的 用 户 名 和 密码 是 通过 Tomcat 的 JAAS 控 
制 的 ， 下 面 介绍 如 何 为 这 个 控制 台 配 置 用 户 名 和 密码 。 


JAAS 的 全 称 是 Java Authentication Authorization Service ( 即 Java 验证 和 授权 API )， 
它 用 于 控制 对 Java Web 应 用 的 授权 访问 .关于 JAAS 的 全 面 介绍 请 参看 本 书 姊妹 篇 《经 典 。 
| ”Java EE 企业 应 用 实战 j 
前 面 关于 Tomcat 文件 结构 的 介绍 已 经 指出 : webapps 路 径 是 Web 应 用 的 存放 位 置 ， 而 Manager 
控制 台 对 应 的 Web 应 用 也 是 放 在 该 路 径 下 的 。 进 入 webapps/manager/WEB-INF 路 径 下 , 该 路 径 存 放 了 
Manager 应 用 的 配置 文件 ， 用 无 格式 编辑 器 打开 web.xml 文件 。 


图 1.3 登录 Manager 控制 台 


在 该 文件 的 最 后 部 分 ， 看 到 如 下 配置 片段 : 
<security-constraint> 
<!-- 访问 /html/* 资 源 需要 manager-gui 角色 --> 
<web-resource-collection> 
<web-resource-name>HTML Manager interface (for humans)</web-resource-name> 
<url-pattern>/html/*</url-pattern> 
</web-resource-collection> 
<auth-constraint> 
<role-name>manager-gui</role-name> 
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</auth-constraint> 
</security-constraint> 
<security-constraint> 
<!-- 访问 /text/* 资 源 需要 manager-script 角色 --> 
<web-resource-collection> 
<web-resource-name>Text Manager interface (for scripts)</web-resource-name> 
<url-pattern>/text/*</url-pattern> 
</web-resource-collection> 
<auth-constraint> 
<role-name>manager-script</role-name> 
</auth-constraint> 
</security-constraint> 
<security-constraint> 
<!-- 访问 /jmxproxy/* 资 源 需要 manager-jmx 角色 --> 
<web-resource-collection> 
<web-resource-name>JMX Proxy interface</web-resource-name> 
<url-pattern>/jmxproxy/*</url-pattern> 
</web-resource-collection> 
<auth-constraint> 
<role-name>manager-jmx</role-name> 
</auth-constraint> 
</security-constraint> 
<security-constraint> 
<!-- 访问 /status/* 资 源 可 使 用 以 下 任意 一 个 角色 --> 
<web-resource-collection> 
<web-resource-name>Status interface</web-resource-name> 
<url-pattern>/status/*</url-pattern> 
</web-resource-collection> 
<auth-constraint> 


册 


</auth-constraint> 
</security-constraint> 
<!-- 确定 JAAS 的 登录 方式 --> 
<login-config> 
<!-- BASIC 表明 使 用 弹出 式 窗口 登录 --> 
<auth-method>BASIC</auth-method> 
<realm-name>Tomcat Manager Application</realm-name> 
</login-config> 


通过 上 面 的 配置 文件 可 以 知道 : 登录 Manager 控制 台 可 能 需要 不 同 的 manager 角色 。 对 于 普通 开 
发 者 来 说 ， 通 常 需要 访问 匹配 /texV*、/status/* 的 资源 ， 因 此 为 该 用 户 分 配 一 个 manager-gui 角色 即 可 。 

Tomcat 默认 采用 文件 安全 域 ， 即 以 文件 存放 用 户 名 和 密码 ，Tomcat 的 用 户 由 conf 路 径 下 的 
tomcat-users.xml 文件 控制 ， 打 开 该 文件 ， 发 现 该 文件 内 有 如 下 内 容 : 


<?xml version='1.0' encoding='utf-8'?> 
<tomcat-users> 
</tomcat-users> 


上 面 的 配置 文件 显示 了 Tomcat 默认 没有 配置 任何 用 户 , 所 以 无 论 我 们 在 如 图 1.3 所 示 的 登录 对 话 
框 中 输入 任何 内 容 ， 系 统 都 不 会 让 我 们 成 功 登 录 。 为 了 正常 登录 Manager 控制 台 ， 可 以 通过 修改 
tomcat-users.xml 文件 来 增加 用 户 ， 并 让 该 用 户 属于 manager 角色 即 可 。Tomcat 允许 在 <tomcat-users> 
元 素 中 增加 <user> 元 素来 增加 用 户 ， 将 tomcat-users.xml 文件 内 容 修改 如 下 : 


<?xml version='1.0' encoding="'utf-8'?> 
<tomcat-users> 
<!-- 增加 一 个 角色 ， 指 定 角色 名 即 可 -> 
<role rolename="manager-gui"/> 
<!-- 增加 一 个 用 户 ， 指 定 用 户 各 、 密 码 和 和 角色 即 可 --> 
<user username="manager" password="manager" roles="manager-gui"/> 
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</tomcat-users> 

上 面 的 配置 文件 中 粗 体 字 代码 行 增加 了 一 个 用 户 : 用 户 名 为 manager， 密码 为 manager， 角 色 属 于 
manager-gui。 这 样 , 我 们 就 可 以 在 如 图 1.3 所 示 的 登录 对 话 框 中 输入 manager、 manager 来 登录 Manager 
控制 台 。 成 功 登 录 后 可 看 到 如 图 1.4 所 示 的 界面 。 

在 如 图 1.4 所 示 的 控制 台 可 监控 到 所 有 部 署 在 该 服务 器 下 的 Web 应 用 ， 左 边 列 出 了 所 有 部 署 在 该 
Web 容器 内 的 Web 应 用 ， 右 边 的 4 个 按钮 则 用 于 控制 ， 包 括 启动 、 停 止 、 重 启 等 。 

控制 台 下 方 的 Deploy 区 则 用 于 部 署 Web 应 用 。Tomcat 控制 台 提供 两 种 方式 部 署 Web 应 用 ， 一 种 
是 将 整个 路 径 部 署 成 Web 应 用 , 另 一 种 是 将 WAR 文件 部 署 成 Web 应 用 (在 图 1.4 中 看 不 到 这 种 方式 ， 
在 Deploy 区 下 面 ， 还 有 一 个 WAR file to deploy 区 ， 用 于 部 署 WAR 文件 )。 


图 1.4 Tomcat 的 Manager 控制 台 


>>1.3.4 部 署 Web 应 用 


在 Tomcat 中 部 署 Web 应 用 的 方式 主要 有 如 下 几 种 : 

> ”利用 Tomcat 的 自动 部 署 。 

> ”利用 控制 台 部 署 。 

> ”增加 自 定义 的 Web 部 署 文件 。 

> ”修改 server.xml 文件 部 署 Web 应 用 。 

利用 Tomcat 自动 部 署 方式 是 最 简单 、 最 常用 的 方式 ， 我 们 只 要 将 一 个 Web 应 用 复制 到 Tomcat 
的 webapps 下 ， 系 统 将 会 把 该 应 用 部 署 到 Tomcat 中 。 

利用 控制 台 部 署 Web 应 用 也 很 简单 , 只 要 我 们 在 部 署 Web 应 用 的 控制 台 按 如 图 1.5 所 示 方式 输入 
即 可 。 

当 我 们 按 如 图 1.5 所 示 方 式 输入 后 ， 单 击 “Deploy” 按 钮 ， 将 会 看 到 Tomcat 的 webapps 目录 下 多 
了 一 个 名 为 aaa 的 文件 夹 ， 该 文件 夹 的 内 容 和 G:\publishveodes\W2\2.1\ 路 径 下 webDemo 文件 夹 的 内 容 
完全 相同 一 一 这 表明 : 当 我 们 利用 控制 台 部 署 Web 应 用 时 ， 其 实质 依然 是 利用 Tomcat 的 自动 部 署 。 

第 三 种 方式 则 无 须 将 Web 应 用 复制 到 Tomecat 安装 路 径 下 ， 只 是 部 署 方式 稍稍 复杂 一 点 ， 我 们 需 
要 在 conf 目录 下 新 建 Catalina 目录 ， 再 在 Catalina 目录 下 新 建 localhost 目录 ， 最 后 在 该 目录 下 新 建 一 
个 名 字 任意 的 XML 文件 一 一 该 文件 就 是 部 署 Web 应 用 的 配置 文件 ,该 文件 的 主 文件 名 将 作为 Web 应 
用 的 虚拟 路 径 。 例 如 ， 我 们 在 conf/Catalina/localhost 下 增加 一 个 dd.xml 文件 ， 该 文件 的 内 容 如 下 : 
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<Context docBase="G:/publish/codes/01/aa" debug="0" privileged="true"> 
</Context> 


上 面 的 配置 文件 中 粗 体 字 代码 指定 了 Web 应 用 的 绝对 路 径 ， 再 次 启动 Tomcat，Tomcat 将 会 把 
G:/publish/codes/ 路 径 下 的 webDemo 文件 夹 部 署 成 Web 应 用 。 该 应 用 的 URL 地 址 为 : 
http://<server_address>:<port>/dd 


其 中 URL 中 的 dd 就 是 Web 部 署 文件 的 主 名 。 


Slot Wp thle to elo Ton- 


图 1.5 利用 控制 台 部 署 Web 应 用 


最 后 还 有 一 种 方式 是 修改 serverxml 文件 ， 这 种 方式 需要 修改 conf 目录 下 的 serverxml 文件 ， 修 
改 该 文件 可 能 破坏 Tomcat 的 系统 文件 ， 因 此 不 建议 采用 。 


>》1.3.5 配置 Tomcat 的 数据 源 


从 Tomcat 5.5 开始 , Tomcat 内 置 了 DBCP 的 数据 源 实现 ,所 以 可 以 非常 方便 地 配置 DBCP 数据 源 。 

Tomcat 提供 了 两 种 配置 数据 源 的 方式 ， 这 两 种 方式 所 配置 的 数据 源 的 访问 范围 不 同 : 一 种 数据 源 
可 以 让 所 有 的 Web 应 用 都 访问 ， 被 称 为 全 局 数据 源 ， 另 一 种 只 能 在 单个 的 Web 应 用 中 访问 ， 被 称 为 
局 部 数据 源 。 

不 管 配置 哪 种 数据 源 ， 都 需要 提供 特定 数据 库 的 JDBC 驱动 。 本 书 以 MySQL 为 例 来 配置 数据 源 ， 
所 以 读者 须 将 MySQL 的 JDBC 驱动 程序 复制 到 Tomcat 的 lib 路 径 下 。 


”如 果 读者 不 了 解数 据 库 驱动 程序 的 概念 ， 请 查阅 疯狂 Java 体系 的 《疯狂 Java 讲义 》 
一 书 . MySQL 数 括 当归 动 厅 以 到 MySQL 定 官方 站 点 下 载 。 ey 


局 部 数据 源 无 须 修改 系统 的 配置 文件 ， 只 需 修改 用 户 自己 的 Web 部 署 文件 , 不 会 造成 系统 的 混乱 ， 
而 且 数据 源 被 封装 在 一 个 Web 应 用 之 内 ， 防 止 被 其 他 的 Web 应 用 访问 ， 提 供 了 更 好 的 封装 性 。 

局 部 数据 源 只 与 特定 的 Web 应 用 相关 ， 因 此 在 该 Web 应 用 对 应 的 部 署 文件 中 配置 。 例 如 ， 为 上 
面 的 Web 应 用 增加 局 部 数据 源 , 修改 Tomcat 下 conf/Catalina/localhost 下 的 dd.xml 文件 即 可 。 为 Context 
元 素 增加 一 个 Resource 子 元 素 ， 增 加 局 部 数据 源 后 的 dd.xml 文件 内 容 如 下 : 

程序 清单 : codes\01\dd.xml 

<?xml version="1.0" encoding="GBK"?> 
<Context docBase="G:/publish/codes/01/aa" debug="0" privileged="true"> 
<!-- 其 中 name 指定 数据 源 在 容器 中 的 JNDI 名 
driverClassName 指定 连接 数据 库 的 驱动 
url 指定 数据 库 服务 的 URL 
username 指定 连接 数据 库 的 用 户 名 
password 指定 连接 数据 库 的 密码 


maxActive 指定 数据 源 最 大 活动 连接 数 
maxIdle 指定 数据 池 中 最 大 的 空间 连接 数 


了 3 


http://52pdf.taobao.com 
米 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


maxWait 指定 数据 池 中 最 大 等 待 获取 连接 的 客户 端 

--> 

<Resource name="jdbc/dstest" auth="Container" 
type="javax. sql .Datasource"™ 
driverClassName="com.mysql. jdbc.Driver" 
url="jdbe:mysql://localhost:3306/javaee" 
username="root" password="32147" maxActive="5" 
maxIdle="2" maxWait="10000"/> 

</Context> 


上 面 的 配置 文件 中 粗 体 字 标 出 的 Resource 元 素 就 为 该 Web 应 用 配置 了 一 个 局 部 数据 源 ， 该 元 素 
的 各 属性 指定 了 数据 源 的 各 种 配置 信息 。 


(Qa 提示 : 
gO JNDI 的 全 称 是 Java Naming Directory Interface， 即 Java 命名 和 目录 接口 ， 听 起 来 非常 专 
业 ， 其 实 很 简单 :就 是 为 某 个 Java 对 象 起 一 个 名 字 。 例如， 上面 JNDI 的 用 途 就 是 为 Tomcat ， 
| ”容器 中 的 数据 源 起 一 个 名 字 : jdbc/dstest, 从 而 让 其 他 程序 可 | 该 名 字 来 访问 该 数据 源 对 象 。 ] 


再 次 启动 Tomcat， 该 Web 应 用 即 可 通过 该 JNDI 名 字 来 访问 该 数据 源 。 下 面 是 测试 访问 数据 源 的 
JSP 页 面 代码 片段 : 
程序 清单 :codes\01\aa\tomcatTest.jsp 
// 初 始 化 Context， 使 用 InitialContext 初始 化 Context 
Context ctx=new ITnitialContext() 7 
/* 
通过 JNDI 查找 数据 源 ， 访 JNDI 为 java:comp/env/jdbc/dstest， 分 成 两 个 部 分 
java:comp/env 是 Tomcat 固定 的 ，Tomcat 提供 的 JNDI 绑 定 都 必须 加 该 前 级 
ee 是 定义 数据 源 时 的 数据 源 名 
DataSource ds=(DataSource)ctx.lookup ("java:comp/env/jdbc/dstest") ; 
// 获 取 数 据 库 连 接 
Connection conn=ds.getConnection () 
// 获 取 Statement 
Statement stmt=conn .createStatement (); 
// 执 行 查询 ， 返 回 ResultSet 对 象 


ResultSet rs=stmt.executeQuery("select * from news_inf"); 
while(rs.next()) 
{ 


out.println(rs.getstring(1) 
+ "\t" + rs.getstring(2) + "<br/>"); 
} 


上 面 的 粗 体 字 代 码 实 现 了 JNDI 查找 数据 源 对 象 ， 一 旦 获取 了 该 数据 源 对 象 ， 程 序 就 可 以 通过 该 
数据 源 取得 数据 库 连 接 ， 从 而 访问 数据 库 。 

上 面 的 方式 是 配置 局 部 数据 源 ， 如 果 需 要 配置 全 局 数据 源 ， 则 应 通过 修改 server.xml 文件 来 实现 。 
全 局 数据 源 的 配置 与 局 部 数据 源 的 配置 基本 类 似 ， 只 是 修改 的 文件 不 同 。 局 部 数据 源 只 需 修改 Web 应 
用 的 配置 文件 ， 而 全 局 数据 源 需要 修改 Tomcat 的 server.xml 文件 。 


盖 
代码 需要 读者 在 本 机 安装 MySQL 数据 库 ， 并 提供 一 个 名 为 javaee 的 数据 


Fg “上面 的 测 
库 , 该 数据 库 下 必须 有 一 个 名 为 news_inf 的 数据 表 , 读 者 可 以 使 用 codes\01 路 径 下 的 testsql | 
| ”脚本 来 建立 这 些 数据 库 对 象 一 这 些 都 是 JDBC 编程 知识 ， 读 者 可 以 阅读 疯狂 Java 体系 的 
《疯狂 Java 讲义 》 第 13 章 来 掌握 相关 知识 。 | 


”使 用 全 局 数据 源 需要 修改 Tomcat 原 有 的 serverxml 文件 , 所 以 可 能 导致 破坏 Tomcat 
计 ， 因 而 尽量 避免 使 用 全 局 数据 


可 
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1.4 Eclipse 的 安装 和 使 用 


Eclipse 平台 是 IBM 向 开放 源码 社区 捐赠 的 开发 框架 ,ITBM 宣称 为 开发 Eclipse 投入 了 4 千 万 美元 ， 
这 种 巨大 投入 开发 出 了 一 个 成 熟 的 、 精 心 设计 的 、 可 扩展 的 开发 工具 。Eclipse 允许 增加 新 工具 来 扩充 
Eclipse 的 功能 ， 这 些 新 工具 就 是 Eclipse 插件 。 

对 于 时 下 的 软件 开发 者 而 言 ，Eclipse 是 一 个 免费 的 IDE 集 成 开发 环境 ) 工具 ， 而 且 ，Eclipse 并 
不 仅仅 局 限于 Java 开发 ， 它 可 支持 多 种 开发 语言 。 在 免费 的 Java 开发 工具 中 ，Eclipse 是 最 受 欢 迎 的 。 

Eclipse 本 身 所 提供 的 功能 比较 有 限 ， 但 它 的 插件 则 大 大 提高 了 它 的 功能 。Eclipse 的 插件 非常 多 ， 
比如 Synchronizer、Lomboz、MyEclipse 等 。 借 助 于 这 些 插件 ，Eclipse 工具 的 表现 相当 出 色 ， 下 面 简 
单 介绍 Eclipse 及 其 插件 的 安装 和 使 用 。 


> 1.4.1 Eclipse 的 下 载 和 安装 


登录 http://www.eclipse.org 站 点 ， 下 载 Eclipse IDE for Java EE Developers 的 最 新 版 本 。Eclipse 当 
前 的 最 新 版 本 是 Eclipse-jee-helios 版 (也 就 是 Eclipse 3.6)， 笔 者 使 用 的 正 是 该 版 本 的 Eclipse。 
A 抽 I 
Eclipse IDE for Java EE Developers 是 Eclipse 为 Java EE 开发 者 准备 的 一 个 IDE 工具， 
它 在 “纯净 ”Eclipse 的 基础 之 上 ， 集 成 了 一 些 Eclipse 插件 ， 允 许 开发 者 不 需 额 外 添加 插 |! 
| 。 件 即 可 进行 Java EE 开发 . ] 
Windows 平台 下 载 eclipse-jee-helios-SR1-win32.zip 文件 ，Linux 平台 下 载 eclipse-jee-helios-SR1- 
linux-gtk.tar.gz 文件 。 解 压缩 下 载 得 到 的 压缩 文件 ， 解 压 后 的 文件 夹 可 放 在 任何 目录 。 
直接 双击 eclipse.exe 文件 ， 即 可 看 到 Eclipse 的 启动 界面 ， 表 明 Eclipse 已 经 安装 成 功 。 
Eclipse 本 身 的 开发 能 力 比较 有 限 , 通过 插件 可 以 大 大 增强 它 的 功能 。Eclipse 插件 的 安装 方式 主要 
可 分 为 如 下 三 种 : 
< 装 。 
> 手动 安装 。 
> ”使 用 本 地 压缩 包 安装 。 
下 面 详细 介绍 Eclipse 插件 的 两 种 安装 方式 。 


> >1.4.2 在 线 安装 Eclipse 插件 


在 线 安装 简单 方便 ， 适 合 网 络 畅通 的 场景 。 在 线 安装 可 以 保证 插件 的 
完整 性 ， 并 可 自由 选择 最 新 的 版 本 。 如 果 网 络 环境 允许 ， 在 线 安装 是 个 较 
好 的 安装 方式 。 

在 线 安装 插件 请 按 如 下 步骤 进行 : 

人 单 击 Eclipse 的 “Help” 菜单 , 选中 其 中 的 “Install New Software...” 


菜单 项 ， 如 图 1.6 所 示 。 图 1.6 安装 Eclipse 插件 
人 单 击 图 1.6 所 示 的 “Install New Software” 菜 单项 ， 弹 出 如 图 1.7 所 示 的 对 话 框 ， 该 对 话 框 用 于 
选择 安装 新 插件 或 升级 已 有 插件 。 该 对 话 框 上 面 有 一 个 “Work with” 下 拉 列 表 框 ， 通 过 该 列表 框 可 以 选 
择 Eclipse 已 安装 过 的 插件 ， 选 择 指定 插件 项 目 后 ， 该 对 话 框 的 下 面 将 会 列 出 该 插件 所 有 可 更 新 的 项 目 。 
地 


可 更 新 的 项 目 。 
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图 1.7 选择 升级 或 安装 新 插件 


人 @@ 如 果 需 要 升级 已 有 插件 ， 通 过 “Work with” 列 表 框 选择 指定 插件 项 ， 然 后 在 下 面 勾 选 需 要 更 
新 的 插件 项 ， 然 后 单 击 下 面 的 “Next” 按 钮 ，Eclipse 将 出 现 如 图 1.8 所 示 的 升级 界面 。 

在 图 1.8 所 示 界 面 中 等 待 Eclipse 完成 升级 ， 升 级 完成 后 单 击 “Finish” 按 钮 即 可 。 

@ 如 果 需 要 安装 新 插件 ， 单 击 如 图 1.7 所 示 对 话 框 中 的 “Add..” 按 钮 ，Eclipse 弹出 如 图 1.9 所 
示 的 对 话 框 。 


图 1.8 等 待 指定 插件 项 更 新 完成 图 1.9 安装 新 插件 
人 在 如 图 1.9 所 示 对 话 框 的 “Name” 文 本 框 中 输入 插件 名 〔 该 名 称 是 任意 的 ， 它 只 是 用 于 标识 


该 安装 项 )， 在 Location 文本 框 中 输入 插件 的 安装 地 址 ， 输 入 完成 后 单 击 “OK ”按钮 ， 返 回 如 图 1.7 
me 此 时 ， 新 增 的 插件 安装 项 已 被 添加 在 图 1.7 所 示 的 空白 处 。 


二. 注 本 ,和 
Eclipse 白 件 的 安 荣 地 上 和 要 从 各 哲人 的 方志 上 得 询 


人 在 如 图 1.7 所 示 对 话 框 中 选择 需要 安装 的 插件 (多 选 上 插件 安装 项 之 前 的 复 选 框 )， 单 击 
“Finish” 按 钮 ， 进 入 安装 界面 。 后 面 的 过 程 随 插件 不 同 可 能 存在 些许 差异 ， 但 通常 只 需要 等 待 即 可 。 
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》>1.4.3 从 本 地 压缩 包 安 装 插件 


为 了 从 本 地 压缩 包 安 装 插件 ， 请 按 如 下 步骤 进行 : 
人 G 按 前 面 步骤 打开 如 图 1.9 所 示 对 话 框 ， 单 击 “Archive...” 按 钮 ， 系 统 弹出 如 图 1.10 所 示 的 文 
件 选择 对 话 框 。 


图 1.10 选择 Eclipse 插件 的 压缩 包 


人 通过 图 1.10 所 示 对 话 框 选择 指定 的 插件 压缩 包 ， 然 后 返回 如 图 1.9 所 示 对 话 框 ， 此 时 将 会 看 
到 “Location” 文 本 框 内 填 入 了 插件 压缩 包 的 位 置 。 单 击 如 图 1.9 所 示 对 话 框 的 “OK” 按 钮 ， 系 统 再 
次 返回 如 图 1.7 所 示 对 话 框 。 

人 @ 在 图 1.7 所 示 对 话 框 中 勾 选 需要 安装 或 升级 的 插件 项 ， 单 击 “Next” 按 钮 ， 等 待 插件 安装 完 
成 即 可 。 


1.4.4 手动 安装 Eclipse 插件 


手动 安装 只 需要 已 经 下 载 的 插件 文件 ， 无 须 网 络 支持 。 手 动 安装 适合 于 没有 网 络 支持 的 环境 ， 手 
动 安装 的 适应 性 广 ， 但 需要 开发 者 自己 保证 插件 版 本 与 Eclipse 版 本 的 兼容 性 。 

手动 安装 也 可 分 为 两 种 安装 方式 : 

> ”直接 安装 。 

> 扩展 安装 。 

1. 直接 安装 

将 插件 中 包含 的 plugins 和 features 文件 夹 的 内 容 直接 复制 到 Eclipse 的 plugins 和 features 文件 来 
内 ， 重 新 启动 Eclipse 即 可 。 

直接 安装 简单 易 用 ， 但 效果 非常 不 好 。 因 为 容易 导致 混乱 : 如 果 安 装 的 插件 非常 多 ， 可 能 导致 用 
户 无 法 精确 判断 哪些 是 Eclipse 默认 的 插件 ， 哪 些 是 后 来 扩展 的 插件 。 

如 果 需 要 停 用 某 些 插件 ， 则 需要 从 Eclipse 的 plugins 和 features 文件 夹 内 删除 这 些 插件 的 内 容 ， 
安装 和 卸载 的 过 程 较为 复杂 。 

2. 扩展 安装 

通常 推荐 使 用 扩展 安装 ， 扩 展 安装 请 按 如 下 步骤 进行 

人 在 Eclipse 安装 路 径 下 新 建 links 路 径 。 

人 在 links 文件 夹 内 ， 建 立 xoxx.link 文件 ， 该 文件 的 文件 名 是 任意 的 ， 但 为 了 较 好 的 可 读 性 ， 通 
常 推荐 该 文件 的 主 文件 名 与 插件 名 相同 ， 文 件 名 后 缀 为 link。 

人 编辑 wexlink 的 内 容 ， 该 文件 内 通常 只 需 如 下 一 行 : 
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path=<pluginPath> 
上 面 内 容 中 path= 是 固定 的 ， 而 <pluginPath> 是 插件 的 扩展 安装 路 径 。 
人 在 xxx.link 文件 中 <pluginPath> 路 径 下 新 建 eclipse 文件 来， 再 在 eclipse 文件 夹 内 建立 plugins 
和 features 文件 夹 。 
(G 将 插件 中 包含 的 plugins 和 features 文件 夹 的 内 容 ， 复 制 到 上 面 建立 的 plugins 和 features 文件 
夹 中 ， 重 启 Eclipse 即 完成 安装 。 
扩展 安装 方式 使 得 每 个 插件 放 在 单独 的 文件 夹 内 ， 因 而 结构 非常 清晰 。 如 果 需 要 卸载 某 个 插件 ， 
只 需 将 该 插件 对 应 的 link 文件 删除 即 可 。 


》>》》>1.4.5 使 用 Eclipse 开发 JavaEE 应 用 
下 面 以 开发 一 个 简单 的 Web 应 用 为 例 ， 向 读者 介绍 通过 Eclipse 开发 Java EE 应 用 的 通用 步骤 。 
坟 
oe 注 刘 :二 


此 处 介绍 的 Eclipse 是 以 Eclipse IDE for Java EE Developers 为 例 ， 如 果 读者 选择 不 | 
同 的 Eclipse 插件 , 其 开发 方式 和 步骤 可 能 略 有 差异 . 比如 读者 选择 使 用 MyEclipse 插件 ， 


为 了 开发 Web 应 用 ， pse 中 配置 Web 服务 器 ， 本 章 将 以 Tomcat 为 例 来 介绍 如 何在 
Eclipse 中 配置 Web 服务 器 。 在 Eclipse 中 配置 Tomcat 按 如 下 步骤 进行 。 

人 @ 单 击 Eclipse 下 方面 板 的 “Servers ”面板 ， 在 该 面板 的 空白 处 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜 
单 中 选择 “New 一 Server” 菜 单项 ， 如 图 1.11 所 示 。 


EE 
[ 

| ep 

l 


图 1.11 添加 服务 器 
人 @ 系统 弹出 如 图 1.12 所 示 对 话 框 。 


图 1.12 选择 配置 Tomcat7.0 


18 


http://52pdf.taobao.com 


| 


全 单 击 如 图 1.12 所 示 对 话 框 中 的 “Apache 一 Tomcat v7.0 Server” 节 点 ， 这 也 是 本 书 将 要 使 用 的 
Web 服务 器 ， 然 后 单 击 对 话 框 中 的 “Next” 按 钮 ， 系 统 出 现 如 图 1.13 所 示 的 对 话 框 。 


人 @ 在 如 图 1.13 所 示 对 话 框 中 填写 Tomcat 安装 的 详细 情况 ， 包 括 Tomcat 的 安装 路 径 、JRE 的 安 
装 路 径 等 。 填 写 完成 后 单 击 对 话 框 下 面 的 “Finish” 按 钮 即 可 。 


图 1.13 ”设置 Tomcat 的 安装 详情 
建立 一 个 Web 应 用 请 按 如 下 步骤 进行 。 


人 单 击 Eclipse 的 “File” 菜单 ,将 光标 移 到 “New” 菜单 项 上 , 在 出 现 的 子 菜单 中 单 击 “Other...” 
菜单 项 ， 弹 出 如 图 1.14 所 示 的 对 话 框 。 


@ 在 如 图 1.14 所 示 的 对 话 框 中 选中 “Dynamic Web Project” 节 点 ， 然 后 单 击 “Next” 按 钮 ， 将 
弹出 如 图 1.15 所 示 的 对 话 框 。 
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图 1.14 新 建 Web 项 目 


图 1.15 建立 Web 应 用 
@ 在 如 图 1.15 所 示 对 话 框 中 的 “Project Name” 文 本 框 中 输入 项 目 名 ， 并 选择 使 用 Servlet 3.0 的 
规范 ， 最 后 单 击 “Finish” 按 钮 ， 即 可 建立 一 个 Web 应 用 。 
人 @ 单 击 Eclipse 左边 项 目 导航 树 上 “WebContent 一 New 一 JSP File” 菜单 项 ， 如 图 1.16 所 示 ， 该 
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菜单 项 用 于 创建 一 个 JSP 页 面 。 
Eclispe 弹出 如 图 1.17 所 示 的 创建 JSP 页 面 的 对 话 框 。 


图 1.16 新 建 JSP 页 面 图 1.17 填写 JSP 页 面 文件 名 


他 在 图 1.17 所 示 对 话 框 中 填写 JSP 页 面 的 文件 名 之 后 ， 单 击 “Next” 按 钮 ， 系 统 弹出 如 图 1.18 
所 示 的 选择 JSP 页 面 模板 的 对 话 框 。 

人 @ 在 如 图 1.18 所 示 的 对 话 框 中 选择 需要 使 用 的 JSP 页 面 模板 ， 如 果 不 想 使 用 JSP 页 面 模板 ， 则 
去 掉 “Use JSP Template” 复 选 框 ， 单 击 “Finish” 按 钮 ， 即 创建 了 一 个 JSP 页 面 。 

人 @ 编辑 JSP 页 面 。Eclipse 提供 了 一 个 简单 的 “所 见 即 所 得 ”的 JSP 编辑 环境 ， 开 发 者 可 以 通过 
该 环境 来 开发 JSP 页 面 。 如 果 要 美化 该 JSP 页 面 ， 可 能 需要 借助 于 其 他 专业 工具 。 

人 @ Web 应 用 开发 完成 后 ， 应 将 Web 应 用 部 署 到 Tomcat 中 进行 测试 。 部 署 Web 应 用 可 通过 单 击 
Eclipse 左边 项 目 导航 树 上 “Run As 一 Run on Server” 菜 单项 ， 如 图 1.19 所 示 。 


Sotoct Jsp Tempbte 


Sct s tomplete na comes ng mp pm 
i Se 
Me 


图 1.18 选择 JSP 页 面 模板 图 1.19 部 署 Web 应 用 和 启动 Web 服务 器 菜单 项 


Eclipse 弹出 如 图 1.20 所 示 的 对 话 框 。 

人 @ 在 图 1.20 中 选择 将 项 目 部 署 到 已 配置 的 服务 器 上 , 并 选中 下 面 的 Tomcat v7.0 Server at localhost 
(这 是 我 们 刚才 配置 的 Web 服务 器 )， 然 后 单 击 “Next” 按 钮 ， 系 统 将 弹出 如 图 1.21 所 示 的 对 话 框 。 

人 @ 在 图 1.21 所 示 对 话 框 中 将 需要 部 署 的 Web 项 目 移动 到 右边 列表 框 内 ， 然 后 单 击 “Finish” 按 
钮 ，Web 项 目 部 署 完成 。 
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人 @ 返回 Eclipse 下 方 的 “Servers” 面 板 ， 右 键 单 击 该 面板 中 “Tomcat v7.0 Server at localhost” 节 
点 ， 在 弹出 的 快捷 菜单 中 单 击 “Start” 菜 单项 即 可 启动 指定 Web 服务 器 。 

当 Web 服务 器 启动 之 后 ， 在 浏览 器 中 输入 刚 编辑 的 JSP 页 面 的 URL， 即 可 访问 到 该 JSP 页 的 
内 容 。 


| 


TITTTTTT Web mad 


图 1.20 部 署 Web 项 目 图 1.21 选择 部 署 Web 项 目 


经 过 上 面 的 步骤 , 我们 开发 并 部 署 了 一 个 简单 的 Web 应 用 , 但 该 Web 应 用 中 仅 有 一 个 简单 的 JSP 
页 面 ， 如 果 需 要 编写 更 复杂 的 JSP 页 面 ， 则 需要 学 习 本 书 第 2 章 的 内 容 。 


>>1.4.6 导入 Eclipse 项 目 


在 很 多 时 候 , 我 们 都 需要 向 Eclipse 中 导入 其 他 项 目 , 实际 开发 中 可 能 需要 导入 其 他 开发 者 提供 的 
Eclipse 项 目 ， 学 习 过 程 中 可 能 需要 导入 网 络 、 书 籍 中 提供 的 示例 项 目 。 

向 Eclipse 工具 中 导入 一 个 Eclipse 项 目 比较 简单 ， 只 需 按 如 下 步骤 进行 即 可 。 

人 单 击 “File” 菜单 的 “Import..” 菜 单项 ，Eclipse 将 弹出 如 图 1.22 所 示 的 对 话 框 。 

@ 在 如 图 1.22 所 示 的 对 话 框 中 选中 “Existing Projects into Workspace” 节 点 ， 单 击 “Next” 按钮 ， 
系统 将 弹出 如 图 1.23 所 示 的 对 话 框 。 


图 1.22 导入 Eclipse 项 目 图 1.23 选择 需要 导入 的 项 目 
在 如 图 1.23 所 示 对 话 框 的 “Select root directory ”文本 框 内 输入 Eclipse 项 目的 保存 位 置 ， 也 可 通 
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过 后 面 的 “Browse..…” 按 钮 来 选择 Eclipse 项 目的 保存 位 置 。 输 入 完成 后 ， 将 看 到 “Projects” 文 本 域内 
列 出 了 所 有 可 导入 的 项 目 ， 色 选 需要 导入 的 项 目 后 单 击 “Finish” 按 钮 即 可 。 


>>1.4.7 导入 非 Eclipse 项 目 


有 些 时 候 ， 我 们 也 必须 将 一 些 非 Eclipse 项 目 导入 Eclipse 工具 中 ， 因 为 我 们 不 能 要 求 所 有 开发 者 
都 使 用 Eclipse 工具 。 

由 于 不 同 IDE 工具 对 项 目 文件 的 组 织 方式 存在 一 些 差异 ， 所 以 向 Eclipse 中 导入 非 Eclipse 项 目 相 
对 复杂 一 点 。 向 Eclipse 中 导入 非 Eclipse 项 目 应 该 采用 可 分 别 导 入 指定 文件 的 方式 。 

向 Eclipse 中 导入 指定 文件 请 按 如 下 步骤 进行 。 

人 新 建 一 个 普通 的 Eclipse 项 目 。 

人 单 击 “File” 菜单 的 “Import..” 菜 单项 ，Eclipse 将 弹出 如 图 1.22 所 示 的 对 话 框 。 

他 在 如 图 1.22 所 示 的 对 话 框 中 选中 “File System ”节点 ， 单 击 “Next” 按 钮 ， 系 统 将 弹出 如 图 
1.24 所 示 的 对 话 框 。 


图 1.24 向 Eclipse 中 导入 文件 


在 如 图 1.24 所 示 对 话 框 的 左边 有 三 个 按钮 ， 它 们 的 作用 分 别 是 : 

> “Filter Types…: 根据 指定 文件 后 缀 来 导入 文件 。 

> ”Select Allt 导入 指定 目录 下 的 所 有 文件 。 

> ”Deselect All: 取消 全 部 选择 。 

人 @ 按 图 1.24 所 示 分 别 输入 需要 导入 文件 的 路 径 ,选中 需要 导入 的 文件 ,并 输入 需要 导入 到 Eclipse 
项 目的 哪个 目录 下 ， 然 后 单 击 “Finish” 按 钮 ， 即 可 将 指定 文件 导入 Eclipse 项 目 中 。 


提示 : 
不 要 指望 将 一 个 非 Eclipse 项 目 整 体 导 入 Eclipse 工具 中 ! 毕竟 ， 不 同 IDE 工具 对 项 目 
文件 的 组 织 形式 完全 不 同 ! 如 果 我 们 需要 导入 非 Eclipse 项 目 , 必须 采用 导入 文件 的 方式 依 | 


将 其 他 项 目 导入 Eclipse 中 还 有 一 种 方式 : 直接 进入 需要 被 导入 的 项 目 路 径 下 , 将 相应 的 文件 复制 
到 Eclipse 项 目的 相应 路 径 下 即 可 。 
以 Eclipse 的 一 个 Web 项 目 为 例 ， 将 另 一 个 Web 项 目 导 入 Eclipse 下 只 要 如 下 3 步 即 可 。 
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将 其 他 Web 项 目的 所 有 Java 源 文件 通常 位 于 sre 目录 下 ) 所 在 的 路 径 的 全 部 内 容 一 起 复制 
到 Eclipse Web 项 目的 src 目录 下 。 
@ 将 其 他 Web 项 目 JSP 页 面 、WEB-INF 整个 目录 一 起 复制 到 Eclipse Web 尖 目的 -WebContent 


目录 下 。 
全 返回 Eclipse 主 界面 ， 选 择 Eclipse 左边 项 目 导航 树 中 指定 项 目 对 应 的 节点 ， 单 击 F5 键 即 可 。 


1.5 ”Ant 的 安装 和 使 用 


Ant 是 一 种 基于 Java 的 生成 工具 。 从 作用 上 来 看 ， 它 有 些 类 似 于 C 编程 (UNIX 平台 上 使 用 较 多 ) 
中 的 Make 工具 ，C/C++ 项 目 经 常 使 用 Make 工具 来 管理 整个 项 目的 编译 、 生 成 。 

Make 使 用 Shell 命令 来 定义 生成 任务 ， 并 定义 任务 之 间 的 依赖 关系 ， 以 便 它 们 总 是 以 必需 的 顺序 
来 执行 。 

Make 工具 主要 有 如 下 两 个 缺陷 : 

> ”Make 工具 的 本 质 还 是 依赖 UNIX 平台 的 Shell 语言 ， 所 以 Make 工具 无 法 跨 平台 。 

> ”Make 工具 的 生成 文件 的 格式 比较 严格 ， 容 易 导 致 错误 。 

Ant 工具 是 基于 Java 语言 的 生成 工具 ， 所 以 具有 跨 平台 的 能 力 ， 而 且 Ant 工具 使 用 XML 文件 来 
编写 生成 文件 ， 因 而 具有 更 好 的 适应 性 。 

由 此 可 见 ， Ant 是 Java 世界 的 Make 工具 ， 而 且 这 个 工具 是 跨 平台 的 ， 并 具有 简单 、 易 用 的 特性 。 

由 于 Ant 具有 跨 平 台 的 特性 ， 所 以 编写 Ant 生成 文件 时 可 能 会 失去 一 些 灵活 性 。 为 了 弥补 这 个 不 
足 ，Ant 提供 了 一 个 “exec” 核 心 task， 这 个 task 允许 执行 特定 操作 系统 上 的 命令 。 


>》1.5.1 Ant 的 下 载 和 安装 


下 载 和 安装 Ant 请 按 如 下 步骤 进行 。 

人 @ 登录 http://ant.apache.org/bindownload.cgi 站 点 下 载 Ant 最 新 版 ， 笔 者 成 书 之 时 ，Ant 的 最 新 稳 
定 版 是 1.8.1， 建 议 下 载 该 版 本 。 

虽然 Ant 是 基于 Java 的 生成 工具 ， 具 有 平台 无 关 的 特性 ， 但 考虑 到 解压 缩 的 方便 性 ， 通 常 建议 
Windows 平台 下 载 *.zip 压缩 包 ， 而 Linux 平台 则 下 载 .gz 压缩 包 。 

人 将 下 载 到 的 压缩 文件 解压 缩 到 任意 路 径 ， 例 如 ， 笔 者 解压 缩 到 D:\ 根 路 径 下 ， 并 将 Ant 文件 夹 
重 命名 为 Ant181。 解 压缩 后 看 到 如 下 文件 结构 。 
bin: 启动 和 运行 Ant 的 可 执行 性 命令 。 
docs: Ant 工具 的 相关 文档 ， 这 些 文档 对 学 习 使 用 Ant 有 很 大 的 作用 。 
etc: 包含 一 些 样式 单 文件 ， 通 常 无 须 理会 该 目录 下 的 文件 。 
lib: 包含 Ant 的 核心 类 库 ， 以 及 编译 和 运行 Ant 所 依赖 的 第 三 方 类 库 。 
LICENSE 等 说 明 性 文档 。 


v 
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提示 
[ 重 命名 Ant 文件 夹 仅仅 是 为 了 方便 、 简 捷 ， 并 不 是 必需 的 .。 读者 既 可 以 像 笔 者 一 样 重 
命名 该 文件 夹 ， 也 可 以 不 重 命名 该 文件 天 | 


人 @ Ant 的 运行 需要 如 下 两 个 环境 变量 。 

> ”JAVA_HOME: 该 环境 变量 应 指向 JDK 的 安装 路 径 。 如 果 已 经 成 功 安装 了 Tomcat， 则 该 环 
境 变 量 应 该 已 经 是 正确 的 。 

> ANT_HOME: 该 环境 变量 应 指向 Ant 的 安装 路 径 。 

按 前 面 介绍 的 方式 配置 ANT_HOME 环境 变量 。 
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docs、etc 和 ib 这 4 个 文件 夹 . 


提示 : 
Pen 全: Ant 的 安装 路 径 就 是 前 面 释 政 Ant 压缩 文件 的 路 径 ，Ant 安装 路 径 下 应 该 包 仿 bin、 


人 @ Ant 工具 的 关键 命令 就 是 %ANT_HOME%/bin 路 径 下 的 antbat 命令 ， 如 果 读者 希望 操作 系统 

可 以 识别 该 命令 ， 还 应 该 将 %ANT_HOME%/bin 路 径 添加 到 操作 系统 的 PATH 环境 变量 之 中 。 
A 当 我 们 在 命 信行 窗口 、Shell 窗口 输入 一 条 命令 后 ， 操 作 系 统 会 到 PATH 环境 灾 量 所 指 1 
定 的 系列 路 径 中 去 搜索 ， 如 果 找 到 了 该 命令 所 对 应 的 可 执行 性 程序 ， 即 运行 该 命令 ， 否 则 | 
| ”将 提示 找 不 到 命令 。 如 果 读者 不 嫌 麻 烦 ， 愿 意 每 次 都 答 入 %ANT_HOME%/bin/ant.bat 的 全 : 
路 径 来 运行 Ant 工具 ， 则 无 须 将 %ANT_HOME%/bin 路 径 添加 到 PATH 环境 变量 之 中 。 ”| 


经 过 上 面 4 个 步骤 ，Ant 安装 成 功 ， 读 者 可 以 启动 命令 行 窗口 ， 输 入 如 下 ant.bat 命令 (如 果 读 者 
未 将 %ANT_HOME%/bin 路 径 添加 到 PATH 环境 变量 之 中 ， 则 应 该 输入 %ANT_HOME%/bin/ant.bat)， 
则 应 该 看 到 如 下 提示 : 


Buildfile: build.xml does not exist! 
Build failed 


如 果 看 到 上 面 的 提示 信息 ， 则 表明 Ant 安装 成 功 。 
》>》>1.5.2 使 用 Ant 工具 


使 用 Ant 非常 简单 ， 当 正确 地 安装 Ant 后 ， 只 要 输入 ant 或 antbat 即 可 。 

如 果 运 行 ant 命令 时 没有 指定 任何 参数 ，Ant 会 在 当前 目录 下 搜索 build.xml 文件 。 如 果 找 到 了 就 
以 该 文件 作为 生成 文件 ， 并 执行 默认 的 target。 

提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … i 
关于 生成 文件 和 target 的 概念 请 参看 1.5.3 节 内 容 ， 关 于 生成 文件 中 默认 target 的 介绍 
也 请 参看 1.5.3 节 内 容 。 

如 果 运 行 时 使 用 -find 或 者 -s 选项 (这 两 个 选项 的 作用 完全 相同 ), Ant 就 会 到 上 级 目录 中 搜索 生成 
文件 ， 直 至 到 达 文件 系统 的 根 路 径 。 

要 想 让 Ant 使 用 其 他 生成 文件 ， 可 以 用 -buildfile < 生成 文件 > 选项 ， 其 中 -buildfile 可 以 使 用 -file 或 
-来 代替 ， 这 三 个 选项 的 作用 完全 一 样 。 例 如 如 下 命令 : 


ant -~ a.xml // 显 式 指定 使 用 a.xml 作为 生成 文件 
ant -file b.xnl // 显 式 指定 使 用 b.xml 作为 生成 文件 


如 果 希 望 Ant 运行 时 只 输出 少量 的 必要 信息 ， 则 可 使 用 -quiet 或 -q 选项 ， 如 果 希 望 Ant 运行 时 输 
出 更 多 的 提示 信息 ， 则 可 使 用 -verbose 或 -v 选项 。 

如 果 希 望 Ant 运行 时 将 提示 信息 输出 到 指定 文件 ， 而 不 是 直接 输出 到 控制 台 ， 则 可 使 用 -logfile 
<file> 或 -1 <file> 选 项 。 例 如 如 下 命令 : 

ant -verbose -1 a.log // 运 行 Ant 时 生成 更 多 的 提示 信息 ， 并 将 提示 信息 输出 到 a. 12g 文件 中 

除 此 之 外 ，Ant 还 允许 运行 时 指定 一 些 属性 来 覆盖 生成 文件 中 指定 的 属性 值 〈 使 用 Property task 
来 指定 ), 例如 使 用 -D<property>=<value>, 则 此 处 指定 的 value 将 会 覆盖 生成 文件 中 property 的 属性 值 。 
例如 如 下 命令 : 

ant -Dbook=spring2 // 该 命令 将 会 禾苗 生成 文件 中 的 book 属性 值 

通过 该 方法 可 以 将 操作 系统 的 环境 变量 值 传 入 生成 文件 ， 例 如 ， 我 们 在 运行 Ant 工具 时 使 用 如 下 
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命令 : 

ant -Denvi=%ANT HOMES 

上 面 命令 中 粗 体 字 代 码 用 于 向 生成 文件 中 传 入 一 个 env1 属性 , 而 该 属性 的 值 并 没有 直接 给 出 , 而 
是 用 %ANT_HOME% 的 形式 给 出 一 一 这 是 Windows 下 访问 环境 变量 的 形式 。 通 过 这 种 方式 ， 就 可 以 
将 Windows 环境 变量 值 传 入 生成 文件 了 , 如 果 希 望 在 生成 文件 中 访问 到 该 环境 变量 的 值 , 使 用 $env1 
即 可 。 

上 面 命令 在 Linux 平台 上 则 改 为 ，ant -Denvl=SANT_HOME，Linux 下 以 $ 符 来 访问 环境 变量 。 

在 默认 情况 下 ，Ant 将 运行 生成 文件 里 指定 的 默认 target， 如 果 希 望 运行 Ant 时 显 式 指定 希望 运行 
的 target， 则 可 采用 如 下 命令 格式 : 

ant [target [target2 [target3] ...]] 

实际 上 , 如 果 读 者 需要 获取 ant 命令 的 更 多 详细 情况 , 直接 使 用 ant -help 选项 即 可 。 运行 ant -help， 
将 看 到 如 图 1.25 所 示 的 提示 信息 。 


Docuaents and Settings\yeeku. WONDER>ant ~help 
nt [options] [target [target? Ttarget3] ...]] 
tions 

-help, -h print this gessage 
-projecthelp，- print project help information 


-version print the version information and exit 

-diagnostics print information that might be helpful to 
diagnose or report problems. 

-quiet, ~-q be extra quiet 

verbose, be extra verbose 

-debug, ~d print debugging inforaation 

-emacs, -e produce logging information without adornments 

lib cpath> specifies a path to search for jars and classes 

-logfile file: se given file for log 


-1 xftley 
-logger classnage> the class which is to perforn logging 
-listener Cclassname> add an instance of class as a project listener 
-noinput do not mllow interactive input 
-buildfile <file> use given buildfile 
-ftle .<file> pm 
-ff file> 过 


图 1.25 Ant 命令 用 法 


>>1.5.3 定义 生成 文件 


实际 上 ， 使 用 Ant 的 关键 就 是 编写 生成 文件 ， 生 成 文件 定义 了 该 项 目的 各 个 生成 任务 以 target 
来 表示 ， 每 个 target 表示 一 个 生成 任务 )， 并 定义 生成 任务 之 间 的 依赖 关系 。 

Ant 生成 文件 的 默认 名 为 build.xml， 也 可 以 取 其 他 的 名 字 。 但 如 果 为 该 生成 文件 起 其 他 名 字 ， 将 
意味 着 要 将 这 个 文件 名 作为 参数 传 给 Ant 工具 。 生 成 文件 可 以 放 在 项 目的 任何 位 置 ， 但 通常 做 法 是 放 
在 项 目的 顶层 目录 中 ， 这 样 有 利于 保持 项 目的 简洁 和 清晰 。 

下 面 是 一 个 典型 的 项 目 层次 结构 。 

<project>: 该 文件 夹 存 放 了 整个 项 目的 全 部 资源 

| 一 sre: 存放 源 文件 、 各 种 配置 文件 的 文件 夹 

| 一 elasses: 存放 编译 后 的 class 文件 的 文件 夹 

| 一 lib; 存放 第 三 方 JAR 包 的 文件 夹 

| 一 dist: 存放 项 目 打包 、 项 目 发 布 文 件 的 文件 夹 
| 一 build.xml: Ant 生成 文件 

Ant 生成 文件 的 根 元 素 是 <project.…/>， 每 个 项 目下 可 以 定义 多 个 生成 目标 ， 每 个 生成 目标 以 一 个 
<target..… 户 元 素来 定义 ， 它 是 <project... 户 元 素 的 子 元 素 。 

project 元 素 可 以 有 多 个 属性 ，project 元 素 的 常见 属性 的 含义 如 下 。 
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default: 指定 默认 target， 这 个 属性 是 必需 的 。 如 果 运 行 ant bat 命令 时 没有 显 式 指定 想 执行 
的 target，Ant 将 执行 该 target。 

> ”basedir， 指 定 项 目的 基准 路 径 ， 生 成 文件 中 的 其 他 相对 路 径 都 是 基于 该 路 径 的 。 

> name: 指定 项 目 名 ， 该 属性 仅 指定 一 个 名 字 ， 对 编译 、 生 成 项 目 没有 太 大 的 实际 作用 。 

> ”description: 指定 项 目的 描述 信息 ， 对 编译 、 生 成 项 目 没有 太 大 的 实际 作用 。 

如 下 面 代码 片段 所 示 : 

<?xml version="1.0" encoding="GBK"?> 

<!-- 下 面 的 配置 信息 指定 基准 路 径 是 当前 路 径 ， 默 认 target 为 空 --> 

‘<project name="struts2" description="demo" basedir="." default="" > 

</project> 

每 个 生成 目标 对 应 一 个 <target.. 人 > 元 素 。 

> name: 指定 该 target 的 名 称 ， 该 属性 是 必需 的 。 该 属性 非常 重要 ， 当 希望 Ant 运行 指定 的 
生成 目标 时 ， 就 是 根据 该 name 来 确定 生成 目标 的 。 所 以 我 们 可 以 得 出 一 个 结论 : 同一 个 生 
成 文件 里 不 能 有 两 个 同名 的 target 元 素 。 

depends: 该 属性 可 指定 一 个 或 多 个 target 名 ， 表 示 运 行 该 target 之 前 应 先 运行 该 depends 
属性 所 指定 的 一 个 或 多 个 target。 

> ”if 该 属性 指定 一 个 属性 名 ， 用 属性 表示 仅 当 设置 了 该 属性 时 才 执 行 此 target。 

> ”unless: 该 属性 指定 一 个 属性 名 ， 用 属性 表示 仅 当 没有 设置 该 属性 时 才 执 行 此 target。 

> ”description: 指定 该 target 的 描述 信息 。 

例如 ， 如 下 配置 片段 : 

<!-- 下 面 表示 执行 run target 之 前 ， 必 须 先 执行 compile target --> 


<target name="run" depends="compile"/> 
<!-- 只 有 当 设置 了 Propl li tg target -> 
<target name="exA" ifm 

<!-- 只 要 没有 设置 prop2 属性 ， 可 可 bi 行 exB target 一 -> 
<target name="exB" unl@ss="prop2"/> 


每 个 生成 目标 又 可 能 由 一 个 或 者 多 个 任务 序列 组 成 ， 当 执行 某 个 生成 目标 时 ， 实 际 上 就 是 依次 完 


Vv 


成 该 目标 所 包含 的 全 部 任务 。 每 个 任务 由 一 段 可 执行 的 代码 组 成 。 


定义 任务 的 代码 格式 如 下 : 
<name attributel="valuel" attribute2="value2" ,.. /> 

上 面 的 代码 中 name 是 任务 的 名 称 ,attributeN 和 valueN 用 于 指定 执行 该 任务 所 需 的 属性 名 和 属性 值 。 
简 而 言 之 ，Ant 生成 文件 的 基本 结构 是 project 元 素 里 包含 多 个 target 元 素 ， 而 每 个 target 元 素 里 


包含 多 个 任务 。 


Ant 的 任务 可 以 分 为 如 下 三 类 。 
> ”核心 任务 核心 任务 是 Ant 自 带 的 任务 。 


. 
项 
目 
的 
生 
磺 
文 
件 
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> ”可 选任 务 : 可 选任 务 是 来 自 第 三 方 的 任务 ， 因 此 需要 一 个 附加 
es 的 JAR 文件 。 
> ”用户 自 定义 的 任务 ; 用 户 自 定义 的 任务 是 用 户 自己 开发 的 任务 。 
根据 上 面 的 介绍 , 不 难 发 现 Ant 生成 文件 具有 如 图 1.26 所 示 的 结构 。 
除 此 之 外 ，project 元 素 还 可 拥有 如 下 两 个 重要 的 子 元 素 。 
> ”property: 用 于 定义 一 个 或 多 个 属性 。 
> ”path: 用 于 定义 一 个 或 多 个 文件 和 路 径 。 


1. property 元 素 


d 


图 


26 


126; 轴 于 生成 实 伯 入 鬼 <property. 人 > 元 素 用 于 定义 一 个 或 多 个 属性 ，Ant 生成 文件 中 的 属性 
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类 似 于 编程 语言 中 的 宏 变 量 ， 它 们 都 具有 名 称 和 值 。 与 编程 语言 不 同 的 是 : Ant 生成 文件 中 的 属性 值 
不 可 改变 。 
定义 一 个 属性 最 简单 形式 如 下 : 


<!-- 下 面 代码 定义 了 一 个 名 为 builddir 的 属性 ， 其 值 为 ad --> 
<property name="builddir" value="dd"/> 


如 果 需 要 获取 属性 值 ， 则 使 用 ${propName} 的 形式 。 例 如 ， 如 下 代码 即 可 获取 builddir 属性 值 : 


// 输 出 builddir 属性 值 
${ builddir } 


由 此 可 见 : $ 符 在 Ant 生成 文件 中 具有 特殊 意义 ， 如 果 我 们 希望 Ant 将 生成 文件 中 的 $ 当 成 普通 字 


符 ， 则 应 该 使 用 $$。 例 如 如 下 配置 片段 : 
<echo>$${builddir}=${builddir}</echo> 


上 面 的 代码 中 的 $$ {builddir} 不 会 获取 builddir 属性 值 ， 而 ${builddir} 才 会 获取 builddir 属性 值 。 执 
行 上 面 任务 将 会 输出 : 


lecho] ${builddir}=dd 


实际 上 ，property 元 素 可 以 接受 如 下 几 个 常用 属性 。 

name: 指定 需要 设置 的 属性 名 。 

value: 指定 需要 设置 的 属性 值 。 

resource: 指定 属性 文件 的 资源 名 称 ，Ant 将 负责 从 属性 文件 中 读 取 属 性 名 和 属性 值 。 

file: 指定 属性 文件 的 文件 名 ，Ant 将 负责 从 属性 文件 中 读 取 属性 名 和 属性 值 。 

url: 指定 属性 文件 的 URL 地 址 ，Ant 将 负责 从 属性 文件 中 读 取 属性 名 和 属性 值 。 
environment: 用 于 指定 系统 环境 变量 的 前 缀 。 通 过 这 种 方式 允许 Ant 访问 系统 环境 变量 。 
classpath: 指定 搜索 属性 文件 的 文件 和 路 径 集 。 

classpathref: 指定 搜索 属性 文件 的 文件 和 路 径 集 引 用 ,该 属性 并 不 是 直接 给 出 系列 文件 或 路 
径 ， 而 是 给 定 文件 和 路 径 集 引用 。 


Vvvvvvvyv 


下 面 给 出 几 个 使 用 property 元 素 的 例子 : 
<!-- 指定 读 取 foo.properties 属性 文件 中 的 属性 名 和 属性 值 一 > 
<property file="fo0.properties"/> 

下 面 从 网 络 中 读 取 属性 名 和 属性 值 : 
<!-- 指定 从 指定 URL 处 读 取 属 性 名 和 属性 值 --> 
<property url="http://w™w.craryit.org/props/fo0.properties"/> 

property 元 素 所 读 取 的 属性 文件 就 是 普通 的 属性 文件 ， 该 文件 的 内 容 由 系列 的 name=value 组 成 ， 

如 下 面 的 配置 片段 所 示 : 


author=Yeeku.H. Lee 
book=Light Weight Java EE 
price=56 


除 此 之 外 ,通过 property 元 素 可 以 让 Ant 生成 文件 访问 到 操作 系统 的 环境 变量 值 , 例如 如 下 代码 : 


<!-- 定义 访问 操作 系统 环境 变量 的 前 组 是 env -> 
<property environment="env"/> 
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定义 了 上 面 的 property 元 素 之 后 ， 下 面 就 可 以 在 Ant 生成 文件 中 通过 如 下 形式 来 访问 操作 系统 环 
境 变量 : 


<!-- 输出 JAVA_HOME 环境 变量 --> 
<echo>$ {env. JAVA_HOME}</echo> 


在 笔者 的 机 器 上 运行 上 面 任务 ， 即 可 看 到 输出 ; [echo] D:Javaljidk1.6.0_22， 这 就 是 笔者 机 器 上 
JAVA_HOME 环境 变量 的 值 。 

2. path 元 素 和 classpath 元 素 

通常 我 们 需要 使 用 Ant 编译 、 运 行 Java 文件 ， 编 译 、 运 行 Java 文件 时 常常 需要 引用 第 三 方 JAR 
包 ， 这 就 需要 使 用 <classpath... 户 元 素 了 。<path... 人 > 元 素 和 <classpath... 人 > 元 素 都 用 于 定义 文件 和 路 径 集 ， 
区 别 是 classpath 元 素 通常 作为 其 他 任务 的 子 元 素 ， 既 可 引用 已 有 的 文件 和 目录 集 ， 也 可 临时 定义 一 个 
文件 和 目录 集 ， 而 <path.… 人 > 元 素 则 作为 <project.. 人 > 元 素 的 子 元 素 ， 用 于 定义 一 个 独立 的 、 有 名 称 的 文 
件 和 目录 集 ， 用 于 被 引用 。 

因为 <path.. 人 > 和 <classpath.. 人 > 都 用 于 文件 和 目录 集 , 所 以 也 将 <path... 人 > 和 <classpath... 人 > 元 素 定 义 的 
内 容 称 为 Path-like Structures〈 似 目录 结构 )。 

<path.… 人 > 和 <classpath... 包 元 素 都 用 于 收集 系列 的 文件 和 目录 集 ， 这 两 个 元 素 都 可 接受 如 下 子 元 素 。 

> ”pathelement: 用 于 指定 一 个 或 多 个 目录 。 

> dirset， 采用 模式 字符 串 的 方式 指定 系列 目录 。 

> ”fileset 采用 模式 字符 串 的 方式 指定 系列 文件 。 

> “filelist; 采用 直接 列 出 系列 文件 名 的 方式 指定 系列 文件 。 

pathelement 元 素 用 于 指定 一 个 或 多 个 目录 ，pathelement 元 素 可 以 指定 如 下 两 个 属性 中 的 一 个 

> ”path: 指定 一 个 或 者 多 个 目录 (或 者 JAR 文件 ) ， 多 个 目录 或 JAR 文件 之 间 以 英文 冒号 (:) 

或 英文 分 号 〈;) 分 开 。 
> location: 指定 一 个 目录 和 JAR 文件 。 


如 下 面 配置 片段 所 

<!-- 定义 /path/to/file2.jar、/path/to/class2 和 /path/to/class3 所 组 成 的 目录 集 --> 

<pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3"/> 

<!-- 定义 由 1ib/helper.jar 单个 文件 对 应 的 目录 --> 

<pathelement location="lib/helper.jar"/> 

如 果 需 要 指定 多 个 目录 集 ， 则 应 该 使 用 <dirset.. 人 > 元 素 ， 该 元 素 需要 一 个 dir 属性 ，dir 属性 指定 该 
目录 集 的 根 路 径 。 除 此 之 外 ，dirset 还 可 以 使 用 <include.…. 人 > 和 <exclude... 人 > 两 个 子 元 素来 指定 包含 和 不 
包含 哪些 目录 ， 如 下 面 的 配置 片段 所 示 : 


<!-- 指定 该 目录 集 的 根 路 径 是 build 目录 --> 
<dirset dir="build"> SA > Yd 
<!-- 指定 包含 apps 目录 下 的 所 有 classes 目录 --> 
<include name="apps/**/classes"/> 
<!-- 指定 排除 目录 名 中 有 Test 的 目录 一 > a 
<exclude name="apps/**/*Test*"/> ” 
</dirset> 


上 面 的 配置 文件 代表 build/apps 目录 下 ， 所 有 名 为 classes 且 文 件 名 不 包含 Test 子 串 的 目录 。 

如 果 希 望 配置 多 个 文件 ， 则 可 用 <fileset... 伺 或 者 <filelist.. 人 > 元 素 ， 通 常 <fileset.. 人 > 使 用 模式 字符 串 
来 匹配 文件 集 ， 而 <filelist..… 户 则 通过 列 出 文件 名 的 方式 来 指定 文件 集 。 

<filelist.… 记 元素 需要 指定 如 下 两 个 属性 。 
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> ”dir: 指定 文件 集 里 多 个 文件 所 在 的 基准 路 径 ， 这 是 一 个 必需 的 属性 。 
> ”files， 多 个 文件 名 列表 ， 多 个 文件 名 之 间 以 英文 逗号 〈,) 或 空白 隔 开 。 
如 下 面 的 示例 配置 片段 所 示 : 


<!-- 配置 src/foo.xml 和 src/bar.xml 文件 组 成 的 文件 集 -> 
<filelist id="docfiles" dir="src" files="foo.xml,bar.xml"/> 


提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 
“几乎 所 有 的 Ant 元 素 都 可 以 指定 两 个 属性 : 这 和 refid， 其 中 这 用 于 为 该 元 素 指定 一 

唯一 标识 ， 而 refid 用 于 指定 引用 另 一 个 元 素 。 例如 下 面 的 filelist 配置 : 
| <filelist refid="docfiles"/>, 该 filelist 元 素 所 包含 的 文件 集 和 前 面 docfiles 文件 集 里 包含 | 


实际 上 ，<filelist.…/> 还 允许 使 用 多 个 <file.…/> 子 元 素来 指定 文件 列表 ， 如 下 面 的 配置 片段 所 示 : 
<filelist id="docfiles" dir="${doc.src}"> 

<!-- 通过 两 个 file 下头 作 兴 各 各 浊 注 files 属性 指定 的 效果 完全 一 样 --> 

<file name="foo ,xml"/> 

<file name="bar.xml"/> 
</filelist> 


<fileset../> 元 素 可 指定 如 下 两 个 属性 。 

> dir: 指定 文件 集 里 多 个 文件 所 在 的 基准 路 径 ， 这 是 一 个 必需 的 属性 。 

> ”casesensitive: 指定 是 否 区 分 大 小 写 ， 默 认 区 分 大 小 写 。 

除 此 之 外 ，<fileset... 人 > 元 素 还 可 以 使 用 <include.. 人 > 和 <exclude.. 人 > 两 个 子 元 素来 指定 包含 和 不 包含 
哪些 文件 ， 如 下 面 的 配置 片段 所 示 : 


<!-- 定义 src 路 径 下 的 文件 集 --> 
<fileset dir="sro" casesensitive="yes"> 
<!-- 包含 所 有 * .java 文件 --> 


<exclude name="**/*Test*"/> 
</fileset> 


掌握 了 <pathelement..…/>、<dirset..…/>、<filelist..…> 和 <fileset..… 户 四 个 元 素 的 用 法 之 后 ， 我 们 就 可 以 
使 用 <path.… 记 或 者 <classpath... 人 > 将 它们 组 合 在 一 起 使 用 了 ， 如 下 面 的 配置 片段 所 示 ; 


<path id="classpath"> 
<!-- 定义 classpath 属性 值 所 代表 的 路 径 -> 
<pathelement path="${classpath}"/> 
<!-- 定义 1ib 路 径 下 的 所 有 *.jar 文件 --> 
<fileset dir="lib"> 
<include name="**/*.jar"/> 
</fileset> 
<!-- 定义 classes 路 径 --> 
<pathelement location="classes"/> 
<!-- 定义 build/apps 路 径 下 所 有 classes 路 径 --> 
<dirset dir="build"> 
<include name="apps/**/classes"/> 
<exclude name="apps/**/*Test*"/> 
</dirset> 
<!-- 定义 res 路 径 下 的 a.properties 和 b.xml 文件 --> 
<filelist dir="res" files="a.properties,b.xml"/> 
</path> 


>》>1.5.4 Ant 的 任务 (task ) 


到 目前 为 止 ,我 们 已 经 掌握 了 Ant 生成 文件 的 基本 结构 ,以 及 <project .人 >、<target./>、<property . 记 
等 元 素 的 配置 方式 。 而 <target .人 元素 的 核心 就 是 task， 即 每 个 <target .人 > 由 一 个 或 多 个 task 组 成 。 
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Ant 提供 了 大 量 的 核心 task 和 可 选 ask， 除 此 之 外 ，Ant 还 允许 用 户 定义 自己 的 task， 这 大 大 扩展 
了 Ant 的 功能 。 
本 书 由 于 篇 幅 关 系 ， 所 以 不 可 能 详细 介绍 Ant 所 有 的 核心 task 和 可 选 ask， 本 书 将 会 简要 介绍 一 
些 常用 的 核心 task。 
> javac: 用 于 编译 一 个 或 多 个 Java 源 文件 ， 通 常 需要 srcdir 和 destdir 两 个 属性 ， 用 于 指定 
Java 源 文件 的 位 置 和 编译 后 class 文件 的 保存 位 置 。 

> java: 用 于 运行 某 个 Java 类 ， 通 常 需要 classname 属性 ， 用 于 指定 需要 运行 哪个 类 。 

> jar: 用 于 生成 JAR 包 ， 通 常 需要 指定 destfile 属性 ， 用 于 指定 所 创建 JAR 包 的 文件 名 。 除 
此 之 外 ， 通 常 还 应 指定 一 个 文件 集 ， 表 明 需 要 将 哪些 文件 打包 到 JAR 包 里 。 

> ”sql: 用 于 执行 一 条 或 多 条 SQL 语句 ， 通 常 需要 driver、url、userid 和 password 等 属性 ， 用 
于 指定 连接 数据 库 的 驱动 类 、 数 据 库 URL、 用 户 名 和 密码 等 ， 还 可 以 通过 src 来 指定 需要 指 
定 的 SQL 脚本 文件 ， 或 者 直接 使 用 文本 内 容 的 方式 指定 SQL 脚本 字符 串 。 
echo: 输出 某 个 字符 串 。 
exec: 执行 操作 系统 的 特定 命令 ， 通 常 需要 executable 属性 ， 用 于 指定 想 执行 的 命令 。 
copy: 用 于 复制 文件 或 路 径 。 
delete: 用 于 删除 文件 或 路 径 。 
mkdir。 用 于 创建 文件 夹 。 
move: 用 户 移动 文件 和 路 径 。 

%ANT_HOME%/docs/manual/CoreTasks 路 径 下 包含 了 Ant 所 有 核心 task 的 详细 介绍 ， 而 
%ANT_HOME%/docs/manual/OptionalTasks 路 径 下 包含 了 Ant 所 有 可 选 task 的 详细 介绍 。 读 者 可 以 参 
考 这 些 文档 来 了 解 各 task 所 支持 的 属性 和 选项 。 

下 面 定义 了 一 份 简单 的 生成 文件 ， 这 份 生成 文件 里 包含 了 编译 Java 文件 、 运 行 Java 程序 、 生 成 
JAR 包 等 常用 的 target， 通 过 这 份 文件 就 可 以 非常 方便 地 管理 该 项 目 。 
程序 清单 :codes\01\antQs\build.xml 


<?xml version="1.0" encoding="GBK"?> 


<!-- 定义 生成 文件 的 project 根 元 素 ， 默认 的 target 为 空 --> 
<project name="antQs" basedir="." default=""> 
<!-- 定义 三 个 简单 属性 --> 


bb 


Mw 


<property name="src" value="src"/> 
<property name="classes" "classes"/> 
<property name="dest" 
<!-- 定义 一 组 文件 和 目录 集 --> 
<path id="classpath"> 
<pathelement path="${classes}"/> 
</path> 
<!-- 定义 help target， 用 于 输出 该 生成 文件 的 帮助 信息 --> . 
<target name="help"” description=" 打 印 帮 助 信息 "> 
<echo>help - 打印 帮助 信息 </echo> 
<echo>compile - 编译 Java 源 文件 </echo> 
<echo>run - 运行 程序 </echo> 
<echo>build - 打包 JAR 包 </echo> 
<echo>clean - 清除 所 有 编译 生成 的 文件 </echo> 
</target> 
<!-- 定义 compile target， 用 于 编译 Java 源 文件 --> 
<target name="conpile"” description=" 编 译 Java 源 文件 "> 
<!-- 先 删 除 classes 属性 所 代表 的 文件 夹 ~--> 
<delete dir="${classes}"/> 
<!-- 创建 classes 属性 所 代表 的 文件 夹 -> 
‘<mkdir dir="${classes}"/> 了 
<!-- 编译 Java 文件 ， 编 译 后 的 class 文件 放 到 classes 属性 所 代表 的 文件 夹 内 -> 
<javac destdir="${classes}" debug="true" includeantruntime="yes" 
deprecation="false" optimize="false" failonerror="true"> 
<!-- 指定 需要 编译 的 Java 文件 所 在 的 位 置 --> 


<src path="${src}"/> 
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<!- 指定 编译 Java 文件 所 需要 第 三 方 类 库 所 在 的 位 置 --> 
<classpath refid="classpath"/> 
</javac> 
</target> 
<!-- 定义 run target， 用 于 运行 Java 源 文件 , 
运行 该 target 之 前 会 先 运行 compile target --> 
<target name="run” description=" 运 行程 序 ”depends="compile"> 
<!-- 运行 lee .HelloTest 类 ， 其 中 fork 指定 启动 另 一 个 JVM 来 执行 java 命令 --> 
<java classname="lee.HelloTest" fork="yes" failonerror="true"> 
<classpath refid="classpath"/> 
<!-- 运行 Java 程序 时 传 入 2 个 参数 一 > 
<arg line=" 测 试 参数 1 测试 参数 2"/> 
</java> 
</target> 
<!-- 定义 build target， 用 于 打包 JAR 文件 ， 
运行 该 target 之 前 会 先 运行 compile target --> 
<target name="build"” description=" 打 包 JRR 文件 ”depends="compile"> 
<!--- 先 删除 dest 属性 所 代表 的 文件 夹 -> 
<delete dir="${dest}"/> 
<!-- 创建 dest 属性 所 代表 的 文件 夹 -> 
<mkdir dir="${dest}"/> 
<!-- 指定 将 classes 属性 所 代表 的 文件 夹 下 的 所 有 
*.classes 文件 都 打包 到 app.jar 文件 中 --> 
<jar destfile="${dest}/app.jar" basedir="${classes}" 
includes="**/*.class"> 


<!-- 为 JAR 包 的 清单 文件 添加 属性 --> 
<manifest> 
<attribute name="Main-Class" value="lee.HelloTest"/> 
</manifest> 
</jar> 


</target> 

<!-- 定义 clean target， 用 于 删除 所 有 编译 生成 的 文件 --> 

<target name="clean”description=" 清 除 所 有 编译 生成 的 文件 "> 
<!-- 删除 两 个 目录 ， 目 录 下 的 文件 也 一 并 刷 除 > 
<delete dir="${classes}"/> 
<delete dir="${dest}"/> 

</target> 

</project> 


-大 -注意 :和 本 

上 面 的 生成 文件 中 定义 java task 时 粗 体 字 代 码 指定 了 fol 
也 一 样 ) 这 表明 启动 另 一 个 JVM 进程 来 运行 lee.HelloTest 类 ， 这 个 属性 通常 是 个 陷阱 ! 
如 果 不 指定 该 属性 ， 该 属性 值 默认 是 false， 这 表明 使 用 运行 Ant 的 同一 个 JVM 来 运行 


Java 程序 ， 这 将 导致 随 着 Ant 工具 执行 完成 ， 被 运行 的 Java 程序 也 不 得 不 退出 一 一 这 当 
然 不 是 开发 者 希望 看 到 的 。 


上 面 配置 定义 的 生成 文件 里 包含 了 5 个 target， 这 些 target 分 别 完成 打印 帮助 信息 、 编 译 Java 文 
件 、 运 行 Java 程序 、 打 包 JAR 包 和 清除 编译 中 生成 的 文件 。 执 行 这 些 target 可 使 用 如 下 命令 
> ”ant help: 输出 该 生成 文件 的 帮助 信息 。 
ant compile: 编译 Java 文件 。 
ant run: 运行 lee.HelloTest 类 。 
ant build: 将 classes 路 径 下 所 有 class 文件 打包 成 appjar， 并 放 在 dest 目录 下 。 
ant clean: 删除 classes 和 dest 两 个 目录 。 


1.6 使 用 CVS 进行 协作 开发 


随 着 软件 行业 的 发 展 ， 大 部 分 软件 项 目 都 需要 多 人 协同 开发 。 在 多 人 协同 开发 的 环境 下 ， 版 本 管 
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理 是 一 个 重要 的 问题 ， 没 有 好 的 版 本 控制 和 版 本 管理 ， 大 项 目 可 能 无 法 顺利 进行 。 对 于 需要 许多 基于 
互联 网 的 开源 项 目 ， 版 本 控制 和 版 本 管理 则 更 为 重要 。 即 使 是 对 于 一 个 人 开发 ， 版 本 管理 工作 也 很 有 
益处 ， 它 能 让 您 的 工作 条 理 清晰 ， 避 免 许 多 重复 工作 。 
通常 我 们 会 选择 合适 的 版 本 控制 工具 来 进行 版 本 控制 和 版 本 管理 ， 目 前 流行 的 版 本 控制 工具 有 如 
下 几 个 。 
> CVS (Concurrent Versions System) : 目前 开源 项 目 、Java 项 目 中 应 用 最 广泛 的 版 本 控制 
工具 ， 支 持 UNIX、Linux 和 Windows 等 各 种 平台 。 
> SVN (Subversion) : SVN 是 CVS 的 替代 产物 ，SVN 尽力 维持 CVS 的 用 法 习惯 ， 并 对 原 
来 的 CVS 进行 了 增强 。 
> VSS (Visual Source Safe) : Windows 项 目的 版 本 控制 工具 。 具 有 简单 易 用 、 方 便 高 效 的 
特征 ， 但 与 Windows 操作 系统 及 微软 开发 工具 高 度 集成 。 


不 : 


SVN 发 展 得 非常 不 错 , 现在 越 来 越 多 的 公司 开始 考虑 使 用 SVN 来 作为 项 目 管理 工具 ，， 
而 且 SVN 比 CVS 更 简单 、 易 用 . 如 果 读者 希望 了 解 SVN 的 用 法 ,可 以 参考 本 书 姊妹 篇 (经 | 
| 。 典 Java EE 企业 应 用 实战 》. J 
就 目前 的 情形 来 看 ， 选 择 CVS 是 一 个 明智 的 选择 ， 它 是 国际 上 最 流行 、 最 成 熟 的 版 本 控制 系统 。 
例如 ， 世 界 上 最 大 的 开源 社区 Sourceforge.net 就 是 用 它 来 管理 9 万 多 个 开源 项 目的 。 
使 用 CVS 有 如 下 好 处 : 
> 可 以 非常 方便 地 实现 项 目 代码 的 维护 和 管理 。 
允许 通过 网 络 同步 修改 每 个 开发 者 手中 的 程序 副本 。 
改动 过 程 中 不 会 丢失 项 目 源 代码 的 原始 版 本 。 
可 以 灵活 地 控制 源 代码 版 本 的 各 种 分 支 。 
CVS 是 遵循 GNU 开源 软件 协议 的 软件 ， 具 有 开源 、 免 费 的 特征 。 
CVS 是 基于 TCP/IP 协议 的 C/S 架构 程序 ， 非 常 方便 在 Internet 上 部 署 和 使 用 。 


》>》》>1.6.1 安装 CVS 服务 器 


CVS 是 基于 C/S 架构 的 程序 ，CVS 包括 服务 器 和 客户 端 两 个 部 分 ， 其 中 服务 器 通常 由 CVSNT 充 
当 ， 而 客户 端 则 通常 使 用 WinCvs。 

不 同 平台 上 有 不 同 的 CVS 服务 器 ， 本 书 将 以 Windows 平台 为 例 来 介绍 CVS 服务 器 的 安装 ， 在 
Windows 平台 上 安装 CVS 服务 器 按 如 下 步骤 进行 。 

人 痘 录 http://cvsgui.sourceforge.netdownload.html 站 点 ， 下 载 WinCvs 的 Windows 版 本 ， 笔 者 成 
书 之 时 ，WinCvs 的 最 新 版 本 是 WinCvs 2.0.2.4， 这 也 是 笔者 所 使 用 的 WinCvs 版 本 。 下 载 该 WinCvs 
时 有 如 下 三 个 选项 。 

> ”Download Installer: 下 载 WinCvs 安装 程序 ， 该 安装 程序 里 包含 了 WinCvs 和 CVSNT。 

> ”Download "Bare" Installer， 下载 WinCvs 安装 程序 ， 该 安装 程序 里 只 有 WinCvs。 

> ”Download Source: 下 载 WinCvs 的 源 代码 。 

普通 开发 者 都 应 该 下 载 WinCvs 的 安装 程序 ， 而 不 是 下 载 源 代码 ， 所 以 此 处 下 载 第 一 个 选项 即 可 ， 
该 选项 里 同时 包括 了 CVS 服务 器 和 CVS 客户 端 程序 。 

@ 下 载 成 功 后 应 该 得 到 一 个 WinCvs2_0 2-4.zip 压缩 文件 ， 解 压缩 该 文件 ， 将 得 到 两 个 文件 : 
cvsnt_setup.exe 和 wincvs_setup.exe， 其 中 前 者 是 CVS 的 服务 器 程序 ， 而 后 者 是 CVS 的 客户 端 程序 。 

人 @ 双击 cvsnt_setup.exe 文件 即 开始 安装 CVSNT， 建 议 选择 完全 安装 。 


vvvvyv 
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@ 安装 结束 后 CVSNT 要 求 重启 Windows， 按 要 求 重启 Windows 即 可 。 
人 @ 重启 Windows 后 打开 控制 面板 ， 将 会 在 控制 面板 里 看 到 “CVSNT Server” 图 标 〔 绿 色 小 鱼 图 
标 )， 如 图 1.27 所 示 。 


XRD ma ED SR TRO 


图 1.27 CVSNT 安装 成 功 
We 1.27 所 示 的 “CVS for NT” 图 标 即 表示 CVSNT 安装 成 功 。 


三 汪 ， 将 
由 于 CVSNT 需要 对 外 提供 网 络 服务 ， 而 防火 墙 则 可 能 阻止 该 服务 。 因此 如 果 读 者 


的 机 器 上 安装 了 防火 墙 ， 则 应 该 关闭 防火 墙 或 设置 防火 墙 允许 CVSNT 网 络 。 


为 了 让 远程 客户 端 可 以 访问 CVSNT 服务 器 ,必须 添加 登录 CVSNT 所 需 的 用 户 名 和 密码 , Windows 
平台 下 可 以 直接 指定 Windows 管理 CVSNT 的 账户 和 密码 。 为 了 指定 Windows 管理 CVSNT 的 账户 和 
密码 ， 请 按 如 下 步骤 进行 。 

人 @ 单 击 控制 面板 里 的 “CVS for NT” 图 标 ， 即 启动 一 个 如 图 1.29 所 示 的 CVSNT 窗口 ， 该 窗口 
用 于 管理 CVS 服务 。 

人 单 击 如 图 1.28 所 示 窗 口中 的 Advanced 选项 卡 , 并 勾 选 该 选项 卡 里 的 第 二 个 复 选 框 , 如 图 1.29 
所 示 。 
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图 1.28 CVS 服务 的 控制 窗口 图 1.29 指定 Windows 管理 CVS 的 账户 和 密码 
经 过 以 上 步骤 ， 我 们 就 可 以 通过 为 Windows 添加 一 个 用 户 来 作为 CVS 的 账户 和 密码 。 
为 CVSNT 添加 用 户 名 和 密码 的 步骤 如 下 : 


人 单 击 Windows 控制 面板 里 的 “管理 工具 ”图 标 ， 再 单 击 “ 管 理工 具 ” 里 的 “计算 机 管理 ”图 
标 ， 即 可 看 到 如 图 1.30 所 示 的 界面 。 

人 单 击 左边 导航 树 中 的 “本 地 用 户 和 组 ”节点 ， 再 右键 单 击 “ 用 户 ”节点 ， 在 弹出 的 快捷 菜单 
里 单 击 “ 新 用 户 ” 菜 单项 ， 打 开 如 图 1.31 所 示 的 对 话 框 。 

人 按 图 1.31 所 示 方式 输入 新 增 账户 的 用 户 名 和 密码 ， 就 可 以 为 CVSNT 添加 一 个 新 账户 了 。 

经 过 以 上 步骤 ， 我 们 的 CVSNT 就 多 了 一 个 新 账户 ， 其 用 户 名 为 cvsuser， 密 码 为 123。 
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图 1.30 ”Windows 的 计算 机 管理 程序 图 1.31 新 建 Windows 用 户 
>>1.6.2 配置 CVS 资源 库 


CVS 通常 包括 如 下 术语 。 
> ”Repository (资源 库 ) : CVSNT 下 存放 项 目的 空间 ， 一 个 资源 库 下 可 以 包含 多 个 项 目 。 
> ” CVSROOT: 特定 资源 库 所 对 应 的 标识 字符 串 ， 通 常 由 CVS 服务 器 所 在 的 主机 名 字 、 端 口 、 
连接 CVS 服务 的 用 户 名 和 密码 等 信息 组 成 。 
Module (项 目 ) : Repository 下 存放 的 项 目 ， 每 个 Repository 可 以 包含 多 个 项 目 。 
WorkSpace〔 工 作 空 间 〉: 开发 者 存放 项 目的 本 地 空间 。 
Version: 版 本 。 
Branch: 版 本 分 支 。 
Tag 标签) : 某 个 版 本 的 名 称 。 

配置 CVS 资源 库 请 按 如 下 步骤 进行 。 

人 单 击 控制 面板 里 的 “CVS for NT” 图 标 ， 即 启动 一 个 如 图 1.29 所 示 的 CVSNT 窗口 ， 该 窗口 
用 于 管理 CVS 服务 。 

人 单 击 Repositories 选项 卡 ， 将 进入 资源 库 管理 页 面 ， 看 到 如 图 1.32 所 示 的 窗口 。 

在 如 图 1.32 所 示 窗 口 的 下 方 列 出 三 个 按钮 : Add、Delete 和 Edit， 这 三 个 按钮 分 别 用 于 添加 、 删 
除 和 修改 资源 库 。 

全 单 击 用 于 添加 资源 库 的 “Add” 按 钮 ， 将 弹出 如 图 1.33 所 示 的 对 话 框 。 
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图 1.32 管理 资源 库 的 窗口 图 1.33 添加 资源 库 


人 @ 添加 资源 库 至 少 需要 指定 两 个 属性 : 资源 库 在 文件 系统 里 的 保存 位 置 和 资源 库 名 称 . 按 图 1.33 
所 示 输 入 这 两 个 属性 ， 然 后 单 击 “OK ”按钮 ， 即 可 完成 资源 库 的 添加 。 资 源 库 添加 完成 后 将 返回 如 图 


34 


http://52pdf.taobao.com 


| 


1.32 所 示 的 窗口 ， 将 看 到 如 图 1.32 所 示 的 窗口 里 列 出 了 刚 添加 的 资源 库 。 
>>1.6.3 安装 CVS 客户 端 


对 于 普通 开发 者 而 言 ， 通 常会 选择 使 用 WinCvs 作为 CVS 客户 端 。 在 Windows 下 安装 WinCvs 非 
常 简单 ， 只 要 双击 wincvs_setup.exe 文件 即 开 始 安装 WinCvs， 仍 旧 推 荐 完全 安装 ， 安 装 成 功 后 将 看 到 
Windows 桌面 上 多 出 一 个 WinCvs 图 标 〈 黄 色 小 鱼 图 标 )。 

双击 桌面 上 的 WinCvs 图 标 ， 即 可 启动 CVS 客户 端 程序 ，WinCvs， 单 击 WinCvs 的 “Admin” 菜 
单 ， 再 单 击 该 菜单 里 的 “Preferences.…” 菜 单项 ， 即 可 看 到 如 图 1.35 所 示 的 参数 设置 窗口 。 

单 击 WinCvs 参数 设置 窗口 中 的 “CVS” 选 项 卡 ， 输 入 CVS 客户 端的 HOME 路 径 ， 如 图 1.34 
所 示 。 

再 单 击 WinCvs 参数 设置 窗口 中 的 “WinCvs” 选 项 卡 ， 为 WinCvs 选择 合适 的 编辑 器 ， 如 图 1.35 
所 示 。 
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图 1.34 ”WinCvs 的 参数 设置 窗口 


Ee 图 135 中 没有 勾 侈 “External difry 复 过 框 ， 那 是 因为 笔者 的 机 器 上 并 未 安装 文件 内 容 1 
比较 程序 ， 所 以 笔者 打算 使 用 WinCvs 自 带 的 文件 内 容 比较 程序 .如果 读者 安装 了 第 三 方 | 
| 。 文件 内 容 比较 程序 ， 则 可 以 匀 选 “External diff” 复 选 框 ， 并 在 该 复 选 框 后 的 文本 框 内 输入 ， 
文件 内 容 比较 程序 的 路 径 。 1 


经 过 上 面 几 个 步 又， 我 们 就 可 以 使 用 WinCvs 来 连接 CVS 服务 器 了 。 
>>1.6.4 发 布 项 目 到 服务 器 


对 于 多 人 协同 开发 项 目的 情形 ， 总 是 由 某 个 开发 者 先 建立 一 个 项 目 ， 当 项 目 建立 完成 后 会 将 该 项 
目 发 布 到 CVS 服务 器 ， 从 而 允许 其 他 开发 者 来 访问 该 项 目 。 
将 项 目 发 布 到 CVS 服务 器 按 如 下 步 又 进行。 
《人 G 启动 WinCvs 程序 ， 在 WinCvs 左边 的 文件 结构 导航 树 里 浏览 到 需要 发 布 的 项 目 ， 如 图 1.36 
所 示 。 
《人 G 单 击 “Remote" 菜单 的 “Import Module .”， 或 者 在 左边 文件 系统 导航 树 的 项 目 节点 上 单 击 右 
键 ， 在 弹出 的 快捷 菜单 中 选择 “Import Module” 菜 单项。 无 论 哪 一 种 操作 ， 都 会 把 选中 的 目录 及 其 子 
目录 下 所 有 文件 导入 到 CVS 资源 库 。 
二 
‘WinCvs 将 发 布 项 目 称 为 Import Module， 这 是 由 于 CVS 将 项 目 当 成 Module 对 待 ; 而 
将 项 目 发 布 到 服务 器 上 ， 对 应 于 将 本 地 项 目 导 入 CVS 服务 器 。 | 
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图 1.36 选中 需要 发 布 的 项 目 


WinCvs 会 自动 检测 Original Source Code 目录 下 所 有 文件 的 类 型 ， 把 它们 分 成 两 类 : BINARY 和 


TEXT 类 ， 并 要 求 开发 者 确认 ， 如 图 1.37 所 示 。 
可 以 使 用 NotePad、EditPlus 等 文本 编辑 器 打开 的 文件 ， 并 可 以 正常 看 到 文件 内 容 的 文件 就 是 文本 
文件 ， 其 他 文件 一 律 是 二 进 制 文件 。 


| WinCvs 会 自动 区 分 文本 文件 和 二 进 制 文件 ， 但 如 果 WinCvs 判断 错 了 ， 开 发 者 需要 | 
手动 纠正 ,否则 可 能 对 文件 迁 成 损害 .CVS 资源 库 对 二 进 制 文件 和 文本 文件 的 存储 机 制 | 
| 不同， 更 新 机 制 也 不 同 。 


人 @ 如 果 对 WinCvs 所 判断 的 二 进 制 文件 、 文 本 文件 分 类 没有 问题 ， 则 单 击 如 图 1.37 所 示 对 话 框 
下 面 的 “OK ”按钮 ， 系 统 将 出 现 设置 Import 选项 的 对 话 框 ， 如 图 1.38 所 示 。 
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图 1.37 WinCvs 自动 判断 文件 类 型 
i 
-对 - 注 | ， 每 “ee 
在 上 传 任何 项 目 、 提 交 任何 修改 之 前 ， 都 应 该 添加 注释 ， 
说 明 。 这 样 ， 今 后 你 和 你 的 同事 可 通过 这 些 注 释 了 解 项 目 、 修 改 的 相关 信息 ， 这 样 方便 
自己 也 方便 别人 。 


设置 CVS 服务 器 的 信息 ，CVS 服务 器 由 CVSROOT 来 表示 ， 但 我 们 看 到 CVSROOT 文本 框 为 空 ， 可 
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以 通过 单 击 CVS 文本 框 后 的 按钮 来 设置 CVSROOT 信息 , 单 击 该 按钮 将 出 现 如 图 1.39 所 示 的 对 话 框 。 

如 果 需 要 连接 远程 CVS 资源 库 , 我 们 通常 选择 使 用 pserver 协议 , 然后 输入 登录 远程 CVS 资源 库 
的 用 户 名 、 密 码 、 远 程 主机 名 和 端口 等 信息 ， 如 图 1.40 所 示 。 

如 果 CVS 资源 库 与 当前 的 WinCvs 客户 端 处 于 同一 台 机 器 上 ， 则 可 以 选择 使 用 local 协议 ， 使 用 
local 协议 则 只 需 输入 CVS 资源 库 在 本 地 文件 系统 上 的 绝对 地 址 即 可 ， 如 图 1.40 所 示 。 

全 填写 了 合适 的 CVSROOT 信息 后 ， 单 击 如 图 1.39 或 图 1.40 所 示 对 话 框 中 的 “OK” 按 钮 ， 系 
统 返 回 如 图 1.38 所 示 的 对 话 框 , 此 时 将 看 到 该 对 话 框 的 CVSROOT 文本 框 内 包含 了 一 些 内 容 。 单 击 “ 确 
定 ” 按 钮 ，WinCvs 开始 上 传 项 目 。 


图 1.39 设置 pserver 协议 的 CVSROOT 信息 图 1.40 设置 local 协议 的 CVSROOT 信息 
如 果 WinCvs 上 传 项 目 成 功 ， 将 可 以 在 WinCvs 主 界面 的 下 方 看 到 如 图 1.41 所 示 的 提示 信息 。 


"3 


图 1.41 Import Module 成 功 的 提示 信息 
>>1.6.5 从 服务 器 下 载 项 目 


当 其 中 一 个 开发 者 将 项 目 发 布 到 CVS 服务 器 之 后 , 其 他 开发 者 都 可 以 从 CVS 服务 器 下 载 该 项 目 ， 
从 而 可 以 实现 多 人 协同 开发 该 项 目 。 

从 服务 器 下 载 项 目 请 按 如 下 步骤 进行 。 

人 单 击 WinCvs 主 菜 单 的 “Remote” 菜 单 ， 然 后 单 击 该 菜单 里 的 “Checkout Module...” 菜单 项 ， 
或 在 左边 的 文件 系统 导航 树 中 选中 某 个 文件 夹 ， 然 后 右键 单 
击 该 文件 夹 ， 并 在 弹出 的 快捷 菜单 中 单 击 “ Checkout 
Module.….” 菜 单项 ， 系 统 将 出 现 Checkout settings 对 话 框 ， 如 
图 1.42 所 示 。 

全 按 图 1.42 所 示 输 入 Checkout 设置 后 ， 单 击 “ 确 定 ” 
按钮 ，WinCvs 开始 下 载 服务 器 上 的 项 目 。 

@ 如 果 一 切 正常 ， 通 过 上 面 两 个 步骤 就 可 将 CVS 服务 
器 上 的 项 目下 载 到 本 地 磁盘 ， 即 看 到 如 图 1.43 所 示 的 界面 。 

从 图 1.43 中 可 以 看 出 ，WinCvs 界面 里 某 些 文件 夹 图 标 
上 多 了 一 个 黑色 的 小 钧 ， 这 个 黑色 的 小 钩 表明 该 文件 夹 是 受 
CVS 控制 的 文件 夹 。 


ep 


图 1.42 Checkout 设 置 
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图 1.43 从 服务 器 Checkout 项 目 成 功 
>>1.6.6 同步 (Update ) 本 地 文件 


同步 ， 也 叫 Update， 就 是 把 远程 项 目 中 最 新 的 修改 同步 到 本 地 。 在 多 人 协同 工作 的 环境 下 ， 远 程 
项 目 中 的 某 些 文件 可 能 已 经 被 其 他 开发 者 修改 过 了 ，CVS 服务 器 上 是 修改 后 的 最 新 版 本 。 同 步 操作 能 
够 把 最 新 版 本 下 载 到 本 地 ， 从 而 允许 我 们 在 别人 修改 的 最 新 版 本 上 进行 修改 ， 既 可 以 避免 版 本 冲突 ， 
也 可 以 避免 浪费 精力 和 重复 劳动 。 

对 于 多 人 协同 开发 的 环境 ， 通 常 推荐 总 是 “ 先 同步 ， 后 工作 ”， 即 每 次 使 用 WinCvs 开始 工作 前 ， 
都 应 该 先 同步 一 次 ， 从 而 保证 我 们 在 项 目的 最 新 版 本 上 进行 开发 。 

同步 本 地 文件 请 按 如 下 步骤 进行 。 

人 @ 使 用 鼠标 选择 需要 同步 的 文件 和 目录 。 如 果 选 择 一 个 或 多 个 文件 ， 则 表明 仅 同 步 这 些 文件 ; 
如 果 选 择 一 个 或 多 个 目录 ， 则 会 同步 这 些 目 录 下 的 所 有 文件 。 

人 G 执行 同步 可 以 使 用 如 下 三 种 等 效 操作 。 

> ”通过 菜单 操作 :， 单 击 “Modify” 菜 单 的 “Update” 菜 单项 。 

> ”使 用 快捷 键 : Ctrl+U。 

> 单 击 “Update” 工 具 按钮 ， 如 图 1.44 所 示 。 


图 1.44 同步 本 地 文件 
人 @ 单 击 如 图 1.44 所 示 的 同步 按钮 后 ， 将 弹出 一 个 同步 设置 对 话 框 ， 通 常 无 须 更 改 该 对 话 框 的 设 
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稼 ， 直 接 单 击 “ 确 定 ” 按 钮 即 可 。 
@ 同步 完成 ，WinCvs 提示 同步 成 功 。 


>>1.6.7 提交 (Commit ) 修改 


在 前 面 1.6.3 节 我 们 已 经 为 WinCvs 设置 了 默认 的 编辑 器 ， 这 就 允许 我 们 通过 双击 WinCvs 里 某 个 
文件 来 编辑 它 。 

当 我 们 在 文本 编辑 器 中 编辑 了 指定 文件 ， 并 保存 了 修改 之 后 ， 将 可 以 看 到 WinCvs 中 该 文件 图 标 
变 成 红色 ， 这 表明 我 们 需要 把 对 该 文件 所 做 的 修改 提交 给 CVS 服务 器 。 

提交 修改 请 按 如 下 步骤 进行 。 

人 G 选中 需要 提交 的 一 个 或 多 个 文件 ， 或 者 选中 这 些 文件 所 在 的 文件 夹 。 

人 G 执行 提交 可 以 使 用 如 下 三 种 等 效 操作 。 

> ”通过 菜单 操作 ， 单 击 “Modify” 菜 单 的 “Commit” 菜 单项 。 

> “使 用 快捷 键 ，Ctri+M。 

> 单 击 “Commit” 工具 按钮 (就 是 Update 右边 的 按钮 ) 。 

人 G 无 论 使 用 哪 种 提交 操作 ， 系 统 都 会 出 现 如 图 1.45 所 示 的 对 话 框 。 

通常 应 该 在 提交 修改 之 前 对 修改 进行 注释 ， 这 样 做 可 以 方便 后 续 开发 。 

人 @ 单 击 如 图 1.45 所 示 对 话 框 中 的 “确定 ”按钮 ， 提 交 修 改 完成 ， 该 文件 的 图 标 又 重新 变 回 白色 
图 标 ， 并 且 该 文件 的 版 本 号 也 升级 了 ， 如 图 1.46 所 示 。 


ET TL LE 
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了 妆 并且 了 DD 人 DD 凡 办 相国 


图 1.45 设置 提交 属性 图 1.46 提交 成 功 
>》>1.6.8 添加 文件 和 目录 


随 着 开发 的 进行 ， 我 们 需要 向 项 目 中 新 增 一 些 文件 ， 但 新 增 的 文件 并 不 会 自动 处 于 WinCvs 的 管 
理 之 下 。 例 如 ， 我 们 在 G:\antQs (笔者 的 本 地 工作 路 径 ) 下 新 建 了 一 个 newFile.txt 文件 ， 则 可 看 到 
WinCvs 显示 如 图 1.47 所 示 的 界面 。 


图 1.47 项 目 中 新 增 了 文件 后 的 界面 
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从 图 1.47 中 可 以 看 出 ， 该 文件 没有 版 本 号 ， 且 状态 是 “Unknown”， 这 表明 该 文件 还 未 处 于 CVS 
管理 之 下 ， 这 就 需要 将 该 文件 添加 到 CVS 中 。 

如 果 读 者 在 图 1.47 中 并 未 看 到 新 增 的 文件 ， 则 可 先 打 开 “View” 菜 单 ， 再 打开 “File Filter” 菜 单 
项 的 二 级 菜单 ， 并 取消 Hide Unknown 菜单 项 前 的 选中 状态 。 

向 CVS 中 添加 文件 请 按 如 下 步骤 进行 。 

人 @ 选中 需要 添加 的 一 个 或 多 个 文件 ， 或 者 选中 这 些 文件 所 在 的 文件 夹 。 

人 @ 执行 提交 可 以 通过 单 击 “Modify” 菜 单 的 “Add”"、“Add binary ”或 “Add unicode”3 个 菜单 
项 的 任意 之 一 实现 。 

需要 注意 的 是 ，CVS 添加 文件 有 如 下 三 种 方式 。 

> Add: 以 文本 方式 添加 。 

> Add binary: 以 二 进 制 形式 添加 。 

> Add unicode: 以 Unicode 形式 添加 。 

对 于 不 包含 非 西欧 字符 的 文本 文件 ， 可 使 用 Add 方式 添加 ;对 于 包含 非 西欧 字符 的 文本 文件 ， 则 
建议 使 用 Add Unicode 方式 添加 ; 对 于 图 形 文件 、 声 音 等 二 进 制 文件 ， 则 需要 用 Add binary 方式 添加 。 

人 添加 文件 成 功 后 将 看 到 新 增 文件 的 图 标 变 成 红色 ， 且 版 本 号 变 成 0， 状 态 变 成 “Added”， 如 
图 1.48 所 示 。 


图 1.48 添加 文件 成 功 


当 在 CVS 项 目 里 新 建 了 目录 之 后 ，CVS 同样 不 会 自动 管理 该 目录 ， 一 样 需 要 使 用 “Modify” 菜 
单 里 的 “Add” 菜 单项 来 添加 该 目录 。 值 得 指出 的 是 : CVS 添加 目录 之 后 并 不 会 自动 将 该 目录 下 的 文 
件 添加 进来 ， 开 发 者 必须 手动 添加 新 目录 下 的 文件 。 


》>>1.6.9 删除 文件 和 目录 


删除 文件 有 两 个 命令 : 一 个 是 Remove, 另 一 个 是 Erase, 都 在 "Modify” 主 菜单 下 面 。 其 中 , Remove 
是 同时 把 文件 从 本 地 和 CVS 资源 库 中 删除 ， 而 Erase 是 只 删除 本 地 文件 ， 不 动 CVS 资源 库 中 的 文件 。 

Remove 文件 的 步骤 非常 简单 ， 如 下 所 示 。 

《CG 选中 需要 Remove 的 一 个 或 多 个 文件 。 

人 通过 “Modify” 主 菜单 的 “Remove” 菜 单项 ， 或 直接 通过 Remove 工具 按钮 来 删除 该 文件 即 
可 。 删 除 成 功 后 ， 该 文件 图 标 变 成 红色 、 带 叉 图 标 ， 且 其 状态 变 成 Removed， 如 图 1.49 所 示 。 

指定 文件 被 删除 之 后 将 被 放 入 系统 回收 站 。 如 果 需 要 从 CVS 中 彻底 删除 该 文件 ， 还 需要 进行 
Commit 操作 。 

Erase 的 功能 是 把 本 地 的 文件 删除 掉 , 而 CVS 资源 库 中 对 应 的 文件 不 受 影响 。Erase 文件 的 操作 与 
Remove 文件 的 操作 基本 相似 ， 但 Erase 后 的 文件 图 标 与 Remove 的 文件 图 标 有 差别 ， 而 且 该 文件 状态 
变 成 Missing， 如 图 1.50 所 示 。 
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提示 
“由 于 被 Erase 的 文件 在 CVS 资源 库 中 依然 存在 ， 所 以 我 们 可 以 通过 WinCvs 提供 的 
Update 操作 从 资源 库 中 重新 取 回 该 文件 。 


WinCvs 界面 上 并 没有 提供 删除 目录 的 功能 .为 了 删除 CVS 资源 库 的 目录 ,我 们 必须 直接 进入 CVS 
资源 库 的 物理 目录 下 ,然后 将 指定 目录 删除 。CVS 资源 库 的 目录 被 删除 后 ， 本 地 项 目 空间 的 目录 并 不 
会 被 删除 ， 还 要 使 用 Checkout Module 的 操作 重新 下 载 该 项 目 。 


不 要 指望 使 用 WinCvs 直接 删除 CVS 资源 库 的 目录 ， 必 须 手动 删除 CVS 资源 库 所 
在 物理 机 器 上 的 指定 目录 才 


>>1.6.10 查看 文件 的 版 本 变革 


WinCvs 提供 了 图 形 界面 方式 来 查看 文件 版 本 的 版 本 变革 ， 并 比较 任意 两 个 版 本 之 间 的 差异 。 
查看 文件 的 版 本 变革 请 按 如 下 步骤 进行 。 

人 在 WinCvs 中 选中 需要 查看 的 文件 。 

@ 查看 该 文件 的 版 本 变革 有 如 下 三 个 等 效 操作 。 

> ”使 用 右键 菜单 : 右键 单 击 该 文件 图 标 ， 在 右键 菜单 中 单 击 “Graph.… 菜 单项 。 

> ”使 用 快捷 键 : 按 下 “Ctrl+G” 人 快捷 键 。 

> ”使 用 主 菜单 : 单 击 “Query” 主 菜单 的 “Graph...” 菜 单项 。 

个 使 用 上 面 三 个 操作 的 任意 之 一 ，WinCvs 弹出 一 个 “Graph settings” 对 话 框 ， 该 对 话 框 的 设置 
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通常 无 须 改变 ， 单 击 “ 确 认 ” 按 钮 即 可 ，WinCvs 将 以 图 形 界面 的 方式 显示 该 文件 的 版 本 变革 ， 如 图 
1.51 所 示 。 

WinCvs 显示 的 这 个 图 形 界面 非常 直观 , 我 们 可 以 非常 清楚 地 看 出 每 个 文件 的 版 本 变革 , 并 可 使 用 
鼠标 选中 任意 的 版 本 ，WinCvs 将 在 信息 输出 区 显示 这 个 版 本 的 相关 信息 。 这 些 信息 也 就 是 开发 者 在 
Commit 时 输入 的 注释 信息 。 

利用 这 个 版 本 变革 图 ， 我 们 可 以 比较 文件 任意 两 个 版 本 的 差异 ， 获 取 某 个 版 本 文件 的 内 容 等 。 


CITY 
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图 1.51 查看 文件 的 版 本 变革 
和 >1.6.11 提取 文件 以 前 版 本 的 内 容 


在 软件 开发 过 程 中 ,， 有 时 候 可 能 需要 提取 某 个 文件 以 前 版 本 的 内 容 。WinCvs 可 以 非常 方便 地 做 到 
这 一 点 。 

使 用 WinCvs 提取 文件 以 前 版 本 的 内 容 请 按 如 下 步骤 进行 。 

人 G 查看 该 文件 的 版 本 变革 图 ， 具 体操 作 见 1.6.10 节 的 内 容 。 

人 在 版 本 变革 图 中 ， 选 中 需要 提取 文件 内 容 的 版 本 。 

人 单 击 鼠 标 右键 ， 在 快捷 菜单 中 单 击 “Retrieve revision as…” WinCvs 将 弹出 一 个 保存 文件 的 
对 话 框 。 

多 保存 文件 ， 该 文件 的 内 容 就 是 文件 以 前 版 本 的 内 容 。 


> 和 1.6.12 从 以 前 版 本 重新 开始 


如 果 我 们 在 开发 过 程 中 把 某 个 文件 改 坏 了 ， 想 重 回 该 文件 的 以 前 版 本 ， 那 应 该 怎么 做 昵 ? WinCvs 
提供 了 很 方便 的 操作 允许 我 们 重 回 某 个 文件 的 指定 版 本 : 使 用 Update 操作 即 可 。 

以 某 个 文件 的 以 前 版 本 重新 开始 请 按 如 下 步骤 进行 。 

人 选中 需要 重新 开始 的 文件 ， 单 击 “Modify ” 主 菜单 的 
“Update” 菜 单项 ， 或 者 使 用 “CtrlHU ”快捷 键 ， 或 者 单 击 右 
键 菜单 的 “Update” 菜 单项 ， 即 可 打开 “Update settings” 对 
话 框 。 

人 单 击 “Update settings” 对 话 框 中 的 “Update options” 
选项 卡 ， 看 到 如 图 1.52 所 示 的 对 话 框 。 

G 勾 选 “By revesion/tag/branch” 复 选 框 ， 并 在 其 后 文本 
| A (如 图 1.52 所 示 ) 后 ， 单 击 “ 确 定 ” 


图 1.52 重 回 以 前 的 某 个 版 本 经 过 上 面 三 个 步骤 , 本 地 工作 路 径 下 的 指定 文件 的 内 容 就 
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变 为 以 前 版 本 的 文件 内 容 。 接 下 来 ， 就 可 在 此 版 本 的 基础 上 继续 开发 了 。 
>>1.6.13 创建 标签 


标签 (Tag)， 是 CVS 中 对 文件 版 本 的 一 种 文字 描述 ， 相 对 于 数字 序号 的 文件 版 本 ， 标 签 能 对 版 本 
进行 有 意义 的 表述 ， 在 版 本 控制 中 可 以 更 方便 地 存 取 。 

例如 ， 在 开发 过 程 中 ， 某 文件 (或 者 整个 Module) 达到 了 稳定 状态 ， 此 时 它 的 版 本 号 假定 为 3.1， 
我 们 可 以 对 该 文件 〈 或 者 整个 Module) 创建 一 个 标签 ， 标 签名 为 “stable”。 

创建 标签 请 按 如 下 步骤 进行 。 

人 选择 需要 加 标签 的 文件 或 者 Module。 

G 单 击 “Modify” 主 菜单 的 “Create a tag...” 菜 单项 ， 或 者 单 击 工具 栏 上 的 “Tag Selection” 按 
钮 (一 个 字形 的 图 标 按钮 )， 系 统 将 出 现 “Create tag settings” 对 话 框 ， 如 图 1.53 所 示 。 

人 在 如 图 1.53 所 示 的 对 话 框 中 填写 Tag 名 字 。CVS 中 合法 的 标签 名 规则 如 下 : 

> ”标签 名 必须 以 字母 开头 。 

> ”标签 名 只 能 包含 字母 、 数 字 、 中 画 线 (-) 和 下 画 线 (_) 。 


提 
我 们 下 载 一 些 开源 项 目 时 ， 经 常见 到 xxx_1_2.zip 的 文件 名 ， 这 就 是 由 于 CVS 不 多 ， 
许 标 签名 中 出 现 点 号 (.)， 所 以 委 用 滞 下 下 二 i( (_) 代替 点 号 的 结果 . | 


- 且 为 指定 文件 版 本 创建 了 标签 之 后 ， 就 可 以 在 文件 版 本 变革 图 中 看 到 该 标签 名 了 ， 如 图 1.54 
所 示 。 
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图 1.53 创建 标签 图 1.54 ”创建 标签 后 的 版 本 变革 图 
实际 上 , 标签 对 CVS 具有 非常 重要 的 意义 ,很 多 CVS 操作 都 可 以 专门 对 指定 的 标签 进行 。 例 如 ， 
在 Update 时， 可 以 指定 Update 到 指定 标签 (也 就 是 使 用 标签 来 代替 原来 数字 序号 的 版 本 号 )。 
当 我 们 为 指定 文件 版 本 创建 了 标签 之 后 ， 就 可 以 使 用 该 标签 名 来 代替 原来 数字 序号 的 版 本 号 ， 基 
本 上 可 以 使 用 原 有 版 本 号 的 地 方 ， 都 可 以 使 用 标签 来 代替 。 


>>1.6.14 创建 分 支 


在 有 些 时 候 ， 我 们 不 想 继 续 沿 着 开发 主线 开发 ， 而 是 希望 试探 性 地 添加 一 些 新 功能 ， 这 时 候 就 需 
要 在 原来 开发 主线 上 创建 一 个 分 支 (Branch)， 进 而 在 分 支 上 进行 开发 ， 避 免 损 坏 原 有 的 稳定 版 本 。 

创建 分 支 请 按 如 下 步骤 进行 。 

人 选 定 需要 创建 分 支 的 文件 、 目 录 (甚至 可 以 是 整个 项 目 所 在 的 文件 夹 )。 

人 单 击 “Modify” 主 菜单 的 “Create a branch...” 菜单 项 , 或 者 单 击 工具 栏 上 的 “Branch selected” 
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按钮 ， 系 统 将 弹出 “Create branch settings” 对 话 框 ， 如 图 1.55 所 示 。 
@ 在 “Create branch settings” 对话 框 中 , 先 勾 选 <Check that the files are unmodified before tagging” 
复 选 框 ， 然 后 在 “New branch ”文本 框 内 输入 分 支 名 称 ， 如 图 1.55 所 示 。 单 击 “ 确 定 ”按钮 ， 分 支 创 
建成 功 。 
当 分 支 创建 成 功 后 ， 我 们 可 以 在 该 文件 的 版 本 变革 图 中 看 到 该 分 支 的 效果 ， 如 图 1.56 所 示 。 
新 建 分 支 后 ， 我 们 就 可 以 在 新 分 支 的 基础 上 进行 开发 了 ， 从 而 避免 损坏 原 有 的 文件 版 本 。 
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图 1.55 新 建 分 支 图 1.56 新 建 分 支 后 的 效果 
》>>1.6.15 沿 着 分 支 开发 


为 了 沿 着 分 支 进行 开发 ， 要 求 我 们 先进 入 分 支 所 在 的 版 本 ， 而 我 们 当前 工作 目录 存放 着 开发 主线 
的 文件 。 

为 了 进入 分 支 工作 ， 我 们 需要 先 改变 本 地 工作 目录 ， 再 使 用 Checkout 操作 来 下 载 项 目 ， 下 载 项 目 
要 下 载 指定 分 支 的 阶段 。 例 如 ， 下 载 到 刚刚 创建 的 newBranch 分 支 阶段 ， 按 如 图 1.57 所 示 来 设置 
“Checkout settings” 对 话 框 。 

下 载 到 指定 分 支 的 项 目 后 ， 如 果 再 对 该 项 目 进行 修改 、 提 交 ， 则 不 会 对 开发 主线 有 任何 影响 ， 开 
发 者 所 做 的 修改 都 是 沿 着 特定 分 支 所 做 的 修改 。 再 次 查看 该 文本 的 版 本 变革 图 ， 将 看 到 如 图 1.58 所 示 
的 版 本 变革 图 。 
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提示 : 9 
为 了 沿 着 分 支 开发 ， 开 发 者 必须 先 Checkout 到 指定 分 支 ， 然 后 才能 沿 着 指定 分 支 向 下 ， 
开发 除 此 之 外 ， 先 Update 到 指定 分 支 也 行 ， 接 下 来 也 可 以 沿 着 指定 分 支 向 下 开发 。 | 


》>1.6.16 使 用 Eclipse 作为 CVS 客户 端 


很 多 时 候 我 们 没有 必要 使 用 WinCvs 作为 CVS 客户 端 ， 而 是 可 以 直接 使 用 Eclipse 作为 CVS 的 客 
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户 端 。 使 用 Eclipse 作为 CVS 客户 端 不 如 WinCvs 强大 ， 但 一 样 可 以 完成 基本 的 下 载 项 目 、 同 步 文件 、 
提交 修改 等 操作 。 

使 用 Eclipse 从 CVS 中 下 载 项 目 请 按 如 下 步骤 进行 。 

人 G 单 击 Eclipse 的 “File” 主 菜单 的 “Import..” 菜 单项 ， 系 统 将 弹出 如 图 1.59 所 示 的 导入 项 目 对 
话 框 。 
人 单 击 “CVS” 节 点 下 的 “Projects from CVS” 子 节点 ， 表 明 希 望 从 CVS 资源 库 中 导入 项 目 。 
单 击 “Next” 按 钮 ， 系 统 将 出 现 如 图 1.60 所 示 的 选择 CVSROOT 对 话 框 。 

人 @ 如 果 读者 是 第 一 次 使 用 Eclipse 作为 CVS 客户 端 ， 在 如 图 1.60 所 示 的 对 话 框 中 可 能 并 不 存在 
有 效 的 CVSROOT， 读 者 可 以 选中 “Create a new repository location” 单 选 按钮 ， 表 示 希 望 创建 新 的 
CVSROOT， 然 后 单 击 “Next” 按 钮 ， 系 统 将 进入 CVSROOT 属性 设置 对 话 框 ， 如 图 1.61 所 示 。 


ect 过 
need one oo mere pepca em 4 CS pepevtery PP 了 


@ ml) ce | enn 
图 1.59 导入 项 目 图 1.60 选择 CVSROOT 对 话 框 
多 按 图 1.61 所 示 输 入 CVSROOT 的 相关 属性 ， 然 后 单 击 “Next” 按钮， 系统 将 出 现 如 图 1.62 
所 示 的 选择 Module 名 称 对 话 框 。 
区 
区 -三 .注意 :全 


安装 了 防火 墙 ， 则 一 定 要 设置 防火 墙 允 许 Eclipse 访问 网 络 ， 或 者 关闭 防火 墙 。 


由 于 使 用 Eclipse 作为 CVS 客户 端 时 需要 Eclipse 访问 网 络 , 所 以 如 果 读者 的 机 器 上 ey 


Ce 


Caoaveavetedeiea eatenn 
全 weieeaeaneaunnre [Ca | ee 


图 1.61 设置 CVSROOT 属性 图 1.62 选择 Import 的 Module 
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人 在 如 图 1.62 所 示 的 对 话 框 中 输入 需要 Import 的 项 目 名 称 ， 然 后 单 击 “Next” 按 钮 ， 系 统 将 出 
现 如 图 1.63 所 示 的 “Check Out As” 对 话 框 。 

人 @ 单 击 “Finish” 按钮 ， 即 可 将 该 项 目 Check out 到 Eclipse 中 。 导 入 完成 后 将 看 到 Eclipse 左边 
的 项 目 导 航 树 中 出 现 如 图 1.64 所 示 的 效果 。 

如 果 需 要 在 Eclipse 中 对 一 个 或 多 个 文件 执行 同步 、 提 交 等 常规 操作 ， 则 先 选中 这 些 文件 ， 然 后 单 
击 鼠 标 右键 ， 并 在 弹出 的 快捷 菜单 中 单 击 “Team” 菜 单项 ，Eclipse 将 出 现 如 图 1.65 所 示 的 菜单 。 


| 
et 


图 1.63 设置 Check Out 属性 图 1.64 将 项 目 Check out 到 Eclipse 中 
看 到 如 图 1.65 所 示 的 菜单 ,相信 读者 已 经 能 参照 图 中 所 示 的 标注 完成 常规 的 提交 、 同步 等 操作 了 。 


= 
Fe 
ma 


图 1.65 ”Eclipse 中 CVS 操作 的 菜单 


1.7 本 章 小 结 


本 章 主 要 介绍 了 Java EE 应 用 的 相关 基础 知识 ,简要 介绍 了 Java EE 应 用 应 该 遵循 怎样 的 架构 模型 ， 
通常 应 该 具有 哪些 组 件 ， 以 及 这 些 组 件 通常 使 用 什么 样 的 技术 来 实现 。 本 章 还 简单 归纳 了 Java EE 应 
用 所 具有 的 优势 和 吸引 力 。 

本 章 重 点 讲解 了 如 何 措 建 轻 量 级 Java EE 应 用 的 开发 平台 , 介绍 了 安装 及 配置 Apache Tomcat Web 
服务 器 的 详细 步骤 ,也 详细 讲解 了 如 何 安装 Eclipse 开发 工具 ,并 简要 介绍 了 Eclipse 开发 工具 的 用 法 。 
除 此 之 外 ， 本 章 也 详细 讲解 了 Ant 工具 的 安装 和 用 法 ， 并 介绍 了 Ant 生成 文件 的 常见 元 素 ， 并 通过 一 
个 示例 示范 了 如 何 利用 Ant 来 管理 项 目 。 本 章 还 介绍 了 著名 版 本 控制 工具 CVS 的 用 法 ， 包 括 CVSNT 
和 WinCvs 的 安装 和 使 用 ， 并 详细 介绍 了 利用 WinCvs 发 布 、 下 载 项 目 ， 同 步 、 提 交 修 改 等 CVS 操作 ， 
最 后 还 介绍 了 使 用 Eclipse 作为 CVS 客户 端的 用 法 。 
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本 章 要 点 


划 Web 应 用 的 基本 结构 和 web.xml 文件 
各 JSP 的 基本 原理 

3aJSP 声明 

基 JSP 注释 和 HTML 注释 

基 JSP 输出 表达 式 

各 JSP 脚本 

基 JSP 的 3 个 编译 指令 

划 JSP 的 7 个 动作 指令 

和 JSP 脚本 中 的 9 个 内 置 对 象 

和 Servlet 的 开发 步骤 

外 用 XML 或 Servlet 3.0 的 Annotation 配置 Servlet 
节 Servlet 运行 的 生命 周期 

和 MVC 基础 

公开 发 JSP2 自 定义 标签 库 

节 使 用 有 属性 的 标签 

茹 使 用 带 标签 体 的 标签 

基 开 发 、 配 置 Filter 以 及 Filter 的 功能 
他 开 发 、 配 置 Listener 以 及 Listener 的 功能 
基 配 置 JSP 属性 

gaJSP2 的 表达 式 语言 

3aJSP2 的 Tag File 标签 库 

SaServlet 3.0 的 Web 模块 部 署 描述 符 
3aServlet 3.0 提供 的 异步 支持 

3aServlet 3.0 增强 的 ServletAPI 
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JSP (Java Server Page) 和 Servlet 是 Java EE 规范 的 两 个 基本 成 员 ， 它 们 是 Java Web 开发 的 重点 
知识 , 也 是 Java EE 开发 的 基础 知识 。 JSP 和 Servlet 的 本 质 是 一 样 的 , 因此 JSP 最 终 必须 编译 成 Servlet 
才能 运行 ， 或 者 说 JSP 只 是 生成 Servlet 的 “草稿 ”文件 。JSP 比较 简单 ， 它 的 特点 是 在 HTML 页 面 中 
嵌入 Java 代码 片段, 或 使 用 各 种 JSP 标签 , 包括 使 用 用 户 自 定义 标签 , 从 而 可 以 动态 地 提供 页 面 内 容 。 

早期 使 用 JSP 页 面 的 用 户 非常 广泛 ， 一 个 Web 应 用 可 以 全 部 由 JSP 页 面 组 成 ， 只 辅 以 少量 的 
JavaBean 即 可 。 自 Java EE 标准 出 现 以 后 ， 人 们 逐渐 认识 到 使 用 JSP 充当 过 多 的 角色 是 不 合适 的 。 
此 ，JSP 慢 慢 发 展 成 单一 的 表现 层 技术 ， 不 再 承担 业务 逻辑 组 件 及 持久 层 组 件 的 责任 。 

随 着 Java EE 技术 的 发 展 ， 又 出 现 了 FreeMarker、Velocity、Tapestry 等 表现 层 技术 ， 虽 然 这 些 技 
术 基 本 可 以 取代 JSP 技术 ， 但 实际 上 JSP 依然 是 应 用 最 广泛 的 表现 层 技术 。 本 书 介绍 的 JSP 技术 是 基 
于 JSP 2.2、Servlet 3.0 规范 的 ， 因 此 请 使 用 支持 Java EE 6 规范 的 应 用 服务 器 或 支持 Servlet 3.0 的 Web 
服务 器 (比如 Tomcat 7.0.X)。 

除了 介绍 JSP 技术 之 外 ， 本 章 也 会 讲解 JSP 的 各 种 相关 技术 : Servlet、Listener、Filter 以 及 自 定 
义 标签 库 等 技术 。 


2.1 Web 应 用 和 web.xml 文件 


JSP、Servlet、 Listener 和 Filter 等 都 必须 运行 在 Web 应 用 中 , 所 以 我 们 先 来 学 习 如 何 构建 一 个 Web 
应 用 。 


>>2.1.1 构建 Web 应 用 


在 1.5.5 节 中 已 经 介绍 了 如 何 通过 Eclipse 来 构建 一 个 Web 应 用 ， 但 笔者 坚持 认为 : 如 果 你 仅 学 会 
在 Eclipse 等 IDE 工具 中 单 击 “ 下 一 步 ”" “确定 ”等 按钮 ， 那 你 将 很 难 成 为 一 个 真正 的 程序 员 。 
笔者 一 直 相信 : 要 想 成 为 一 个 优秀 的 程序 员 ， 应 该 从 基本 功 练 起 ， 所 有 的 代码 都 应 该 用 简单 的 文 
本 编辑 器 (包括 EditPlus、UltraEdit 等 工具 ) 完成 。 
坚持 使 用 最 原始 的 工具 来 学 习 技术 ， 会 让 你 对 整个 技术 的 每 个 细节 有 更 准确 的 把 握 。 比 如 说 你 学 
握 了 1.4.5 节 的 内 容 , 但 你 是 否 知道 Eclipse 创建 Web 应 用 时 为 你 做 了 些 什么 ? 如 果 你 还 不 清楚 Eclipse 
所 干 的 每 件 事情 ， 那 你 还 不 能 使 用 它 。 
实际 上 ,真正 优秀 的 程序 员 当然 应 该 使 用 IDE 工具 ， 但 即使 使 用 vi CUNIX 下 无 格式 编辑 器 )、 记 
事 本 也 一 样 可 以 完成 非常 优秀 的 项 目 。 笔者 对 于 IDE 工具 的 态度 是 : 可 以 使 用 IDE 工具 ,但 绝 不 可 依 
赖 于 IDE 工具 。 学 习 阶 段 ， 千 万 不 可 使 用 IDE 工具 :开发 阶段 ， 使 用 IDE 工具 。 
提示 : 对 于 IDE 工具 , 业内 有 一 个 说 法 : IDE 工具 会 加 快 高 手 的 开发 效率 ， 但 会 使 初学 者 更 白痴 。 
下 面 我 们 将 “徒手 ”建立 一 个 Web 应 用 ， 请 按 如 下 步骤 进行 ， 
在 任意 目录 下 新 建 一 个 文件 夹 ， 笔 者 将 以 webDemo 文件 夹 建立 一 个 Web 应 用 。 
人 在 第 1 步 所 建 的 文件 夹 内 建 一 个 WEB-INF 文件 夹 ( 注 意 大 小 写 ， 这 里 区 分 大 小 写 )。 
@ 进入 Tomcat 或 任何 其 他 Web 容器 内 ， 找 到 任何 一 个 Web 应 用 ， 将 Web 应 用 的 WEB-INF 下 
的 web.xml 文件 复制 到 第 2 步 所 建 的 WEB-INF 文件 夹 下 。 
对 于 Tomeat 而 言 ,位 于 它 的 webapps 路 径 下 有 大 量 的 示例 Web 应 用 ;对 于 Jetty 而 言 , 它 的 webapps 
路 径 下 也 有 多 个 Web 应 用 。 
@ 修改 复制 后 的 web .xml 文件 , 将 该 文件 修改 成 只 有 一 个 根 元 素 的 XML 文件 .修改 后 的 web.xml 
文件 代码 如 下 。 
程序 清单 : codes\2\2.1\webDemovWEB-INF\web xml 
<?xml version="].0" encoding="GBK"?> 
<web-app xmlns="http://java.sun.com/xml/ns/javaee" 
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人 


点 G xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
et xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java. sun. mR pp 3_0.xsd" 
中 version="3.0"> 
EE </web-app> 
在 第 2 步 所 建 的 WEB-INF 路 径 下 ， 新 建 两 个 文件 夹 ，classes 和 lib， 这 两 个 文件 夹 的 作用 完全 相 
| 同 : 都 是 用 于 保存 Web 应 用 所 需要 的 Java 类 文件 ， 区 别 是 classes 保存 单个 *.class 文件 ; 而 lib 保存 打 
包 后 的 JAR 文件 。 

经 过 以 上 步骤 ， 已 经 建立 了 一 个 空 Web 应 用 。 将 该 Web 应 用 复制 到 Tomcat 的 webapps 路 径 下 ， 
: 该 Web 应 用 将 可 以 自动 部 署 在 Tomcat 中 。 
b 通常 我 们 只 需 将 JSP 放 在 Web 应 用 的 根 路 径 下 (对 本 例 而 言 ,就 是 放 在 webDemo 目录 下 ), 然后 
就 可 以 通过 浏览 器 来 访问 这 些 页 面 了 。 

根据 上 面 介绍 ， 不 难 发 现 Web 应 用 应 该 有 如 下 文件 结构 : 

<webDemo> 一 一 这 是 Web 应 用 的 名 称 ， 可 以 改变 

| 一 WEB-INF 

| |—classes 

| | 一 tib 

| |—web.xml 

| 一 <ajsp> 一 一 这 里 存放 任意 多 个 JSP 页 面 

上 面 的 webDemo 是 Web 应 用 所 对 应 文件 夹 的 名 字 ， 可 以 更 改 ; ajsp 是 该 Web 应 用 下 JSP 页 面 的 
名 字 ， 也 可 以 修改 (还 可 以 增加 更 多 的 JSP 页 面 )。 其 他 文件 来、 配置 文件 都 不 可 以 修改 。 

ajsp 页 面 的 内 容 如 下 。 

程序 清单 : codes\02W2.1\webDemo\ajsp 


‘<%8 page contentType="text/html; charset~GBK" language="java" errorPage="" %> 
<html> 
<head> 
<title> 欢 迎 </title> 
</head> 
<body> 
欢迎 学 习 Java Web 知识 
</body> 
</html> 


上 面 的 页 面 实际 上 是 一 个 静态 HTML 页 面 ， 在 浏 器 中 浏览 该 页 面 将 看 到 如 图 2.1 所 示 的 界面 。 
看 到 如 图 2.1 所 示 的 页 面 即 表示 Web 应 用 构建 成 功 ， 
并 已 经 将 其 成 功 地 部 署 到 Tomcat 中 了 。 


>》>2.1.2 配置 描述 符 web.xml 


| 上 一 节 介绍 的 、 位 于 每 个 Web 应 用 的 WEB-INF 路 径 
| 下 的 web.xml 文件 被 称 为 配置 描述 符 ， 这 个 web xml 文件 图 2.1 构建 Web 应 用 
对 于 Java Web 应 用 十 分 重要 ， 在 Servlet 2.5 规范 之 前 ， 每 个 Java Web 应 用 都 必须 包含 一 个 web.xml 
文件 ， 且 必须 放 在 WEB-INF 路 径 下 。 
总 Servlet3.0 规范 而 言 ，WEB-INF 路 径 下 的 web.xml 文件 不 再 是 必需 的 ， 但 通常 还 : 
是 建议 保留 该 配置 文件 。 | 


对 于 Java Web 应 用 而 言 ，WEB-INF 是 一 个 特殊 的 文件 夹 ，Web 容器 会 包含 该 文件 夹 下 的 内 容 ， 
客户 端 浏览 器 无 法 访问 WEB-INF 路 径 下 的 任何 内 容 。 
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在 Servlet 2.5 规范 之 前 ,Java Web 应 用 的 绝 大 部 分 组 件 都 通过 web.xml 文件 来 配置 管理 , Servlet 3.0 
规范 可 通过 Annotation 来 配置 管理 Web 组 件 , 因此 web.xml 文件 可 以 变 得 更 加 简洁 , 这 也 是 Servlet 3.0 
的 重要 简化 。 接 下 来 我 们 介绍 的 如 下 内 容 会 同时 介绍 两 种 配置 管理 方式 : 

> 配置 JSp。 
配置 和 管理 Servlet。 
配置 和 管理 Listener。 
配置 和 管理 Fikter。 
配置 标签 库 。 

> 配 辕 JSP 属性 。 

除 此 之 外 ，web.xml 还 负责 配置 、 管 理 如 下 常用 内 容 : 

> ”配置 和 管理 JAAS 授权 认证 。 

> ”配置 和 管理 资源 引用 。 

> ”Web 应 用 首页 。 

web.xml 文件 的 根 元 素 是 <web-app.… 信 元 素 ， 在 Servlet 3.0 规范 中 ， 该 元 素 新 增 了 如 下 属性 。 

> metadata-complete: 该 属性 接受 true 或 false 两 个 属性 值 。 当 该 属性 值 为 true 时 ， 该 Web 

应 用 将 不 会 加 载 Annotation 配置 的 Web 组 件 (如 Serviet、Filter、Listener 等 ) 。 

在 web.xml 文件 中 配置 首页 使 用 welcome-file-list 元 素 ， 该 元 素 能 包含 多 个 welcome-file 子 元 素 ， 

其 中 每 个 welcome-file 子 元 素 配 置 一 个 首页 。 例 如 如 下 配置 片段 : 


<!-- 配置 Web 应 用 的 首页 列表 --> 
<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
<welcome-file>index.htm</welcome-file> 
<welcome-file>index. jsp</welcome-file> 
</welcome-file-list> 


上 面 的 配置 信息 指定 该 Web 应 用 的 首页 依次 是 index.html、index.htm 和 index.jsp， 意 思 是 说 ， 当 
Web 应 用 中 包含 index.html 页 面 时 ， 如 果 浏 览 者 直接 访问 该 Web 应 用 ， 系 统 将 会 把 该 页 面 呈现 给 浏览 
者 ， 当 index.html 页 面 不 存在 时 ， 则 由 index.htm 页 面 充当 首页 ， 依 此 类 推 。 

每 个 Web 容器 都 会 提供 一 个 系统 的 web.xml 文件 ， 用 于 描述 所 有 Web 应 用 共同 的 配置 属性 。 例 
如 ，Tomcat 的 系统 web.xml 放 在 Tomcat 的 conf 路 径 下 ， 而 Jetty 的 系统 web.xml 文件 放 在 Jetty 的 etc 
路 径 下 ， 文 件 名 为 webdefaultxml。 


2.2 JSP 的 基本 原理 


JSP 的 本 质 是 Servlet， 当 用 户 向 指定 Servlet 发 送 请 求 时 ，Servlet 利用 输出 流动 态 生成 HTML 页 
面 ， 包 括 每 一 个 静态 的 HTML 标签 和 所 有 在 HTML 页 面 中 出 现 的 内 容 。 
由 于 包括 大 量 的 HTML 标签 、 大 量 的 静态 文本 及 格式 等 ， 导 致 Servlet 的 开发 效率 极为 低下 。 所 
有 的 表现 逻辑 ， 包 括 布局 、 色 彩 及 图 像 等 ， 都 必须 耦合 在 Java 代码 中 ， 这 的 确 让 人 不 胜 其 烦 。JSP 的 
出 现 弥补 了 这 种 不 足 ，JSP 通过 在 标准 的 HTML 页 面 中 嵌入 Java 代码 ， 其 静态 的 部 分 无 须 Java 程序 
控制 ， 只 有 那些 需要 从 数据 库 读 取 或 需要 动态 生成 的 页 面 内 容 ， 才 使 用 Java 脚本 控制 。 
从 上 面 的 介绍 可 以 看 出 ，JSP 页 面 的 内 容 由 如 下 两 部 分 组 成 。 
> ”静态 部 分 ， 标准 的 HTML 标签 、 静 态 的 页 面 内 容 ， 这 些 内 容 与 静态 HTML 页 面相 同 。 
> ”动态 部 分 ， 受 Java 程序 控制 的 内 容 ， 这 些 内 容 由 Java 程序 来 动态 生成 。 
下 面 是 一 个 最 简单 的 JSP 页 面 代码 。 
程序 清单 : codes\022.2\jspPrinciple\first.jsp 
<%8 page contentType="text/html; charset=GBK" language="java” errorPage="" $%> 
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<html> 
<head> 

<title> 欢 迎 </title> 

</head> 

<body> 

欢迎 学 习 Java Web 知识 ， 现 在 时 间 是 : 

<out .println (new java.util.Date());%> 
</body> 

</html> 


上 面 的 页 面 中 粗 体 字 代 码 放 在 <% 和 %> 之 间 ， 表 明 这 些 是 Java 脚本 ， 而 不 是 静态 内 容 ， 通 过 这 种 
方式 就 可 以 把 Java 代码 嵌入 HTML 页 面 中 ， 这 就 变 成 了 动态 的 JSP 页 面 。 在 浏览 器 中 浏览 该 页 面 ， 
将 看 到 如 图 2.2 所 示 的 页 面 。 


ACE 


图 2.2 JSP 页 面 的 静态 部 分 和 动态 部 分 


上 面 JSP 页 面 必须 放 在 Web 应 用 中 才 有 效 ， 所 以 编写 该 JSP 页 面 之 前 应 该 先 构建 一 个 Web 应 用 。 

本 章 后 面 介绍 的 内 容 都 必须 运行 在 Web 应 用 中 ， 所 以 也 必须 先 构建 Web 应 用 。 

从 表面 上 看 , JSP 页 面 已 经 不 再 需要 Java 类 ,似乎 完全 脱离 了 Java 面向 对 象 的 特征 。 事实 上 , JSP 
的 本 质 依然 是 Servlet (一 个 特殊 的 Java 类 )， 每 个 JSP 页 面 就 是 一 个 Servlet 实例 一 一 JSP 页 面 由 系统 
编译 成 Servlet，Servlet 再 负责 响应 用 户 请 求 。 也 就 是 说 ，JSP 其 实 也 是 Servlet 的 一 种 简化 ， 使 用 JSP 
时 ， 其 实 还 是 使 用 Servlet， 因 为 Web 应 用 中 的 每 个 JSP 页 面 都 会 由 Servlet 容器 生成 对 应 的 Servlet。 
对 于 Tomcat 而 言 ，JSP 页 面 生成 的 Servlet 放 在 work 路 径 对 应 的 Web 应 用 下 。 

再 看 如 下 一 个 简单 的 JSP 页 面 。 

程序 清单 : codes\02\2.2\jspPrinciple\test.jsp 

<!-~ 表明 这 是 一 个 JSP 页 面 --> 和 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 

<html xmlns="http://www.w3.0rg/1999/xhtml"> 外 

<head> 

oe <title> 第 二 个 JSP 页 面 </title> 

</head> 

<body> 

<!-~ 下 面 是 Java 脚本 -> 

<sforlint 1 = 0 ;1<7; i++) 

{ 

out.println("<font size='" + + ">"); 


> 
尧 狂 Java 训练 营 (wild Java Camp)</font> 
<br/> 


当 启动 Tomcat 之 后 ,可 以 在 Tomcat 的 work\Catalina\localhost\jspPrinciple\org\apache\jsp 目录 下 找 
到 如 下 文件 (本 Web 应 用 名 为 jspPrinciple， 上 面 JSP 页 的 名 为 testjsp): test_jsp.java 和 test_jsp.class。 
这 两 个 文件 都 是 由 Tomcat 生成 的 ，Tomcat 根据 JSP 页 面 生成 对 应 Servlet 的 Java 文件 和 class 文件 。 

下 面 是 testl_jspjava 文件 的 源 代码 ， 这 是 一 个 特殊 的 Java 类 ， 是 一 个 Servlet 类 。 

程序 清单 :; codes\02W2.2\testjava 


//JSP 页 面 经 过 Tomicat 编译 后 默认 的 包 
package org.apache.jsp; 
import javax.serviet.*; 
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import javax.servlet.http.* 
import javax.servlet.jsp. 
// 继 承 HttpJspBase 类 ， 该 类 其 实 是 Servlet 的 子 类 
public final class test_ jsp extends org.apache.jasper.runtime.HttpJspBase 

implements org.apache.jasper.runtime.JspSourceDependent { 

Private static final JspFactory _jspxFactory = JspFactory.getDefaultFactory(); 

private static java.util.List<string> _jspx_dependants; 

private javax.el.ExpressionFactory _el_expressionfactory; 

private org.apache.tomcat.InstanceManager _jsp_instancemanager; 

public java,util.List<string> getDependants() { 

return _jspx_dependants; 


上 
public void _jspInit() { 
_el_expressionfactory = _jspxFactory.getJspApplicationContext 
(getServletConfig() .getServletContext ()) .getExpressionFactory (); 
jsp_instancemanager = org.apache.jasper.runtime.InstanceManagerFactory 
-getInstanceManager (getservletConfig()); 
} 
public void jspDestroy() { 
} 
// 用 于 响应 用 户 请 求 的 方法 
public void _jspService (HttpServletRequest request, HttpServletResponse response) 
throws java.io.IOException, ServletException { 
PageContext pageContext = null; 
RttpSession session = null; 
ServletContext application = null; 
ServletConfig config = null; 
JapWriter out = null; 
object page = thisy 
JspWriter _jspx_out = null; 
PageContext _jspx_page_context = null; 


try { 
response.setContentType ("text/html; charset=GBK") 
PageContext ~ _jspxFactory.getPageContext (this, request, response, 
"", true, 8192, true); 
jspx_page_context = pageContext; 
application = pageContext.getServletContext (); 
config = pageContext.getServletConfig(); 
session = pageContext.getSession(); 
out = pageContext.getOut (); 
jspx_out = out; 
Out.write("\r\n"); 
out.write("\r\n"); 
out.write("\r\n")s; 
out.write("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional 
//EN\"\r\n"); 
Out .write("\t\"http://www.w3.0rg/TR/xhtml1/DTD/xhtml1l-transitional. dtd\"> 
\r\n")s; 
out.write("<html xmlns=\"http://www.w3.org/1999/xhtml\">\r\n"); 
out.write("<head>\r\n"); 
out.write("\t<title> 第 二 个 JSP 页面 </title>\r\n"); 
out .write("\t<meta name=\"website\" content=\http://wwwicrazyit.org\ />\ 
Ir\n"); 
out.write("</head>\r\n") 
out.write ("<body>\r\n" 
out .write ("<!-~ 下 面 是 Java 脚本 -->\r\n"); 
forlint 1 = 0 8 i < 7 14+) 
{ 
out.printlin("<font size='" + 1 + ">"); 
Out.write("\r\n"); 
out write" 疯狂 Java 训练 营 {Wild Java Camp)</font>\r\n"); 
out.write("<br/>\r\n™ 
和 
out.write("\r\n"); 
Out.write("</body>\r\n"); 
out.write("</html>"); 
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} catch (Throwable t) { 
if (!(t instanceof SkipPageException)){ 
out = jspx_out; 
if (out != null &5 out.getBuffersize() != 0) 
try { out.clearBuffer(); } catch (java.io.IOException e) {} 
if (_jspx_ page_context != null) jspx_page_context.handlePage 
Exception(t); 
} 
) finally { 
_jspxFactory. releasePageContext (_jspx_page_context); 
} 
} 
} 


初学 者 看 到 上 面 的 Java 类 可 能 有 点 难以 阅读 ， 其 实 这 就 是 一 个 Servlet 类 的 源 代 码 ， 该 Java 类 主 
要 包含 如 下 三 个 方法 (去 除 方法 名 中 的 _jsp 前 级 ， 再 将 首 字母 小 写 )。 

> init(): 初始 化 JSP/Servlet 的 方法 。 

> destroy(): 销毁 JSP/Servlet 之 前 的 方法 。 

> ”service(): 对 用 户 请 求生 成 响应 的 方法 。 

即使 读者 暂时 不 了 解 上 面 提 供 的 Java 代码 ,也 依然 不 会 影响 JSP 页 面 的 编写 ， 因 为 这 都 是 由 Web 


容器 负责 生成 的 ， 后 面 介绍 了 编写 Servlet 的 知识 之 后 再 来 看 这 个 Java 类 将 十 分 清晰 。 浏 览 该 页 面 可 
看 到 如 图 2.3 所 示 的 页 面 。 


下 

jovs 滑 二 二 2 Jars Coee) 

讲 狂 Java 调 统 吉 (Wijd Java Casp) 

疯狂 Java 训 练 营 (Wild Java Camp) 

疯狂 Java 训 练 营 (Wild Java Camp) 


图 23 ”使 用 Java 代码 控制 静态 内 容 

从 图 2.3 中 可 以 看 出 ，JSP 页 面 里 的 Java 代码 不 仅仅 可 以 输出 动态 内 容 ， 还 可 以 动态 控制 页 面 里 
的 静态 内 容 ， 例 如 ， 从 图 2.3 中 看 到 将 “疯狂 Java 训练 营 (Wild Java Camp)” 重 复 输出 了 7 次 。 

根据 图 2.3 所 示 的 执行 效果 ， 再 次 对 比 test1.jsp 和 testl_jspjava 文件 ， 可 得 到 一 个 结论 : JSP 页 面 
中 的 所 有 内 容 都 由 testl_jspjava 文件 的 页 面 输出 流 来 生成 。 图 2.4 显示 了 JSP 页 面 的 工作 原理 。 


图 2.4 JSP 页 面 的 工作 原理 


根据 上 面 的 JSP 页 面 工作 原理 图 ， 可 以 得 到 如 下 4 个 结论 : 
> ”JSP 文件 必须 在 JSP 服务 器 内 运行 。 
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> ”JSP 文件 必须 生成 Servlet 才能 执行 。 
> 每 个 JSP 页 面 的 第 一 个 访问 者 速度 很 慢 ， 因 为 必须 等 待 JSP 编译 成 Serviet。 
> ”JSP 页 面 的 访问 者 无 须 安装 任何 客户 端 ， 甚 至 不 需要 可 以 运行 Java 的 运行 环境 ， 因 为 JSP 
页 面 输送 到 客户 端的 是 标准 HTML 页 面 。 
JSP 技术 的 出 现 ， 大 大 提高 了 Java 动态 网 站 的 开发 效率 ， 所 以 得 到 了 Java 动态 网 站 开发 者 的 广泛 
支持 。 


2.3 JSP 注释 


JSP 注释 用 于 标注 在 程序 开发 过 程 中 的 开发 提示 ， 它 不 会 输出 到 客户 端 。 
的 格式 如 下 : 
<$-- 注释 内 容 ~-$> 

与 JSP 注释 形成 对 比 的 是 HTML 注释 ，HTML 注释 的 格式 是 : 
<!-- 注释 内 容 --> 

看 下 面 的 JSP 页 面 。 

程序 清单 ，codes\02\2.3\basicSyntax\commentjsp 


<%6 page contentType="text/html; charset=GBK" language="java" errorPage="" $> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 注释 示例 </title> 
</head> 


<%-- JSP 注释 部 分 ~-%> 
<!-- 增加 HTML 注释 --> 
<!-~ HTML 注释 部 分 --> 
</body> 
</html> 


上 面 的 页 面 中 粗 体 字 代 码 是 JSP 注释 ,其 他 注释 都 是 HTML 注释 。 在 浏览 器 中 浏览 该 页 面 ， 并 查 
看 页 面 源 代码 ， 页 面 的 源 代码 如 下 : 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 注释 示例 </title> 


</head> 
<body> 


注释 示例 

<!-- 增加 JSP 注释 --> 

<!-- 增加 BTML 注释 --> 

<!-- HTML 注释 部 分 --> 

</body> 

</html> 

在 上 面 的 源 代码 中 可 看 到 ，HTML 的 注释 可 以 通过 源 代码 查看 到 ， 但 JSP 的 注释 是 无 法 通过 源 代 
码 查看 到 的 。 这 表明 JSP 注释 不 会 被 发 送 到 客户 端 。 


2.4 JSP 声明 


JSP 声明 用 于 声明 变量 和 方法 。 在 JSP 声明 中 声明 方法 看 起 来 很 特别 ， 似 乎 不 需要 定义 类 就 可 直 
接 定义 方法 ， 方 法 似乎 可 以 脱离 类 独立 存在 。 实 际 上 ，JSP 声明 将 会 转换 成 对 应 Servlet 的 成 员 变量 或 
成 员 方法 ， 因 此 JSP 声明 依然 符合 Java 语法 。 
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JSP 声明 的 语法 格式 如 下 : 
<%! 声明 部 分 $> 
看 下 面 使 用 JSP 声明 的 示例 页 面 。 
程序 清单 codes\02\2.3\basicSyntaxdeclarejsp 
<%@ page contentType="text/html; charset=GBK" language="java"” errorPage="" $> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head> 
<title> 声明 示例 </title> 
</head> 


<!-- 下 面 是 JSP 声明 部 分 --> 
< 


// 声 明 一 个 整 型 变量 
public int count; 


// 声 明 一 个 方法 
Public String info() 
{ 

return "hello"; 
} 
> 
<body> 
<% 
// 将 count 的 值 输出 后 再 加 1 
out.println(count++); 
> 
<br/> 


// 输 出 tnfo () 方 法 的 返回 值 
out ,Println (info() ) 
> 

</body> 

</html> 


在 浏览 器 中 测试 该 页 面 时 ， 可 以 看 到 正常 输出 了 count 值 ， 每 刷新 一 次 ，count 值 将 加 1， 同 时 也 
可 以 看 到 正常 输出 了 info 方法 的 返回 值 。 

上 面 的 粗 体 字 代码 部 分 声明 了 一 个 整 型 变量 和 一 个 普通 方法 ， 表 面 上 看 起 来 这 个 变量 和 方法 不 属 
于 任何 类 , 似乎 可 以 独立 存在 , 但 这 只 是 一 个 假象 。 打开 Tomcat 的 work\Catalina\localhost\basicSyntax\ 
org\apache\jsp 目录 下 declare_jspjava 文件 ， 看 到 如 下 代码 片段 : 


public final class declare_jsp extends org.apache.jasper.runtime.HttpJspBase 
implements org.apache.jasper.runtime,JspSourceDependent { 
一 个 整 型 变量 


Public String info() 
Yk "hello"; 
} 
te 
上 面 的 粗 体 字 代码 与 JSP 页 面 的 声明 部 分 完全 对 应 ， 这 表明 JSP 页 面 的 声明 部 分 将 转换 成 对 应 
Servlet 的 成 员 变 量 或 成 员 方法 。 


要 由 于 JSP 声明 语法 定义 的 变量 和 方法 对 应 于 Servlet 类 的 成 员 变 量 和 方法 , 所 以 JSP 声 ! 
明 部 分 定义 的 变量 和 方法 可 以 使 用 private、public 等 访问 控制 符 修饰 ,也 可 使 用 static 修饰 ，| 
| 将 其 变 成 类 属性 和 类 方法 。 但 不 能 使 用 abstract 修饰 声明 部 分 的 方法 ， 因 为 抽象 方法 将 导 

致 JSP 对 应 Servlet 变 成 抽象 类 ， 从 而 导致 无 法 实例 化 . 


打开 多 个 浏览 器 ， 甚 至 可 以 在 不 同 的 机 器 上 打开 浏览 器 来 刷新 该 页 面 ， 将 发 现 所 有 客户 端 访问 的 
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count 值 是 连续 的 ， 即 所 有 客户 端 共享 了 同一 个 count 变量 。 这 是 因为 :JSP 页 面 会 编译 成 一 个 Servlet 
类 ,每 个 Servlet 在 容器 中 只 有 一 个 实例 ; 在 JSP 中 声明 的 变量 是 成 员 变量 ， 成 员 变量 只 在 创建 实例 时 
初始 化 ， 该 变量 的 值 将 一 直 保 存 ， 直 到 实例 销毁 。 

值得 注意 的 是 , info0 的 值 也 可 正常 输出 。 因 为 JSP 声明 的 方法 其 实 是 在 JSP 编译 中 生成 的 Servlet 
的 实例 方 Java 里 的 方法 是 不 能 独立 存在 的 ， 即 使 在 JSP 页 面 中 也 不 行 。 


区 
-三 -注意 :站 一 


JSP 提供 了 一 种 输出 表达 式 值 的 简单 方法 ， 输 出 表达 式 值 的 语法 格式 如 下 : 


<4= 表 达 式 %> 
看 下 面 的 JSP 页 面 ， 该 页 面 使 用 输出 表达 式 的 方式 输出 变量 和 方法 返回 值 。 
程序 清单 :codes\02W2.3\basicSyntax\outputEx.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 输出 表达 式 值 </title> 
</head> 
<%! 
public int count; 


public String info() 
{ 


return "hello"; 
) 
%> 
<body> 
<!-- 使 用 表达 式 输出 变量 值 --> 
<%=count++%> 
<br/> 
<!-- ”使 用 表达 式 输出 方法 返回 值 --> 
<S=info ()%> 
</body> 
</html> 


上 面 的 页 面 中 粗 体 字 代 码 使 用 输出 表达 式 的 语法 代替 了 原来 的 out.printin 输出 语句 ， 该 页 面 的 执 
行 效果 与 前 一 个 页 面 的 执行 效果 没有 区 别 。 由 此 可 见 ， 输 出 表达 式 将 转换 成 Servlet 里 的 输出 语句 。 


家 
' 生 -. 注 总 :站 - 
输出 表达 式 语法 后 不 能 有 分 号 要 


2.6 JSP 脚本 


以 前 JSP 脚本 的 应 用 非常 广泛 ， 因 此 JSP 脚本 里 可 以 包含 任何 可 执行 的 的 Java 代码 。 通 常 来 说 ， 
所 有 可 执行 性 Java 代码 都 可 通过 JSP 脚本 嵌入 HTML 页 面 。 看 下 面 使 用 JSP 脚本 的 示例 程序 。 
程序 清单 : codes\02\2.3\basicSyntax\scriptletjsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" > 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN” 
"http: //www:w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
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<html xmlns="http://wuw.w3.org/1999/xhtml"> 
‘<head> 
<title> 小 脚本 测试 </title> 
</head> 
<body> 
<table bgcolor="#9999dd" border="1" width="300px"> 
<!-- Java 脚本 ， 这 些 脚本 会 对 HTML 的 标签 产生 作用 -> 
< 
forlint i = 0; 1 < 10; i++) 
{ 


%> 
<!-- 上 面 的 循环 将 控制 <tr> 标 签 循环 --> 
<tr> 
<td> 循 环 值 :</td> 
<td><%=i$></td> 
</tr> 
< 
) 
> 
<table> 
</body> 
</html> 


上 面 的 页 面 中 粗 体 字 代 码 就 是 使 用 JSP 脚本 的 代码 ， 这 些 代 码 可 以 控制 页 面 中 静态 内 容 。 上 面 例 
子 程序 将 <tr.… 户 标签 循环 10 次 ， 即 生成 一 个 10 行 的 表格 ， 并 在 表格 中 输出 表达 式 值 。 
在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 2.5 所 示 的 效果 。 


图 2.5 使 用 脚本 动态 生成 10 行 


接 下 来 我 们 打开 Tomcat 的 work\Catalina\localhost\basicSyntax\org\apacheijsp 路 径 下 的 
scriptlet_ jspjava 文件 ， 将 看 到 如 下 代码 片段 : 


public final class scriptlet_jsp extends org.apache. eh HttpJspBase 
implements org-apache.jasper.runtime.JspSourceDependent 


public void _jspservice (HttpservletRequest request，HttpServletRespaiise zesponse) 
throws java.io.IOException, ServletException { 
out.write("\r\n"); 
out.wurite("\r\n"); 
out.write("\r\n"); 
out .write ("<!DOCTYPE html PUBLIC \"=//W3C//D?D XHTML 1.0 Pranaitional//EN 
\"\r\n")s; 
out.write("\t\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\r\n"); 
out .write ("<html xmlns=\"http://www.w3.0org/1999/xhtml\">\r\n")y 
out.write("<head>\r\n"); 
out .write("\t<title> 小 脚本 测试 </title>\r\n"); 和 
out .write(nNt<meta name=\"website\" content=\"http://www.crazyit.org\" >\r\n"); 
out.write("</head>\r\n"); 
out.write ("<body>\r\n"); 
out .write("<table bgcolor=\"#9999dd\" border=\"1\" width=\"300px\">\r\n"); 
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out.write("<!-- Java 脚本 ， 这 些 脚本 会 对 HTML 的 标签 产生 作用 -->\zNn") 7 
forlint i1 = 0 ;1<10 ;it) 
{ 
out.write("\r\n"); 
out .write("\t<!-- 上 面 的 循环 将 控制 <tr> 标 签 循环 -->\r\n"); 
out.write("\t<tr>\r\n")y; 
out .write("\t\t<td> 循 环 值 :</td>\r\n"); 
out.write("\t\t<td>"); 
out .print (1); 
out.write("</td>\r\n", 
out.write("\t</tr>\r\n"); 


} 

out.write("\r\n")s 
out.write("<table>\r\n"); 
t .write("</body>\r\n"): 
rite("</html>"); 


} 
} 


上 面 的 代码 片段 中 粗 体 字 代 码 完全 对 应 于 scriptletjsp 页 面 中 的 小 脚本 部 分 。 由 上 面 代 码 片段 可 以 
看 出 ,JSP 脚本 将 转换 成 Servlet 里 _jspService 方法 的 可 执行 性 代码 。 这 意味 着 在 JSP 小 脚本 部 分 也 可 
以 声明 变量 ， 但 在 JSP 脚本 部 分 声明 的 变量 是 局 部 变量 ， 但 不 能 使 用 private、public 等 访问 控制 符 修 
饰 ， 也 不 可 使 用 static 修饰 。 

提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 …， 
a 实际 上 不 仅 JSP 小 脚本 部 分 会 转换 成 _jspService 方法 里 的 可 执行 性 代码 ，JSP 页 面 里 } 
的 所 有 静态 内 容 都 将 由 _jspService 方法 里 输出 语句 来 输出 ， 这 就 是 JSP 脚本 可 以 控制 JSP | 
| 。 页面 中 静态 内 容 的 原因 .由 于 JSP 脚本 将 转换 成 _jspService 方法 里 的 可 执行 性 代码 ,而 Java ，! 
语法 不 允许 在 方法 里 定义 方法 ， 所 以 JSP 脚本 里 不 能 定义 | 
和 ee 由 
因为 JSP 脚本 中 可 以 放置 任何 可 执行 性 语句 ,所 以 可 以 充分 利用 Java 语言 的 功能 ， 例 如 连接 数据 
库 和 执行 数据 库 操作 。 看 下 面 的 JSP 页 面 执 行 数据 库 查 询 。 
程序 清单 : codes\02\2.3\basicSyntax\connDb.jsp 


<%@ page contentType="text/html; charset-GBK" languages"java" errorpage="" %> 

<%@ page import="java.sql.*" $> 

<!DOCTYPE html PUBLIC "~//W3C//DTD XHTML 1.0 Transitional//EN™" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
<title> 小 脚本 测试 </title> 

</head> 


.verManager .getConnection( 

"jdbo:mysql://localhost:3306/javaee", "root", "32147") ; 
// 创 建 Statement 
Statement stmt = conn.createstatenent(); 
// 执 行 查询 
ResultSet rs = stmt.executeQuery ("select * from news_inf"); 
%> 
table boceloess feden: boraene gentb ogee 


四 和 历 结果 条 
while (rs.next()) 
{8> 
<tr> 
<!-- 输出 结果 集 --> 
<td><$=rs.getString (1) ></td> 
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<td><¥=rs.getstring (2)%></td> 
</tr> 
<%}%> 
<table> 
</body> 
</html> 


上 面 程序 中 的 粗 体 字 脚 本 执行 了 连接 数据 库 , 执行 SQL 查询 , 并 使 用 输出 表达 式 语法 来 输出 查询 
结果 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 2.6 所 示 的 效果 。 


图 2.6 JSP 脚本 查询 数据 库 


上 面 的 页 面 执行 SQL 查询 需要 使 用 MySQL 驱动 程序 , 所 以 读者 应 该 将 MySQL 驱动 的 JAR 文件 
放 在 Tomcat 的 lib 路 径 下 (所 有 Web 应 用 都 可 使 用 MySQL 驱动 ), 或 者 将 MySQL 驱动 复制 到 该 Web 
应 用 的 WEB-INF/lib 路 径 下 (只 有 该 Web 应 用 可 使 用 MySQL 驱动 )。 除 此 之 外 ， 由 于 本 JSP 需要 查 
询 javaee 数据 库 下 的 newsinf 数据 表 ， 所 以 不 要 忘记 了 将 codes\01 路 径 下 的 test.sql 导入 数据 库 。 


2.7 JSP 的 3 个 编译 指令 


JSP 的 编译 指令 是 通知 JSP 引擎 的 消息 ， 它 不 直接 生成 输出 。 编 译 指令 都 有 默认 值 ， 因 此 开发 人 
员 无 须 为 每 个 指令 设置 值 。 

常见 的 编译 指令 有 如 下 三 个 。 

> page: 该 指令 是 针对 当前 页 面 的 指令 。 

> include: 用 于 指定 包含 另 一 个 页 面 。 

> taglib: 用 于 定义 和 访问 自 定义 标签 。 

使 用 编译 指令 的 语法 格式 如 下 : 

<s%8 编译 指令 名 属性 名 ~" 属性 值 "…$> 

下 面 主要 介绍 page 和 include 指令 ， 关 于 taglib 指令 ， 将 在 自 定义 标签 库 处 详细 讲解 。 


>>2.7.1 page 指令 


page 指令 通常 位 于 JSP 页 面 的 顶端 ， 一 个 JSP 页 面 可 以 使 用 多 条 page 指令 。page 指令 的 语法 格 
式 如 下 : 

<sepage 

[language="Java"] 

[extends="package. class"] 

[import="package. class | package.*,."] 

rue | false"] 

ne | BKB | size Kb"] 
"true | false"] 
lisThreadsafe="true | false"] 
[info="text"] 
TerrorPage="relativeURL] 
[contentType="mimeType[;charset=characterSet]" | "text/html; charset=IS0-8859-1"] 
[pageEncoding="ISO-8859-1"] 
[isErrorPage="true | false"] 
千 > 
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下 面 依 次 介绍 page 指令 各 属性 的 意义 。 


> 


> 
> 


> 


> 


language: 声明 当前 JSP 页 面 使 用 的 脚本 语言 的 种 类 ， 因 为 页 面 是 JSP 页 面 ， 该 属性 的 值 
通常 都 是 java， 该 属性 的 默认 值 也 是 java， 所 以 通常 无 须 设置 。 

extends: 指定 JSP 页 面 编译 所 产生 的 Java 类 所 继承 的 父 类 ， 或 所 实现 的 接口 。 

import: 用 来 导入 包 。 下 面 儿 个 包 是 默认 自动 导入 的 ， 不 需要 显 式 导入 。 默 认 导 入 的 包 有 : 
java.lang.*、javax.serviet.*、javax.servlet.jsp.*、javax.servlet.http.*。 

session; 设 定 这 个 JSP 页 面 是 否 需 要 HTTP Session。 

buffer， 指定 输出 缓冲 区 的 大 小 。 输 出 缓冲 区 的 JSP 内 部 对 象 ， out 用 于 缓存 JSP 页 面 对 客 
户 浏 览 器 的 输出 ， 默 认 值 为 8KB， 可 以 设置 为 none， 也 可 以 设置 为 其 他 的 值 ， 单 位 为 Kb。 
autoFlush: 当 输出 缓冲 区 即将 溢出 时 ， 是 否 需 要 强制 输出 缓冲 区 的 内 容 。 设 置 为 true 时 为 
正常 输出 ;如 果 设 置 为 false， 则 会 在 buffer 溢出 时 产生 一 个 异常 。 

info: 设置 该 JSP 程序 的 信息 ， 也 可 以 看 做 其 说 明 ， 可 以 通过 Servlet.getServletinfo() 方 法 获 
取 该 值 。 如 果 在 JSP 页 面 中 ， 可 直接 调用 getServletlnfo() 方 法 获取 该 值 ， 因 为 JSP 页 面 的 
实质 就 是 Servlet。 

errorPage: 指定 错误 处 理 页 面 。 如 果 本 页 面 产生 了 异常 或 者 错误 ， 而 该 JSP 页 面 没 有 对 应 
的 处 理 代 码 ， 则 会 自动 调用 该 属性 所 指定 的 JSP 页 面 。 


因为 JSP 内 建 了 异常 机 制 支持 ， 所 以 JSP 可 以 不 处 理 异 常 ， 即 使 是 checked 异常 。 | 


isErrorPage: 设置 本 JSP 页 面 是 否 为 错误 处 理 程序 。 如 果 该 页 面 本 身 己 是 错误 处 理 页 面 ， 
则 通常 无 须 指定 errorPage 属性 。 

contentType: 用 于 设 定 生成 网 页 的 文件 格式 和 编码 字符 集 ， 即 MIME 类 型 和 页 面 字符 集 类 
型 ， 默 认 的 MIME 类 型 是 texthtml， 默认 的 字符 集 类 型 为 ISO-8859-1。 

pageEncoding: 指定 生成 网 页 的 编码 字符 集 。 


从 2.6 节 中 执行 数据 库 操作 的 JSP 页 面 中 可 以 看 出 , 在 codes\02\2.3\jspPrinciple\connDb.jsp 页 面 的 
头 部 ， 使 用 了 两 条 page 指令 : 


<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" $4> 
<%@ page import="java.sql.*" $> 


其 中 第 二 条 指令 用 于 导入 本 页 面 中 使 用 的 类 ， 如 果 没 有 通过 page 指令 的 import 属性 导入 这 些 类 ， 
则 需 在 脚本 中 使 用 全 限定 类 名 一 一 即 必须 带 包 名 。 可 见 , 此 处 的 import 属性 类 似 于 Java 程序 中 的 import 
关键 字 的 作用 。 

如 果 删 除 第 二 条 page 指令 ， 则 执行 效果 如 图 2.7 所 示 。 

看 下 面 的 JSP 页 面 ， 该 页 面 使 用 page 指令 的 info 属性 指定 了 JSP 页 面 的 描述 信息 ， 又 使 用 
getServletInfo() 方 法 输出 该 描述 信息 。 

程序 清单 :codes\02\2.7\directive\jspInfojsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 


<!-- 指定 info 信息 --> 
<%@ page info="this is a jsp"%> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


‘<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 


<title> 测试 page 指令 的 info 属性 </title> 


</head> 

<body> 

<!-- 输出 info 信息 --> 
<s=getSservletInfo () > 
</body> 

</html> 
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以 上 页 面 的 第 一 段 粗 体 字 代码 设置 了 info 属性 ， 用 于 指定 该 JSP 页 面 的 描述 信息 ; 第 二 段 粗 体 字 
代码 使 用 了 getServletInfo( 方 法 来 访问 该 描述 信息 。 
在 浏览 器 中 执行 该 页 面 ， 将 看 到 如 图 2.8 所 示 的 效果 。 


ZNO MM WE ED ED IAD Wes 
‘“ BR x @ 回 wrrweeeeaawcanvcneemr 


2 Ca fete (emm mod.jac ouive) 
全 /了 数 扩 和 拓 

; Cornection conn = Driverlanager. getConnection( 
全 ret -ae 
265 7/ 创 建 statemenr 
27: Statement stmt = conn createstatenent () 


22: Css forhems (com modl. je. river 
/获取 数据 库 连 接 


Connection comn = Driverlanager, getConnsction( 
25; "jdbe ;meal /localbost: 3306/javaee”, "root”, "32147") 
26: // 创 建 Statement 


图 2.7 不 使 用 import 属性 导 包 的 出 错 效果 图 2.8 测试 page 指令 的 info 属性 


errorPage 属性 的 实质 是 JSP 的 异常 处 理 机 制 ,JSP 脚 本 不 要 求 强制 处 理 异常 ,即使 该 异常 是 checked 
异常 。 如 果 JSP 页 面 在 运行 中 抛 出 未 处 理 的 异常 ， 系 统 将 自动 跳 转 到 errorPage 属性 指定 的 页 面 ， 如果 
errorPage 没有 指定 错误 页 面 ， 系 统 则 直接 把 异常 信息 呈现 给 客户 端 浏览 器 一 一 这 是 所 有 的 开发 者 都 不 
愿意 见 到 的 场景 。 

看 下 面 的 JSP 页面， 该 页 面 设置 了 page 指令 的 errorPage 属性 ， 该 属性 指定 了 当 本 页 面 发 生 异 常 
时 的 异常 处 理 页 面 。 

程序 清单 : codes\02\2.7vdirectiveverrorTestjsp 


<48 page contentType="text/html; charset=GBK" 
language~"java" errorpage="error.jsp" $> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

<html xmlns="http://www.w3,.org/1999/xhtml"> 

<head> 
<title> new document </title> 

</head> 

> 


We 

int a= 6; 

int b= 0; 

int c=a/b; 

%> 

</body> 

</html> 

以 上 页 面 的 粗 体 字 代码 指定 errorTestjsp 页 面 的 错误 处 理 页 面 是 errorjsp。 下 面 是 errorjsp 页 面 ， 

该 页 面 本 身 是 错误 处 理 页 面 ， 因 此 将 isErrorPage 设置 成 true。 

程序 清单 : codes\02\2.7vdirectiveverrorjsp 

<%@ page contentType="text/html; charset=GBK" language="java" 
isErrorPage="true" $> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN” 
"http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 

<html xmlns="http://www.w3.0rg/1999/xhtml™"> 

<head> 
<title> 错误 提示 页 面 </title> 
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</head> 
<body> 
<!-- 提醒 客户 端 系统 出 现 异常 --> 
系统 出 现 异常 <br/> 
</body> 
</html> 
上 面 页 面 的 粗 体 字 代 码 指定 errorjsp 页 面 是 一 个 错误 处 理 页 面 。 在 浏览 器 中 浏览 errorTestjsp 页 面 
的 效果 如 图 2.9 所 示 。 
示 ;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 
有 些 读者 使 用 Internet Explorer 浏览 器 时 可 能 无 法 看 到 如 图 2.9 所 示 的 效果 ， 而 是 看 到 ! 
代号 为 500 的 错误 页 面 ， 这 是 Internet Explorer 浏览 器 “自作 聪明 ”的 结果 ， 读 者 可 以 选择 | 
| ”更 换 FireFox 浏览 器 。 如 果 坚 持 使 用 Internet Explorer 浏览 器 ， 则 请 单 击 Internet Explorer  : 
浏览 器 的 “ “工具 ” 主 菜单 的 “选项 ”菜单 项 ， 并 打开 “Internet 选项 ”对 话 框 的 “高 级 ” 
示 友 好 HTTP 错误 信息 ” 复 选 框 即 可 ， 如 图 2.10 所 示 


a mi) 


有 DE 

ti Paar me 

EE 
Etre 


是 疯 232X 
人 TD] 
二 [RE 


系统 出 到 异常 
ED r=] 
图 2.9 设置 errorPage 属性 的 效果 图 2.10 取消 IE 的 “显示 友好 HTTP 错误 信息 ” 复 选 杠 


如 果 将 前 一 个 页 面 中 page 指令 的 errorPage 属性 删除 ， 再 次 通过 浏览 器 浏览 该 页 面 ， 执 行 效果 如 
图 2.11 所 示 。 


ont apache jarper. servlet JapServlet serviceJappile(]spServletjara:363) 
re apache_jaspcr- serylet JapServlet service (JspServlet. jave: 306) 
jyar servlet Brtp HttpServlet. service (Ht tpServiet jara:722) 


图 2.11 没有 设置 erorPage 属性 的 效果 


可 见 ， 使 用 errorPage 属性 控制 异常 处 理 的 效果 在 表现 形式 上 要 好 得 多 。 
关于 JSP 异常 ， 本 章 在 介绍 exception 内 置 对 象 时 还 会 有 更 进一步 的 解释 。 
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2.7.2 include 指令 


使 用 include 指令 , 可 以 将 一 个 外 部 文件 戏 入 到 当前 JSP 文件 中 , 同时 解析 这 个 页 面 中 的 JSP 语句 
(如 果 有 的 话 ). 这 是 个 静态 的 include 语句 , 它 会 把 目标 页 面 的 其 他 编译 指令 也 包含 进来 ,但 动态 include 
则 不 会 。 
include 既 可 以 包含 静态 的 文本 ， 也 可 以 包含 动态 的 JSP 页 面 。 静 态 的 include 编译 指令 会 将 被 包 
含 的 页 面 加 入 本 页 面 ， 融 合成 一 个 页 面 ， 因 此 被 包含 页 面 甚 至 不 需要 是 一 个 完整 的 页 面 。 
include 编译 指令 的 语法 如 下 : 
<seinclude file="relativeURLSpec"$> 
如 果 被 嵌入 的 文件 经 常 需要 改变 , 建议 使 用 <jsp:include> 操 作 指 令 , 因为 它 是 动态 的 include 语句 。 
下 面 的 页 面 是 使 用 静态 导入 的 示例 代码 。 
程序 清单 : codes\02W2.7\directive\staticIncludejsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" > 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 静态 include 测试 </title> 
</head> 
<body> 
<!-~ 使 用 include 编译 指定 导入 页 面 -> 
<h0include file="errorTest. jsp"s> 
</body> 
</html> 
以 上 页 面 中 粗 体 字 代码 使 用 静态 导入 的 语法 将 scriptletjsp 页 面 导入 本 页 ， 该 页 面 的 执行 效果 与 
scriptletjsp 的 执行 效果 相同 。 
查看 Tomcat 的 work\Catalina\localhost\directive\org\apache\jsp 路 径 下 的 staticInclude_jsp.java 文件 ， 
从 staticInclude.jsp 编译 后 的 源 代码 可 看 到 , staticInclude.jsp 页 面 已 经 完全 将 errorTestjsp 的 代码 融入 到 
本 页 面 中 。 下 面 是 staticInclude_jspjava 文件 的 片段 ， 
out.write("<table bgcolor=\"#9999dd\" border=\"I\" te 
out .write ("<!-- Java 脚本 ， 这 些 脚本 会 对 HTML 的 标签 产生 作用 一 : 
forlint 1 = ,07 1< 10 7 i++) 
ed 内 
out.write("\r\n"); 
out -write ("\t<1-- 上 面 的 多 环 将 控制 <tr> 标 签 循环 -->\z\n"); 
Out.write("\t<tr>\r\n"); 
out ,write("\t\t<td> 循 环 值 :</td>\r\n"); 
out.write("\t\t<td>"); 
out .print (1); 下 六 要 全 
out.write("</td>\r\n"); ja 
out.write("\t</tr>\r\n")y; 


} 

上 面 这 些 页 面 代码 并 不 是 由 staticInclude.jsp 页 面 所 生成 的 ， 而 是 由 scriptletjsp 页 面 生成 的 。 也 就 
是 说 ，scriptletjsp 页 面 的 内 容 被 完全 融入 staticImportjsp 页 面 所 生成 的 Servlet 中 ， 这 就 是 静态 包含 意 
义 : 包含 页 面 在 编译 时 将 完全 包含 了 被 包含 页 面 的 代码 。 

需要 指出 的 是 ， 静 态 包含 还 会 将 被 包含 页 面 的 编译 指令 也 包含 进来 ， 如 果 两 个 页 面 的 编译 指令 冲 
突 ， 那 么 页 面 就 会 出 错 。 


2.8 JSP 的 7 个 动作 指令 


动作 指令 与 编译 指令 不 同 , 编译 指令 是 通知 Servlet 引擎 的 处 理 消息 , 而 动作 指令 只 是 运行 时 的 动 
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作 。 编译 指令 在 将 JSP 编译 成 Servlet 时 起 作用 ; 而 处 理 指令 通常 可 替换 成 JSP 脚本 ， 它 只 是 JSP 脚本 
的 标准 化 写法 。 

JSP 动作 指令 主要 有 如 下 7 个 。 
jsp:forward: 执行 页 面 转 向 ， 将 请 求 的 处 理 转发 到 下 一 个 页 面 。 
jsp:param: 用 于 传递 参数 ， 必 须 与 其 他 支持 参数 的 标签 一 起 使 用 。 
jsp:include: 用 于 动态 引入 一 个 JSP 页 面 。 
jsp:plugin: 用 于 下 载 JavaBean 或 Applet 到 客户 端 执行 。 
jsp:useBean: 创建 一 个 JavaBean 的 实例 。 
jsp:setProperty， 设置 JavaBean 实例 的 属性 值 。 
jsp:getProperty: 输出 JavaBean 实例 的 属性 值 。 
下 面 依次 讲解 这 些 动作 指令 。 


>>2.8.1 forward 指令 


em 


forward 指令 用 于 将 页 面 响应 转发 到 另外 的 页 面 。 既 可 以 转发 到 静态 的 HTML 页 面 ， 也 可 以 转发 
到 动态 的 JSP 页 面 ， 或 者 转发 到 容器 中 的 Servlet。 
JSP 的 forward 指令 的 格式 如 下 。 
对 于 JSP 1.0， 使 用 如 下 语法 : 
<jsp:forward page="{relativeURL|<%=expression®>}"/> 
对 于 JSP 1.1 以 上 规范 ， 可 使 用 如 下 语法 : 
<jsp:forward page="{relativeURL1<$=expressions>j"> 


{<jsp:param. ../>} 
</jsp: forward> 
第 二 种 语法 用 于 在 转发 时 增加 额外 的 请 求 参 数 。 增 加 的 请 求 参数 的 值 可 以 通过 HttpServletRequest 
类 的 getParameter() 方 法 获取 。 
下 面 示例 页 面 使 用 了 forward 动作 指令 来 转发 用 户 请 求 。 
程序 清单 :codes\02\2.7\directiveijsp-forward.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> forward 的 原始 页 </title> 
</head> 
<body> 
<h3>forward 的 原始 页 </h3> 
<jsp:forward page="forward-result. jsp"> 
<jsp:param name="age" value="29"/> 
</jsp:forward> 
</body> 
</html> 
这 个 JSP 页 面 非常 简单 ， 它 包含 了 简单 的 title 信息 ， 页 面 中 也 包含 了 简单 的 文本 内 容 ， 页 面 的 粗 
体 字 代码 则 将 客户 端 请 求 转发 到 forward-resultjsp 页 面 ， 转 发 请 求 时 增加 了 一 个 请 求 参 数 ， 参 数 名 为 
age， 参 数值 为 29。 
在 forward-resultjsp 页 面 中 ,使 用 request 内 秆 对 象 (request 内 置 对 象 是 HttpServletRequest 的 实例 ， 
关于 request 的 详细 信息 参看 下 一 节 ) 来 获取 增加 的 请 求 参数 值 。 
程序 清单 : codes\02W2.7\directive\forward-resultjsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" 8> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
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"http://www.w3.0org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlins="http://www.w3.org/1999/xhtml"> 
<head> 
<title>forward 结果 页 </title> 
</head> 
<body> 
<!-- 使 用 request 内 算 对 和 象 获取 age 参数 的 值 -~-> 
<s=request.getparameter ("age")$> 
</body> 
</html> 


forward-resultjsp 页 面 中 的 粗 体 字 代 码 设置 了 title 信息， 并 输出 了 age 请 求 参数 的 值 ， 在 浏览 器 中 
访问 jsp-forwardjsp 页 面 的 执行 效果 如 图 2.12 所 示 。 


图 2.12 forward 动作 指令 的 效果 


从 图 2.12 中 可 以 看 出 ， 执 行 forward 指令 时 ， 用 户 请 求 的 地 址 依然 没有 发 生 改变 ， 但 页 面 内 容 却 
完全 变 为 被 forward 目标 页 的 内 容 。 

执行 forward 指令 转发 请 求 时 ， 客 户 端的 请 求 参 数 不 会 丢失 。 看 下 面 表单 提交 页 面 的 例子 ， 该 页 
面 没有 任何 动态 的 内 容 ， 只 是 一 个 静态 的 表单 页 ， 作 用 是 将 请 求 参数 提交 到 jsp-forwardjsp 页 。 

程序 清单 : codes\02\2.7\directive\form.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 提交 </title> 

</head> 

<body> 

<!-- 表单 提交 页 面 --> 

<form id="login" method="post" action="jsp-forward.jsp"> 

<input type="text" name="username"> 

<input type="submit" value="login"> 

</form> 

</body> 

</html> 


修改 forward-resultjsp 页 ， 增 加 输出 表单 参数 的 代码 ， 也 就 是 在 forward-resultjsp 页 面 上 增加 如 下 
代码 : 
<!-- 输出 username 请 求 参数 的 值 --> 


<%=request .getParameter ("Username")%> 


在 表单 提交 页 面 中 的 文本 框 中 输入 任意 字符 串 后 提交 该 表单 , 即 可 看 到 如 图 2.13 所 示 的 执行 效果 。 


图 2.13 执行 forward 时 不 会 丢失 请 求 参数 


从 图 2.13 中 可 看 到 ，forward-resultjsp 页 面 中 不 仅 可 以 输出 forward 指令 增加 的 请 求 参数 , 还 可 以 
看 到 表单 里 usemame 表单 域 对 应 的 请 求 参数 ， 这 表明 执行 forward 时 不 会 丢失 请 求 参数 。 
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>>2.8.2 include 指令 


include 指令 是 一 个 动态 include 指令 ， 也 用 于 包含 某 个 页 面 ， 它 不 会 导入 被 include 页 面 的 编译 指 
令 ， 仅 仅 将 被 导入 页 面 的 body 内 容 插入 本 页 面 。 
下 面 是 include 动作 指令 的 语法 格式 : 
<jsp:include page="{relativeURL | <$=expression$>}" flush="true"/> 
<jsp:include page="{relativeURL | <%=expression%>}" flush="true"> 
<jsp:param name="parameterMame" value="patameterValue"/> 
</jsp:include> 
flush 属性 用 于 指定 输出 缓存 是 否 转移 到 被 导入 文件 中 。 如 果 指 定 为 true, 则 包含 在 被 导入 文件 中 ; 
如 果 指定 为 false， 则 包含 在 原文 件 中 。 对 于 JSP 1.1 旧版 本 ， 只 能 设置 为 false。 
对 于 第 二 种 语法 格式 ， 则 可 在 被 导入 页 面 中 加 入 额外 的 请 求 参数 。 
下 面 的 页 面 使 用 了 动态 导入 语法 来 导入 指定 JSP 页 面 。 
程序 清单 : codes\02\2.7\directive\jsp-includejsp 


<%@ page contentType~"text/html; charset=GBK" language="java" errorPage="" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://wuw.w3.org/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> jsp-include 测试 </title> 
</head> 
<body> 
<1!-- 使 用 动态 include 指令 导入 页 面 ~-> 
<jsp:include page="scriptlet. jsp" /> 
</body> 
</html> 


以 上 页 面 中 粗 体 字 代码 使 用 了 动态 导入 语法 来 导入 了 scriptletjsp。 表 面 上 看 ， 该 页 面 的 执行 效果 
与 使 用 静态 include 导入 的 页 面 并 没有 什么 不 同 。 但 查看 jsp-includejsp 页 面 生成 Servlet 的 源 代码 ， 可 
以 看 到 如 下 片段 : 


// 使 用 页 面 输出 流 ， 生 成 HTML 标签 内 容 

out.write("</head>\r\n"); 

out.write("<body>\r\n");} 

out .write("<!-- 使 用 动态 include 指令 导入 页 面 -->\r\n"); 

org.apache. jasper.runtime. JspRuntimeLibrary.include (request 
. "scriptlet.jsp", out, false); 

out.write("\r\n"); 

out.write("</body>\r\n"); 


以 上 代码 片段 中 粗 体 字 代 码 显示 了 动态 导入 的 关键 : 动态 导入 只 是 使 用 一 个 include 方法 来 插入 目 
标 页 面 的 内 容 ， 而 不 是 将 目标 页 面 完 全 融入 本 页 面 中 。 
归纳 起 来 ， 静 态 导 入 和 动态 导入 有 如 下 三 点 区 别 : 
> 静态 导入 是 将 被 导入 页 面 的 代码 完全 融入 ,两 个 页 面 融 合成 一 个 整体 Servlet; 而 动态 导入 则 
在 Servlet 中 使 用 include 方法 来 引入 被 导入 页 面 的 内 容 。 
> 静态 导入 时 被 导入 页 面 的 编译 指令 会 起 作用 ; 而 动态 导入 时 被 导入 页 面 的 编译 指令 则 失去 作 
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用 ， 只 是 插入 被 导入 页 面 的 body 内 容 。 
> ”动态 包含 还 可 以 增加 额外 的 参数 。 
除 此 之 外 ， 执 行 include 动态 指令 时 ， 还 可 增加 额外 的 请 求 参数 ， 如 下 面 JSP 页 面 所 示 。 
程序 清单 : codes\02W2.7\directive\jsp-include2.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 
<1DOCTYPE html PUBLIC "~//W3C//DTD XHTML 1.0 Transitional//EN™ 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head> 
<title> jsp-include 测试 </title> 
</head> 
<body> 
<jsp:include page="forward-result.jsp" > 
<jsp:param name="age" value="32"/> 
</jsp:include> 
</body> 
</html> 


在 上 面 的 JSP 页 面 中 的 粗 体 字 代 码 同 样 使 用 <jsp:include..…/> 指 令 包含 页 面 , 而 且 在 jsp:include 指令 
中 还 使 用 param 指令 传 入 参数 ， 该 参数 可 以 在 forward-result.jsp 页 面 中 使 用 request 对 象 获 取 。 
forward-resultjsp 前 面 已 经 给 出 ， 此 处 不 再 袭 述 。 页 面 执行 的 效果 如 图 2.14 所 示 。 


图 2.14 增加 请 求 参 数 的 include 


Fr forward 动作 指令 和 include 动作 指令 十 分 相似 ( 它们 的 语法 就 很 相似 )， 它 们 | 
都 采用 方法 来 引入 目标 页 面 ， 通 过 查看 JSP 页 面 所 生成 Servlet 代码 可 以 得 出 : forward 指 : 
| 信使 用 jspx_page_context 的 forward() 方 法 来 引入 目标 页 面 ， 而 include 指令 则 使 用 通过 | 

: ”JspRuntimeLibrary 的 include0 方 法 来 引入 目标 页 面 . 区 别 在 于 , 执行 forward 时 , 被 forward | 

| 。 的 页 面 将 完全 代替 原 有 页 面 ; 而 执行 include 时 ， 被 include 的 页 面 只 是 插入 原 有 页 面 。 简 : 
而 言 之 : forward 拿 目标 页 面 代替 原 有 页 面 ， 而 include 则 拿 目标 页 面 插入 原 有 页 面 。 | 


>>2.8.3 useBean、setProperty、getProperty 指令 


这 三 个 指令 都 是 与 JavaBean 相关 的 指令 ， 其 中 useBean 指令 用 于 在 JSP 页 面 中 初始 化 一 个 Java 
实例 ; setProperty 指令 用 于 为 JavaBean 实例 的 属性 设置 值 ;, getProperty 指令 用 于 输出 JavaBean 实例 的 
属性 。 

如 果 多 个 JSP 页 面 中 需要 重复 使 用 某 段 代码 , 我 们 可 以 把 这 段 代码 定义 成 Java 类 的 方法 , 然后 让 
多 个 JSP 页 面 调用 该 方法 即 可 ， 这 样 可 以 达到 较 好 的 代码 复 用 。 

useBean 的 语法 格式 如 下 : 


<jsp:useBean id="name" class="classname" scope="page | reques 
| session | application"/> : 


其 中 ,id 属 性 是 JavaBean 的 实例 名 ,class 属性 确定 JavaBean 的 实现 类 .scope 属性 用 于 指定 JavaBean 
实例 的 作用 范围 ， 该 范围 有 以 下 4 个 值 。 
> page: 该 JavaBean 实例 仅 在 该 页 面 有 效 。 
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> request: 该 JavaBean 实例 在 本 次 请 求 有 效 。 
> 。 session: 该 JavaBean 实例 在 本 次 session 内 有 效 。 
> he 该 JavaBean 实例 在 本 应 用 内 一 直 有 效 。 


setProperty 指令 的 语法 格式 如 下 : 
<jsp:setProperty name="BeanName" proterty="propertyName" value="value"/> 
其 中 ，name 属性 确定 需要 设 定 JavaBean 的 实例 名 : property 属性 确定 需要 设置 的 属性 名 ;value 
属性 则 确定 需要 设置 的 属性 值 。 
getProperty 的 语法 格式 如 下 : 
<jsp:getProperty name="BeanName" proterty="propertyName" /> 
其 中 ，name 属性 确定 需要 输出 的 JavaBean 的 实例 名 :，property 属性 确定 需要 输出 的 属性 名 。 
下 面 的 JSP 页 面 示范 了 如 何 使 用 这 3 个 动作 指令 来 操作 JavaBean。 
程序 清单 : codes\02\2.7\directive\beanTest.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD’ XRTML 1.0 Transitional//EN" 
"http://www.w3,org/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
‘<head> 
<title> Java Bean 测试 </title> 
</head> 
<body> 
<!-~ 创建 lee . Peraon 的 实例 ， 该 实例 的 实例 名 为 Pl --> 
<jsp:useBean id="pl" class="lee.Person" scope="page"/> 
<!-- 设置 Pl 的 name 属性 值 --> 


</html> 


以 上 页 面 中 粗 体 字 代码 示范 了 使 用 useBean、setProperty 和 getProperty 来 操作 JavaBean 的 方法 。 
对 于 上 面 的 JSP 页 面 中 的 setProperty 和 getProperty 标签 而 言 ， 它 们 都 要 求 根 据 属性 名 来 操作 
JavaBean 的 属性 。 实 际 上 setProperty 和 getProperty 要 求 的 属性 名 ， 与 Java 类 中 定义 的 属性 有 一 定 的 
差别 ， 例 如 setProperty 和 getProperty 需要 使 用 name 属性 ， 但 JavaBean 中 是 否 真 正定 义 了 name 属性 
并 不 重要 ， 重 要 的 是 在 JavaBean 中 提供 了 setName0 和 getName( 方 法 即 可 。 事 实 上 ， 当 页 面 使 用 
setProperty 和 getProperty 标签 时 ， 系 统 底层 就 是 调用 setName0 和 getName() 方 法 来 操作 Person 实例 的 
属性 的 。 
下 面 是 Person 类 的 源 代 码 。 
程序 清单 : codes\02\2.7\directive\WEB-INF\src\lee\Person.java 
public class Person 
private String name; 
private int age; 
// 无 参数 的 构造 器 
public Person() 


{ 
} 
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// 初 始 化 全 部 属性 的 构造 器 
public Person(String name , int age) 
{ 

this.name = name; 

this.age = age; 


于 
//name 属性 的 setter 和 getter 方法 
public void setName (String name) 
{ 

this.name = name; 


} 
public String getName{) 
{ 

return this.name; 


//age 属性 的 setter 和 getter 方法 
public void setAge(int age) 
{ 

this.age = age; 


上 
public int getAge() 
{ 
return this.age; 
} 
} 


上 面 的 Personjava 只 是 源 文件 , 我 们 将 该 文件 放 在 Web 应 用 的 WEB-INF/sre 路 径 下 ， 
源 文件 对 Web 应 用 不 起 作用 ， 所 以 我 们 会 使 用 Ant 来 编译 它 ， 并 将 编译 得 到 的 二 进 制 文件 放 入 
WEB-INF/classes 路 径 下 。 而 且 ， 当 我 们 为 Web 应 用 提供 了 新 的 class 文件 后 ， 必 须 重启 该 Web 应 用 ， 
让 它 可 以 重新 加 载 这 些 新 的 class 文件 。 

该 页 面 的 执行 效果 如 图 2.15 所 示 。 


XMO MUD uF Frm BED IAD Why 


图 2.15 操作 JavaBean 
对 于 上 面 三 个 标签 完全 可 以 不 使 用 ,将 beanTestjsp 修改 成 如 下 代码 , 其 内 部 的 执行 是 完全 一 样 的 。 


<%@ page contentType="text/html; charset~GBK" language="java" errorPage="" $> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN” 
"http://Wwww.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> Java Bean 测试 </title> 
</head> 


< 
// 实 例 化 JavaBean 实例 ， 实 现 类 为 lee . Person， 该 实例 的 实例 名 为 P1 
Person pl = new Person(); 

// 将 pl 放置 到 page 范围 中 

pageContext .setAttribute ("pl"” , pl); 

// 设 置 pl 的 name 属性 值 

pl.setName (wwawan) 

/7 设置 pl 的 age 属性 值 

pl ,setRge(23)7 

> 

<!-- 输出 pl 的 name 属性 值 --> 

<%=pl.getName () $><br/> 

<!-- 输出 pl 的 age 属性 值 一 > 
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<s=p1.gethge()S> 
</body> 
</html> 


使 用 useBean 标签 时 ， 除 在 页 面 脚本 中 创建 了 JavaBean 实例 之 外 ， 该 标签 还 会 将 该 JavaBean 实 
例 放 入 指定 scope 中 ， 所 以 我 们 通常 还 需要 在 脚本 中 将 该 JavaBean 放 入 指定 scope 中 ， 如 下 面 的 代码 
片段 所 示 : 

// 将 pl 放 入 page 的 生存 范围 中 
pageContext .setAttribute ("pl" , pl); 
// 将 pl 放 入 request 的 生存 范围 中 
request. setAttribute ("pl",p1); 

// 将 pl 放 入 session 的 生存 范围 中 
session.setAttribute("pl", pl1); 


// 将 pl 放 入 application 的 生存 范围 中 
application,setRttribute("plnrpl)7 


提示 
部 实际 由 于 现在 很 少 使 用 Applet, 而 且 就 算 要 使 用 Applet, 我 们 完全 可 以 使 用 支持 Applet ， 
的 HTML 标签 ， 所 以 jsp:plugin 标签 的 使 用 场景 并 不 多 。 因此 为 了 节省 篇 幅 起 见 ， 本 书 不 | 

| ”再 详细 介绍 plugin 指令 的 用 法 . ] 


》》2.8.5 param 指令 


param 指令 用 于 设置 参数 值 ， 这 个 指令 本 身 不 能 单独 使 用 ， 因 为 单独 的 param 指令 没有 实际 意义 。 
param 指令 可 以 与 以 下 三 个 指令 结合 使 用 。 

> jsp:iinclude 

> jsp:forward 

> jsp:plugin 

当 与 include 指令 结合 使 用 时 ，param 指令 用 于 将 参数 值 传 入 被 导入 的 页 面 ， 当 与 forward 指令 结 
合 使 用 时 ，param 指令 用 于 将 参数 值 传 入 被 转向 的 页 面 ， 当 与 plugin 指令 结合 使 用 时 ， 则 用 于 将 参数 
传 入 页 面 中 的 JavaBean 实例 或 Applet 实例 。 

param 指令 的 语法 格式 如 下 : 


<jsp:param name="paramName" value="paramValue"/> 


关于 param 的 具体 使 用 ， 请 参考 前 面 的 示例 。 


2.9 JSP 脚本 中 的 9 个 内 置 对 象 

JSP 脚本 中 包含 9 个 内 置 对 象 ， 这 9 个 内 置 对 象 都 是 Servlet API 接口 的 实例 ， 只 是 JSP 规范 对 它 
们 进行 了 默认 初始 化 〈 由 JSP 页 面 对 应 Servlet 的 _jspService0 方 法 来 创建 这 些 实例 )。 也 就 是 说 ， 它 们 
已 经 是 对 象 ， 可 以 直接 使 用 。9 个 内 置 对 象 依次 如 下 。 
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> ”application: javax.servlet.ServletContext 的 实例 ， 该 实例 代表 JSP 所 属 的 Web 应 用 本 身 ， 
可 用 于 JSP 页 面 ,或 者 在 Servlet 之 问 交换 信息 .常用 的 方法 有 getAttribute(String attName)、 
setAttribute(String attName , String attValue) 和 getlnitParameter(String paramName) 等 。 

> ”config: javax.servlet.ServletConfig 的 实例 ， 该 实例 代表 该 JSP 的 配置 信息 。 常 用 的 方法 有 
getlnitParameter(String paramName) 和 getinitParameternames() 等 方法 。 事 实 上 ，JSP 页 
面 通 常 无 须 配置 ， 也 就 不 存在 配置 信息 。 因 此 ， 该 对 象 更 多 地 在 Servlet 中 有 效 。 

> ”exception: java.lang.Throwable 的 实例 ,该 实例 代表 其 他 页 面 中 的 异常 和 错误 。 只 有 当 页 面 
是 错误 处 理 页 面 ， 即 编译 指令 page 的 isErrorPage 属性 为 true 时 ， 该 对 象 才 可 以 使 用 。 常 
用 的 方法 有 getMessage() 和 printStackTrace() 等 。 

> ”out: javax.servletjsp.JspWriter 的 实例 ， 该 实例 代表 JSP 页 面 的 输出 流 ， 用 于 输出 内 容 ， 
形成 HTML 页 面 。 

> “page: 代表 该 页 面 本 身 ， 通 常 没有 太 大 用 处 。 也 就 是 Servlet 中 的 this， 其 类 型 就 是 生成 的 
Servlet 类 ， 能 用 page 的 地 方 就 可 用 this。 

> ”pageContext: javax.servletjsp.PageContext 的 实例 ， 该 对 象 代表 该 JSP 页 面 上 下 文 ， 使 用 该 
对 象 可 以 访问 页 面 中 的 共享 数据 。 常 用 的 方法 有 getServietContext() 和 getServletConfig() 等 。 

> ”request: javax.servlet.http.HttpServletRequest 的 实例 ， 该 对 象 封装 了 一 次 请 求 ， 客 户 端的 
请 求 参 数 都 被 封装 在 该 对 象 里 。 这 是 一 个 常用 的 对 象 , 获取 客户 端 请 求 参数 必须 使 用 该 对 象 。 
常用 的 方法 有 getParameter(String paramName)、getParameterValues(String paramName)、 
setAttribute(String attrName,Object attrValue) 、 getAttribute(String attrName) 和 
setCharacterEncoding(String env) 等 。 

> response: javax.servlet.http.HttpServletResponse 的 实例 ， 代 表 服 务 器 对 客户 端的 响应 。 
通常 很 少 使 用 该 对 象 直接 响应 ， 而 是 使 用 out 对 象 ， 除 非 需要 生成 非 字符 响应 。 而 response 
对 象 常用 于 重 定向 ， 常 用 的 方法 有 getOutputStream() 、sendRedirect(ava .lang.String 
location) 等 。 

> session: javax.servlet.http.HttpSession 的 实例 ， 该 对 象 代表 一 次 会 话 。 当 客户 端 浏览 器 与 
站 点 建立 连接 时 ， 会 话 开始 ; 当 客 户 端 关 闭 浏览 器 时 ， 会 话 结束 。 常 用 的 方法 有 : 
getAttribute(String attrName)、setAttribute(String attrName, Object attrValue) 等 。 

进入 Tomeat 的 work\Catalina\localhost\jspPrinciple\org\apache\jsp 路 径 下 ， 打 开 任意 一 个 JSP 页 面 

对 应 生成 的 Servlet 类 文件 ， 看 到 如 下 代码 片段 : 

public final class test_jsp extends org.apache.jasper. runtime.HttpJspBase 

implements org.apache, jasper.runtime. JspSourceDependent { 


7/ 用 于 响应 用 户 请 求 的 方法 
public void _jspService (HttpServletRequest request, HttpServletResponse response) 
throws java.io.IOException, ServletException { 
PageContext pageContext = null; 
HttpSession session = null; 
ServletContext application = null; 
ServletConfig config = null; 
JspWriter out = null; 
Object page = this; 
JspWriter _jspx_out = null; 
PageContext _jspx_page_context = null7 
try { 


response.setContentType ("text/html; charset=gb2312"); 
PageContext = _jspxFactory.getPageContext (this, request, response, 
null, true, 8192, true); 
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jspx_page_context = pageContext; 
application = pageContext.getServletContext () ; 
config = pageContext.getServletConfig() ; 
session = pageContext.getSession(); 

out = PageContext.getOut() 7 


} 
} 


几乎 所 有 的 JSP 页 面 编译 后 Servlet 类 都 有 如 上 所 示 的 结构 ， 上 面 Servlet 类 的 粗 体 字 代 码 表明 : 
request、response 两 个 对 象 是 jspService0 方 法 的 形 参 ， 当 Tomcat 调用 该 方法 时 会 初始 化 这 两 个 对 象 。 
而 page、pageContext、application、config、session、out 都 是 _jspService() 方 法 的 局 部 变量 ， 由 该 方法 
完成 初始 化 。 

通过 上 面 的 代码 不 难 发 现 JSP 内 输 对 象 的 实质 : 它们 要 么 是 jspService0 方 法 的 形 参 ， 要 么 是 
_jspService() 方 法 的 局 部 变量 ， 所 以 我 们 直接 在 JSP 脚本 (脚本 将 对 应 于 Servlet 的 _jspService0 方 法 部 
分 ) 中 调用 这 些 对 象 ， 无 须 创 建 它 们 。 


EE “由 于 JSP 内 置 对 象 都 是 在 _jspService0 方 法 中 完成 初始 化 的 , 因此 只 能 在 JSP 脚本 、JSP : 
隐 史 输出 表达 式 中 使 用 这 些 内 置 对 象 。 千 万 不 要 在 JSP 声明 中 使 用 它们 ! 否则 ， 系 统 将 提示 找 | 
| 。 不 到 这 些 变量 . 
当 我 们 编写 JSP 页 面 时 ， 一 定 不 要 仅 停留 在 JSP 页 面 本 身 来 看 问题 ， 这 样 可 能 导致 许多 误解 ， 导 
致 我 们 无 法 理解 JSP 的 运行 方式 。 很 多 书籍 上 随意 介绍 这 些 对 象 ， 也 是 形成 误解 的 原因 之 一 。 
细心 的 读者 可 能 已 经 发 现 了 : 上面 的 代码 中 并 没有 exception 内 置 对 象 , 这 与 前 面 介绍 的 正好 相符 : 
只 有 当 页 面 的 page 指令 的 isErrorPage 属性 为 true 时 ， 才 可 使 用 exception 对 象 。 也 就 是 说 ， 只 有 异常 
处 理 页 面 对 应 Servlet 时 才 会 初始 化 exception 对 象 。 


> >2.9.1 application 对 象 


在 介绍 application 对 象 之 前 ， 先 简单 介绍 一 些 Web 服务 器 的 实现 原理 。 虽 然 绝 大 部 分 读者 都 不 需 
要 、 甚 至 不 曾 想 过 自己 开发 Web 服务 器 ， 但 了 解 一 些 Web 服务 器 的 运行 原理 ， 对 于 更 好 地 掌握 JSP 
知识 将 有 很 大 的 帮助 。 

虽然 常 把 基于 Web 应 用 称 为 B/S (Browser/Server) 架构 的 应 用 ， 但 其 实 Web 应 用 一 样 是 C/S 
(Client/Server) 结构 的 应 用 ， 只 是 这 种 应 用 的 服务 器 是 Web 服务 器 ， 而 客户 端 是 浏览 器 。 

现在 我 们 抛 开 Web 应 用 直接 看 Web 服务 器 和 浏览 器 ， 对 于 大 部 分 浏览 器 而 言 ， 它 通常 负责 完成 
三 件 事情 : 

(1) 向 远程 服务 器 发 送 请 求 。 

(2) 读 取 远程 服务 器 返回 的 字符 串 数据 。 

(3) 负责 根据 字符 串 数据 泻 染 出 一 个 丰富 多 彩 的 页 面 。 


rg 浏览 器 是 一 个 非常 复杂 的 网 络 通信 程序 ， 它 除了 可 以 向 服务 器 发 送 请 求 、 庄 ! 
取 网 络 数据 之 外 ,最 大 的 技术 难点 在 于 将 HTML 文本 泻 染 成 页 面 ,建立 HTML 页 面 的 DOM | 

| ”模型 支持 JavaScript 脚本 程序 等 . 通常 浏览 器 有 Internet Explorer、FireFox、Opera 等 ， 

”至 手 其 他 如 MyIE、 例 游 等 浏览 器 可 能 只 是 对 它们 进行 了 简单 的 包装 . | 
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Web 服务 器 则 负责 接收 客户 端 请 求 ， 每 当 接收 到 客户 端 连接 请 求 之 后 ，Web 服务 器 应 该 使 用 单独 
的 线程 为 该 客户 端 提 供 服务 : 接收 请 求 数据 、 送 回响 应 数据 。 图 2.16 显示 了 Web 服务 器 的 运行 机 制 。 


ec 


图 2.16 ”Web 服务 器 运行 机 制 


如 图 2.16 所 示 的 应 用 架构 总 是 先 由 客户 端 发 送 请 求 ， 服 务 器 接收 到 请 求 后 送 回响 应 的 数据 ， 所 以 
也 将 这 种 架构 称 做 “请 求 /响应 ”架构 。 根 据 如 图 2.16 所 示 的 机 制 进行 归纳 ， 对 于 每 次 客户 端 请 求 而 
言 ，Web 服务 器 大 致 需要 完成 如 下 几 个 步骤 : 
人 启动 单独 的 线程 。 
全 使 用 LO 流 读 取 用 户 的 请 求 数据 。 
他 从 请 求 数据 中 解析 参数 。 
@ 处 理 用 户 请 求 。 
人 @ 生成 响应 数据 。 
多 使 用 IO 流向 客户 端 发 送 请 求 数据 。 
在 上 面 6 个 步骤 中 , 第 1、2 和 6 步 是 通用 的 ， 可 以 由 Web 服务 器 来 完成 ， 但 第 3、4 和 5 步 则 存 
在 差异 ， 因 为 不 同 请 求 里 包含 的 请 求 参数 不 同 ， 处 理 用 户 请 求 的 方式 也 不 同 ， 所 生成 的 响应 自然 也 不 
同 。 那 么 Web 服务 器 到 底 如 何 执行 第 3、4 和 5 步 呢 ? 
实际 上 ，Web 服务 器 会 调用 Servlet 的 _jspService0 方 法 来 完成 第 3、4 和 5 步 ， 当 我 们 编写 JSP 
页 面 时 ， 页 面 里 的 静态 内 容 、JSP 脚本 都 会 转换 成 jspService0 方 法 的 执行 代码 ， 这 些 执行 代码 负责 
完成 解析 参数 、 处 理 请 求 、 生 成 响应 等 业务 功能 ， 而 Web 服务 器 则 负责 完成 多 线程 、 网 络 通信 等 底 
层 功能 。 
Web 服务 器 在 执行 了 第 3 步 解析 到 用 户 的 请 求 参 数 之 后 ， 将 需要 通过 这 些 请 求 参数 来 创建 
HttpServletRequest、HttpServletResponse 等 对 象 ， 作 为 调用 _jspService0 方 法 的 参数 ， 实 际 上 一 个 Web 
服务 器 必须 为 Servlet API 中 绝 大 部 分 接口 提供 实现 类 。 
从 上 面 介绍 可 以 看 出 ，Web 应 用 里 的 JSP 页 面 、Servlet 等 程序 都 将 由 Web 服务 器 来 调用 ，JSP、 
Servlet 之 间 通 常 不 会 相互 调用 ， 这 就 产生 了 一 个 问题 : JSP、Servlet 之 间 如 何 交 换 数 据 ? 
为 了 解决 这 个 问题 ， 几 乎 所 有 Web 服务 器 (包括 Java、ASP、PHP、Ruby 等 ) 都 会 提供 4 个 类 似 
Map 的 结构 ， 分 别 是 application、session、request、page， 并 允许 JSP、Servlet 将 数据 放 入 这 4 个 类 似 
Map 的 结构 中 ， 并 允许 从 这 4 个 Map 结构 中 取出 数据 。 这 4 个 Map 结构 的 区 别 是 范围 不 同 。 
> application: 对 于 整个 Web 应 用 有 效 ， 一 旦 JSP、Servlet 将 数据 放 入 application 中 ， 该 数 
据 将 可 以 被 该 应 用 下 其 他 所 有 的 JSP、Servlet 访问 。 

> ”session: 仅 对 一 次 会 话 有 效 ， 一 旦 JSP、Servlet 将 数据 放 入 session 中 ， 该 数据 将 可 以 被 
本 次 会 话 的 其 他 所 有 的 JSP、Servlet 访问 。 

> request: 仅 对 本 次 请 求 有 效 ， 一 旦 JSP、Servlet 将 数据 放 入 request 中 ， 该 数据 将 可 以 被 
该 次 请 求 的 其 他 JSP、Servlet 访问 。 
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> ”page: 仅 对 当前 页 面 有 效 ， 一 旦 JSP、Servlet 将 数据 放 入 page 中 ， 该 数据 只 可 以 被 当前 页 
面 的 JSP 脚本 、 声 明 部 分 访问 。 

就 像 现 实生 活 中 有 两 个 人 ， 他 们 的 钱 需 要 相互 交换 ， 但 他 们 两 个 人 又 不 能 相互 接触 ， 那 么 只 能 让 
A 把 钱 存 入 银行 ， 而 B 从 银行 去 取 钱 。 因 此 ， 我 们 可 以 把 application、session 、request 和 page 理解 为 
类 似 银行 的 角色 。 

把 数据 放 入 application、session、request 或 page 之 后 ， 就 相当 于 扩大 了 该 数据 的 作用 范围 ， 所 以 
我 们 也 认为 application、session、request 和 page 中 的 数据 分 别处 于 application 、session 、request 和 page 
范围 之 内 。 

JSP 中 的 application .session ,request 和 pageContext 4 个 内 署 对 象 分 别 用 于 操作 application session、 
request 和 page 范围 中 的 数据 。 

application 对 象 代表 Web 应 用 本 身 ， 因 此 使 用 application 来 操作 Web 应 用 相关 数据 。application 
对 象 通常 有 如 下 两 个 作用 :， 

> ”在 整个 Web 应 用 的 多 个 JSP、Servlet 之 间 共 享 数据 。 

> 访问 Web 应 用 的 配置 参数 。 

1. 让 多 个 JSP、Servlet 共享 数据 

application 通过 setAttribute(String attrName,Object value) 方 法 将 一 个 值 设置 成 application 的 
attrName 属性 ， 该 属性 的 值 对 整个 Web 应 用 有 效 ， 因 此 该 Web 应 用 的 每 个 JSP 页 面 或 Servlet 都 可 以 
访问 该 属性 ， 访 问 属性 的 方法 为 getAttribute(String attrName)。 

看 下 面 的 页 面 ， 该 页 面 仅 仅 声明 了 一 个 整 型 变量 ， 每 次 刷新 该 页 面 时 ， 该 变量 值 加 1， 然 后 将 该 
变量 的 值 放 入 application 内 。 下 面 是 页 面 的 代码 。 

程序 清单 ，codes\02\2.9yspObject\put-application.jsp 

<48 page contentType="text/html; charset-GBK" language="java" errorPage="" > 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1,0 Transitional//EN" 
"http: //www.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://wuw.w3.org/1999/xhtml"> 
<head> 
<title>application 测试 </title> 
</head> 
<body> 


<!-- JSP 声 明 --> 
< 


> 
St 将 工 值 自 加 后 放 入 application 的 变量 内 -> 
< 


application. setAttribute("counter", String.valueOf (++1)); 
> 

<!-- 输出 奔 值 --> 

二 和 > 

</body> 

</html> 


以 上 页 面 的 粗 体 字 代 码 实现 了 每 次 刷新 该 页 面 时 ， 变 量 i 都 先 自 加 ， 并 被 设置 为 application 的 
counter 属性 的 值 ， 即 每 次 application 中 的 counter 属性 值 都 会 加 1。 
再 看 下 面 的 JSP 页 面 ， 该 页 面 可 以 直接 访问 到 application 的 counter 属性 值 。 
程序 清单 ，codes\02\2.9YjspObject\get-applicationjsp 
<3@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1:0 Transitional//EN" 
"http://wwuw.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title>application 测试 </title> 
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</head> 
<body> 
<!-- 直接 输出 application 变量 值 --> 
<4=application.getAttribute ("counter") %> 
</body> 
</html> 
以 上 页 面 中 粗 体 字 代码 直接 输出 application 的 counter 属性 值 ， 虽然 这 个 页 面 和 put-application.jsp 
没有 任何 关系 ,但 它 一 样 可 以 访问 到 application 的 属性 ， 因 为 application 的 属性 对 于 整个 Web 应 用 的 
JSP、Servlet 都 是 共享 的 。 
在 浏览 器 的 地 址 栏 中 访问 第 一 个 put-application.jsp 页 面 ， 经 多 次 刷新 后 ， 看 到 如 图 2.17 所 示 的 


页 面 。 


图 2.17 将 变量 值 放 入 application 中 


访问 get-application.jsp 页 面 ， 也 可 看 到 类 似 于 图 2.17 所 示 的 效果 ， 因 为 get-application,jsp 页 面 可 
以 访问 application 的 counter 属性 值 。 


和 
天 - 注意: 
application 不 仅 可 以 用 于 两 个 JSP 页 面 之 间 共 享 数据 ， 还 可 以 用 于 Servlet 和 JSP 之 
间 共 享 数据 。 我 们 可 以 把 application 理解 成 一 个 Map 对 象 ， 任 何 JSP、Servlet 都 可 以 把 


让 


某 个 变量 放 入 application 中 保存 ,并 为 之 指定 一 个 属性 名 ; 而 该 应 用 里 的 其 他 JSP、Serviet 


就 可 以 根据 该 属性 名 来 得 到 这 个 变量 


下 面 的 Servlet 代码 示范 了 如 何在 Servlet 中 访问 application 里 的 变量 。 
程序 清单 :codes\02W2.9\jspObject\WEB-INF\src\lee\GetApplication.java 
QNebServlet (name="get-application", 
urlPpatterns={"/get-application"}) 
public class GetApplication extends BttpServlet 
{ 


public void service (HttpServletRequest request, 
HttpServletResponse response)throws IOException 

{ 
response. setContentType ("text/html; charset=gb2312"); 
PrintWriter out = response.getWriter(); 
out .println ("<html><head><title>") 7 
out ,println ("测试 application"); 
out .printin("</title></head><body>"); 
ServletContext sc = getServletConfig () .getservletContext(); 
out .print ("application 中 当前 的 counter 值 为 :"); 
out .println (sc.getAttribute ("counter")) ; 
out.println("</body></html>"); 

} 

} 


由 于 在 Servlet 中 并 没有 application 内 置 对 象 , 所 以 上 面 程序 第 一 行 粗 体 字 代 码 显 式 获取 了 该 Web 
应 用 的 ServietContext 实 例 ,每 个 Web 应 用 只 有 一 个 ServietContext 实 例 ,在 JSP 页 面 中 可 通过 application 
内 署 对 象 访问 该 实例 ， 而 Servlet 中 则 必须 通过 代码 获取 。 程 序 第 二 行 粗 体 字 代码 访问 、 输 出 了 
application 中 的 counter 变量 。 
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该 Servlet 类 同样 需要 编译 成 class 文 件 才 可 使 用 ,实际 上 该 Servlet 还 使 用 了 @WebServlet 
Annotation 进行 部 署 ， 关 于 Servlet 的 用 法 请 参看 2.10 节 。 编译 Servlet 时 可 能 由 于 没有 
添加 环境 出 现 异常 ， 如 果 安 装 了 Java EE 6 SDK， 只 需 将 Java EE 6 SDK 路 径 的 javaee.jar 
文件 添加 到 CLASSPATH 环境 变量 中 ; 如 果 没 有 安装 Java EE SDK， 可 以 将 Tomcat 7 的 本 


lib 路 径 下 的 jsp-api.jar、servlet-al 两 个 文件 添加 到 CLASSPATH 环境 变量 中 。 


将 Servlet 部 署 在 Web 应 用 中 ， 在 浏览 器 中 访问 Servlet， 出 现 如 图 2.18 所 示 的 页 面 。 


application 中 当前 的 counter 值 为 7 


图 2.18 Servlet 访问 application 变量 
最 后 要 指出 的 是 :虽然 使 用 application 〈 即 ServletContext 实例 ) 可 以 方便 多 个 JSP、Servlet 共享 


数据 ， 但 不 要 仅 为 了 JSP、Servlet 共享 数据 就 将 数据 放 入 application 中 ! 由 于 application 代表 整个 


Web 应 用 ， 所 以 通常 只 


数据 库 ， 但 ; 
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把 Web 应 用 的 状态 数据 放 入 application 里 。 

2. 获得 Web 应 用 配置 参数 

application 还 有 一 个 重要 用 处 : 可 用 于 获得 Web 应 用 的 配置 参数 。 看 如 下 JSP 页 面 ， 该 页 面 访问 

问 数据 库 所 使 用 的 驱动 、URL、 用 户 名 及 密码 都 在 web.xml 中 给 出 。 

程 上 codes\02\2.9\jspObject\getWebParam.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 

<%@ page import="java.sql.*" 和 > 

<!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head> 


<title>application 测试 </title> 
</head> 


< 

7/ 从 配置 参数 中 获取 驱动 

String driver = application.getInitParameter ("driver") ; 

// 从 了 配置 参数 中 获取 数据 库 url 

String url = application.getInitParameter ("url"); 

// 从 配置 参数 中 获取 用 户 名 

String user = application.getInitParameter ("user"); 

// 从 配置 参数 中 获取 密码 

String pass = application.getInitParameter ("pass"); 
// 注 册 了 驱动 

Class. forName (driver); 

// 获 取 数 据 库 连接 

Connection conn = DriverManager.getConnection(url,user,pass); 
// 创 建 Statement 对 象 

Statement stmt = conn.createstatement (); 

// 执 行 查询 

ResultSet rs = stmt.executeQuery("select * from news_inf"); 
> 

<table bgcolor="#9999dd" border="1" width="480"> 


< 
// 遍 历 结果 集 
while{rs.next ()) 
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> 
<tr> 
<td><%=rs.getstring (1) ></td> 
<td><$=rs.getString (2)%></td> 
</tr> 
< 
} 
> 
<table> 
</body> 
</html> 


上 面 的 程序 中 粗 体 字 代码 使 用 application 的 getInitParameter(String paramName) 来 获取 Web 应 用 的 
配置 参数 , 这些 配 置 参数 应 该 在 web.xml 文件 中 使 用 context-param 元 素 配 置 , 每 个 <context-param.…/> 
元 素 配置 一 个 参数 ， 该 元 素 下 有 如 下 两 个 子 元 素 。 

> param-name: 配置 Web 参数 名 。 

> param-value: 配置 Web 参数 值 。 

web.xml 文件 中 使 用 <context-param... 人 > 元 素 配 置 的 参数 对 整个 Web 应 用 有 效 , 所 以 也 被 称 为 Web 
应 用 的 配置 参数 。 与 整个 Web 应 用 有 关 的 数据 ， 应 该 通过 application 对 象 来 操作 。 
为 了 给 Web 应 用 配置 参数 ， 应 在 web.xml 文件 中 增加 如 下 片段 。 
程序 清单 : codes\02\2.9\jspObject\WEB-INF\web.xml 
<!-- 配置 第 一 个 参数 : driver 一 -> 
<context-param> 
<param-name>driver</param-name> 
‘<param-value>com.mysql.jdbc. Driver</param-value> 
</context-param> 
<!-- 配置 第 二 个 参数 ，url --> 
<context-param> 
<param-name>ur1</param-name> 
<param-value>jdbc:mysql://l0calhost:3306/javaee</param-value> 
</context-param> 
三 个 参数 ，user --> 
aam> 
<param-name>user</param-name> 
<param-value>root</paran-value> 
ram> 
<!-- 配置 第 四 个 参数 : pass --> 
<context-param> 
<param-name>pass</param-name> 
<param-value>32147</param-value> 
</context-param> 


在 浏览 器 中 浏览 getWebParam.jsp 页 面 时 ， 可 看 到 数据 库 连接 、 数 据 查 询 完全 成 功 。 可 见 ， 使 用 
application 可 以 访问 Web 应 用 的 配置 参数 。 


表 . 
浅 - 注意 :着 … 
通过 这 种 方式 ， 可 以 将 一 些 配置 信息 放 在 web.xml 文件 中 配置 ， 避 免 使 用 硬 编码 方 bd 


式 写 在 代码 中 ， 从 而 更 好 地 提高 程序 的 移植 性 。 


> >2.9.2 config 对 象 


config 对 象 代表 当前 JSP 配置 信息 ， 但 JSP 页 面 通常 无 须 配 置 ， 因 此 也 就 不 存在 配置 信息 。 该 对 
象 在 JSP 页 面 中 比较 少 用 ， 但 在 Servlet 中 则 用 处 相对 较 大 ， 因 为 Serviet 需要 在 web.xml 文件 中 进行 
配置 ， 可 以 指定 配置 参数 。 关 于 Servlet 的 使 用 将 在 2.10 节 介绍 。 

看 如 下 JSP 页 面 代码 ， 该 JSP 代码 使 用 了 config 的 一 个 方法 getServletName()。 

程序 清单 : codes\02\2.9YjspObject\configTestjsp 
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<se page contentType="text/html; charset=GBK" language="java" errorPage="" 和 > 
<!DOCTYPE html PUBLIC "-//W3C//DID XBTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional,dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 测 试 config 内 置 对 象 </title> 
</head> 
<body> 
<!-- 直接 输出 config 的 getservletName 的 值 --> 
<%=config.getServletName () > 
</body> 
</html> 
上 面 的 代码 中 粗 体 字 代 码 输出 了 config 的 getServletName0 方 法 的 返回 值 , 所 有 的 JSP 页 面 都 有 相 
同 的 名 字 : jsp， 所 以 粗 体 字 代 码 输出 为 jsp。 
实 我 们 也 可 以 在 web.xml 文件 中 配置 JSP (只 是 比较 少 用 )， 这 样 就 可 以 为 JSP 页 面 指定 配 
4， 并 可 为 JSP 页 面 另外 设置 一 个 URL。 
config 对 象 是 ServletConfig 的 实例 ， 该 接口 用 于 获取 配置 参数 的 方法 是 getInitParameter(String 
paramName)。 下 面 的 代码 示范 了 如 何在 页 面 中 使 用 config 获取 JSP 配置 参数 。 
程序 清单 : codes\02\2.9\jspObject\configTest2.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head> 
<title> 测 试 config 内 置 对 象 </title> 
</head> 
<body> 
<!-- 输出 该 JSP 名 为 name 的 配置 参数 --> 
name 配置 参数 的 值 :<%=config.getInitParameter ("name")$><br/> 
<!-- 输出 该 JSP 名 为 age 的 配置 参数 ~-> 
age 配置 参数 的 值 : <%=config.getInitParameter ("age")%> 
</body> 
</html> 


上 面 的 代码 中 两 行 粗 体 字 代 码 输出 了 config 的 getInitParameter0 方 法 返回 值 ,它们 分 别 获取 name、 
age 两 个 配置 参数 的 值 。 

配置 JSP 也 是 在 web.xml 文件 中 进行 的 ,JSP 被 当成 Servlet 配 置 ,为 Servlet 配置 参数 使 用 init-param 
元 素 ， 该 元 素 可 以 接受 param-name 和 param-value 两 个 子 元 素 ， 分 别 指定 参数 名 和 参数 值 。 

在 web.xml 文件 中 增加 如 下 配置 片段 ， 即 可 将 JSP 页 面 配置 在 Web 应 用 中 。 


<servlet> 
<!-- 指定 Servlet 名 字 --> 
<servlet-name>config</servlet-name> 
<!-- 指定 将 哪个 JSP 页 面 配置 成 Servlet -> 
<jsp-file>/configTest2.jsp</jsp-file> 
<!-- 配置 名 为 name 的 参数 ， 值 为 yeeku -> 
<init-param> 
<param-name>name</param-name> 
<param-value>yeeku</param-value> 
</init-param> 
<!-- 配置 名 为 age 的 参数 ， 值 为 30 --> 
<init-param> 
<param-name>age</param-name> 
<param-value>30</param-value> 
</init-param> 
</serviet> 
<servlet-mapping> 
<!-- 指定 将 config Servlet 配置 到 /config 路 径 --> 
<servlet-name>config</servlet-name> 
<url-pattern>/config</url-pattern> 
</servlet-mapping> 
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上 面 的 配置 文件 片段 中 粗 体 字 代码 为 该 Servlet (其 实 是 JSP) 配置 了 2 个 参数 : name 和 age。 上 
面 的 配置 片段 把 configTest2.jsp 页 面 配置 成 名 为 config 的 Servlet， 并 将 该 Servlet 映射 到 /config 处 ， 这 
就 允许 我 们 通过 /config 来 访问 该 页 面 。 在 浏览 器 中 访问 /config 看 到 如 图 2.19 所 示 的 界面 。 


图 2.19 输出 JSP 配置 参数 值 


从 图 2.19 中 可 以 看 出 ,通过 config 可 以 访问 到 web.xml 文件 中 的 配置 参数 。 实 际 上 ， 我 们 也 可 以 
直接 访问 configTest2jsp 页 面 ， 在 浏览 器 中 访问 该 页 面 将 看 到 如 图 2.20 所 示 的 界面 。 


a a 


图 2.20 直接 访问 JSP 页 面 将 不 能 访问 配置 参数 


对 比 图 2.19 和 2.20 不 难看 出 , 如果 希 望 JSP 页 面 可 以 获取 web.xml 配置 文件 中 的 配置 信息 , 则 必 
须 通 过 为 该 JSP 配置 的 路 径 来 访问 该 页 面 ， 因 为 只 有 这 样 访问 JSP 页 面 才 会 让 配置 参数 起 作用 。 


> 2.9.3 ”exception 对 象 


exception 对 象 是 Throwable 的 实例 ， 代 表 JSP 脚本 中 产生 的 。 妆 
错误 和 异常 ， 是 JSP 页面 异 常 机 制 的 一 部 分 。 wt ) 们 订 责 而 
在 JSP 脚本 中 无 须 处 理 异常 ， 即 使 该 异常 是 checked 异常 。 。 1a Crewe seceptaem 
事实 上 ,JSP 脚本 包含 的 所 有 可 能 出 现 的 异常 都 可 交 给 错误 处 理 页 /ema 
面 处 理 。 
看 如 图 2.21 所 示 的 异常 处 理 结构 ， 这 是 典型 的 异常 捕捉 处 理 图 2.21 异常 处 理 结构 
块 。 在 JSP 页 面 中 ,普通 的 JSP 脚本 只 执行 第 一 个 部 分 一 一 代码 处 
理 段 ， 而 异常 处 理 页 面 负责 第 二 个 部 分 一 一 异常 处 理 段 。 在 异常 处 理 段 中 ， 可 以 看 到 有 个 异常 对 象 ， 该 
i exception, 


六. 注重 ee 
exception 对 象 仅 在 异常 处 理 页 面 中 才 有 效 ， 通过 前 面 的 异常 处 理 结构 ， 读者 可 以 非 要 


晰 地 看 出 这 点 


打开 普通 JSP 页 面 所 生成 的 Servlet 类 ， 将 可 以 发 现 如 下 代码 片段， 


public void jspservice (HttpServletRequest request，HttpServletResponse response) 
throws java.io.IOException，ServletException { 


{ 
// 所 有 JSP 脚本 、 静 态 HTML 部 分 都 会 转换 成 此 部 分 代码 
response. setContentType ("text/html; charset=gb2312"); 
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out .Write ("</body>\r\n"); 
out .write ("</html>\r\n"); 
} catch (Throwable t) { 
7 处理 该 异常 
if (jspx_page_context != null) _jspx_page_context.handlePageException(t); 
} finally { 
7/ 释放 资源 
_jspxFactory. releasePageContext (_jspx_page_context); 
} 
1 
从 上 面 代码 的 粗 体 字 代 码 中 可 以 看 出 , JSP 脚本 和 静态 HTML 部 分 都 将 转换 成 jspService0 方 法 里 
的 执行 性 代 三 - 旦 try 块 
捕捉 到 JSP 脚本 的 异常 ， 并 且 _jspx_page_context 不 为 null， 就 会 由 该 对 象 来 处 理 该 异常 ， 如 上 面 粗 体 
字 代 码 所 示 。 
_jspx_page_context 对 异常 的 处 理 也 非常 简单 : 如 果 该 页 面 的 page 指令 指定 了 errorPage 属性 ， 则 
将 请 求 forward 到 errorPage 属性 指定 的 页 面 ， 否 则 使 用 系统 页 面 来 输出 异常 信息 。 


玉昌 


由 于 只 有 JSP 脚本 、 输出 表达 式 才 会 对 应 于 jspService0 方 法 里 的 代 三 ， 所 以 这 两 个 | 
部 分 的 代码 无 须 处 理 checked 异常 但 JSP 的 声明 部 分 依然 需要 处 理 checked 异常 ，JSP 
的 异常 处 理 机 制 对 JSP 声明 不 起 作用 . 


常 处 理 机 制 中 ， 一 个 异常 处 理 页 面 可 以 处 理 多 个 JSP 页 面 脚本 部 分 的 异常 。 异 常 处 理 
页 面 通过 page 指令 的 errorPage 属性 确定 

下 面 的 页 面 再 次 测试 了 JSP 脚本 的 异常 机 制 。 
清 单 : codes\02\2.9YjspObject\throwExjsp 


<!-- 通过 errorPage 属性 指定 异常 处 理 页 面 --> 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="error.jsp" %> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www:w3.0org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
<title> JSP 脚本 的 异常 机 制 </title> 

</head> 

<body> 

< 

int a= 6; 

int c=a/ 0; 

> 


</body> 
</html> 
以 上 页 面 的 粗 体 字 代码 将 抛 出 一 个 ArithmeticEception, 则 JSP 异常 机 制 将 会 转发 到 errorjsp 页 面 ， 
errorjsp 页 面 代码 如 下 。 
程序 清单 : codes\02\2.9\jspObject\errorjsp 
<$@ page contentType="text/html; charset=GBK" language="java" isErrorpaye="trUie" $§> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http;//www.w3.0rg/1999/xhtml"> 
<head> 
<title> 异常 处 理 页 面 </title> 
</head> 
<body> 
<%=exception.getCclass ()$><br/> 


异常 类 型 是 :<%=exception 
异常 信息 是 :<%=exception.getMessage ()$><br/> 
</body> 
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</html> 
以 上 页 面 page 指令 的 isErrorPage 属性 被 设 为 mue， 则 可 以 通过 exception 对 象 来 访问 上 一 个 页 面 
所 出 现 的 异常 。 在 浏览 器 中 请 求 throwEx:jsp 页 面 ， 将 看 到 如 图 2.22 所 示 的 界面 。 


异常 信息 是 :/ by zero 


图 2.22 使 用 exception 对 象 
打开 errorjsp 页 面 生成 的 Servlet 类 ， 在 _jspService0 方 法 中 发 现 如 下 代码 片段 : 


public void _jspService (HttpServletRequest request, HttpServlietResponse response) 
throws java.io.IOException, ServletException { 
PageContext pageContext = null; 
HttpSession session = null; 
// 初 始 化 exception 对 象 
‘Throwable exception = org.apache. jasper.runtime. 
JspRuntimeLibrary .getThrowable (request) 7 
if (exception != null) { 
tStatus (HttpServletResponse. SC_INTERNAL_SERVER_ERROR) ; 


从 以 上 代码 片段 的 粗 体 字 代码 中 可 以 看 出 ， 当 JSP 页 面 page 指令 的 isErrorPage 为 tue 时 ， 该 页 


面 就 会 提供 exception 内 置 对 象 。 


out 对 象 代表 一 个 页 面 输出 流 ， 通 常用 于 在 页 面 上 输出 变量 值 及 常量 。 一 般 在 使 用 输出 表达 式 的 
地 方 ， 都 可 以 使 用 out 对 象 来 达到 同样 效果 。 

看 下 面 的 JSP 页 面 使 用 out 来 执行 输出 。 

程序 清单 : codes\02\2.9\jspObject\outTest.jsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" 4> 
<%@ page import="java.sql.#w $> 
<!DOCTYPE html PUBLIC "~/JW3C//DTD XHTML 1,0 Transitional//EN" 
"http: //waw.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> out 测试 </title> 
</head> 


应 将 异常 处 理 页 面 中 page 指令 的 ErrorPage 属性 设置 为 true. 
属性 设置 为 true 时 才 可 访问 exception 内 置 对 象 


只 有 当 isErrorPage 


> 2.9.4 out 对 象 


// 注 册 数据 库 驱动 

Class. forName ("com.mysql.jdbce. Driver™); 

// 获 取 数据 库 连 接 

Connection conn ~ DriverManager.getConnectiont 
"jdbe:mysql://localhost:3306/javaee", "root", «32147"); 

// 创 建 Statement 对 象 

Statement stmt = conn.createstatement (); 

// 执 行 查询 ， 获 取 ResultSet 对 象 
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ResultSet rs = stmt.executeQuery{"select * from news_inf"); 
> 
<table bgcolor="#9999dd" border="l” width="400"> 


< 
// 遍 历 结果 集 
while (rs.next ()) 


{ 
// 输 出 表格 行 
out.println("<tr>"); 
// 输 出 表格 列 
out .println("<td>"); 
// 输 出 结果 集 的 第 二 列 的 值 
out.printin(rs.getstring (1)); 
// 关 闭 表格 列 
out.println ("</td>"); 
// 开 始 表格 列 
out.printin("<td>"); 
// 输 出 结果 集 的 第 三 列 的 值 
out.println(rs.getString(2))7 
// 关 闭 表格 列 
out.println("</td>"); 
// 关 闭 表格 行 
out ,println("</tr>"); 

} 

> 

<table> 

</body> 

</html> 


从 Java 的 语法 上 看 ， 上 面 的 程序 更 容易 理解 ，out 是 个 页 面 输出 流 ， 负 责 输出 页 面 表 格 及 所 有 内 
容 ， 但 使 用 out 则 需要 编写 更 多 代码 。 
-本 .注意 : 
所 有 使 用 out 的 地 方 ， 都 可 使 用 输出 表达 式 来 代替 ， 而 且 使 用 输出 表达 式 更 加 


<%= ...%> 表 达 式 的 本 质 就 是 out.write(...);。 通 过 out 对 象 的 介绍 ， 读 者 可 以 更 好 地 理解 本 


| 。 输出 表达 式 的 原理 


2.9.5 pageContext 对 象 


这 个 对 象 代表 页 面 上 下 文 ， 该 对 象 主要 用 于 访问 JSP 之 间 的 共享 数据 。 使 用 pageContext 可 以 访 
问 page、request、session、application 范围 的 变量 。 

pageContext 是 PageContext 类 的 实例 ， 它 提供 了 如 下 两 个 方法 来 访问 page、request、session、 
application 范围 的 变量 。 

> getAttribute(String name): 取得 page 范围 内 的 name 属性。 

> ”getAttribute(String name,int scope): 取得 指定 范围 内 的 name 属性 ， 其 中 scope 可 以 是 如 

下 4 个 值 。 

> PageContext.PAGE_SCOPE: 对 应 于 page 范围 。 

> PageContext.REQUEST_SCOPE: 对 应 于 request 范围 。 

> PageContext.SESSION_SCOPE: 对 应 于 session 范围 。 

> PageContext.APPLICATION_SCOPE: 对 应 于 application 范围 。 

与 getAttribute() 方 法 相对 应 ，PageContext 也 提供 了 2 个 对 应 的 setAttribute0 方 法 ， 用 于 将 指定 变 
量 放 入 page、request、session、application 范围 内 。 

下 面 的 JSP 页 面 示范 了 使 用 pageContext 来 操作 page、request、session、application 范围 内 的 变量 。 

程序 清单 : codes\02\2.9\jspObject\pageContextTest.jsp 
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<s8 page contentType="text/html; charset=GBK" language="java" errorpage="" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3,0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd™> 
<html xmlns="http://wuw.w3.0rg/1999/xhtml"> 
<head> 
<title> pageContext 测试 </title> 
</head> 
<body> 
< 
// 使 用 pageCcontext 设置 属性 ， 该 属性 默认 在 page 范围 内 
pageContext. setAttribute ("page", "hello") 7 
// 使 用 request 设置 属性 ， 该 属性 默认 在 request 范围 内 
request. setAttribute ("request", "hello"); 
// 使 用 pageContext 将 属性 设置 在 request 范围 中 
pageContext. setAttribute ("request2", "hello" 
ontext .REQUEST_SCOPE) ; 
// 使 用 session 将 属性 设置 在 session 范围 中 
session. setAttribute ("session", "hello"); 
// 使 用 pageCcontext 将 属性 设置 在 session 范围 中 
PageContext. setAttribute ("session2", "hello" 
, PageContext.SESSION_SCOPE) ; 
// 使 用 application 将 属性 设置 在 application 范围 中 
application, setAttribute("app", "hello"); 
// 使 用 pageContext 将 属性 设置 在 application 范围 中 
pageContext. setAttribute ("app2", "hello" 
, PageContext.APPLICATION_SCOPE) ; 
A/ 下 面 获取 各 属性 所 在 的 范围 : 
out .println ("page 变量 所 在 范围 ， ”+ 
pageContext.getAttributesscope ("page") + "<brV> 则 天 
out .println ("request 变量 所 在 范围 ，"”+ 
pageContext. getAttributesscope ("request") + "<br/>"); 
out .println ("request2 变量 所 在 范围 ; "+ 
pageContext.getAttributesscope("request2") + "<br/>"); 
out .println("session 变量 所 在 范围 ，”+ 
pageContext. getAttributesscope ("session") + "<br/>"); 
out .println ("session2 变量 所 在 范围 ”+ 
pageContext. getAttributesScope ("session2") + "<br/>"); 
out.println("app 变量 所 在 范围 : "+ 
pageContext. getAttributesscope ("app") + "<br/>"); 
out .println ("app2 变量 所 在 范围 ，"”+ 
pageContext.getAttributesscope ("app2") + "<br/>"); 
> 
</body> 
</html> 


以 上 页 面 的 粗 体 字 代 码 使 用 pageContext 将 各 变量 分 别 放 入 page、request、session、application 范 
围 内 ， 程 序 的 斜体 字 代 码 还 使 用 pageContext 获取 各 变量 所 在 的 范围 。 
浏览 以 上 页 面 ， 可 以 看 到 如 图 2.23 所 示 的 效果 。 


page 变 量 所 在 于 转 ，3 
2 


request 变 量 所 在 区 | 
在 


Tequesta 


六 
图 2.23 使 用 pageContext 操作 各 范围 属性 的 效果 


图 2.23 中 显示 了 使 用 pageContext 获取 各 属性 所 在 的 范围 ， 其 中 这 些 范围 获取 的 都 是 整 型 变量 ， 
这 些 整 型 变量 分 别 对 应 如 下 4 个 生存 范围 。 
1: 对 应 page 生存 范围 
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2: 对 应 request 生存 范围 。 
3: 对 应 session 生存 范围 。 
4: 对 应 application 生存 范围 。 
不 仅 如 此 ，pageContext 还 可 用 于 获取 其 他 内 置 对 象 ，pageContext 对 象 包含 如 下 方法 。 
ServletRequest getRequest(): 获取 request 对 象 。 

> ServletResponse getResponse(): 获取 response 对 象 。 

> ”ServletConfig getServletConfig(): 获取 config 对 象 。 

> ”ServletContext getServletContext()， 获取 application 对 象 。 

> HttpSession getSession(): 获取 session 对 象 。 

因此 一 旦 在 JSP、Servlet 编程 中 获取 了 pageContext 对 象 , 就 可 以 通过 它 提供 的 上 面 方法 来 获取 其 
他 内 置 对 象 。 


》》>2.9.6 request 对 象 


v 


request 对 象 是 JSP 中 重要 的 对 象 ， 每 个 request 对 象 封 装着 一 次 用 户 请 求 ， 并 且 所 有 的 请 求 参 数 
都 被 封装 在 request 对 象 中 ， 因 此 request 对 象 是 获取 请 求 参 数 的 重要 途径 。 

除 此 之 外 ，request 可 代表 本 次 请 求 范围 ， 所 以 还 可 用 于 操作 request 范围 的 属性 。 

1 获取 请 求 头 /请 求 参数 

Web 应 用 是 请 求 /响应 架构 的 应 用 ,浏览 器 发 送 请 求 时 通常 总 会 附带 一 些 请 求 头 ， 还 可 能 包含 一 些 
请 求 参数 发 送 给 服务 器 ， 服 务 器 端 负责 解析 请 求 头 /请 求 参 数 的 就 是 JSP 或 Servlet， 而 JSP 和 Servlet 
取得 请 求 参数 的 途径 就 是 request。request 是 HttpServletRequest 接口 的 实例 ， 它 提供 了 如 下 几 个 方法 
来 获取 请 求 参 数 。 

> String getParameter(String paramName): 获取 paramName 请 求 参数 的 值 。 

> “Map getParameterMap(): 获取 所 有 请 求 参数 名 和 参数 值 所 组 成 的 Map 对 象 。 

> “Enumeration getParameterNames(): 获取 所 有 请 求 参数 名 所 组 成 的 Enumeration 对 象 。 

> ”String[] getParameterValues(String name): paramName 请 求 参 数 的 值 ， 当 该 请 求 参 数 有 多 

个 值 时 ， 该 方法 将 返回 多 个 值 所 组 成 的 数组 。 

HttpServletRequest 提供 了 如 下 方法 来 访问 请 求 头 

> ”String getHeader(String name): 根据 指定 请 求 头 的 值 。 
> java.uti,Enumeration<String> getHeaderNames(): 获取 所 有 请 求 头 的 名 称 。 
> java.util.Enumeration<String> getHeaders(String name): 获取 指定 请 求 头 的 多 个 值 。 
> int getintHeader(String name): 获取 指定 请 求 头 的 值 ， 并 将 该 值 转 为 整数 值 。 
对 于 开发 人 员 来 说 ， 请 求 头 和 请 求 参数 都 是 由 用 户 发 送 到 服务 器 的 数据 ， 区 别 在 于 请 求 头 通常 由 
浏览 器 自动 添加 ， 因 此 一 次 请 求 总 是 包含 若干 请 求 头 ， 而 请 求 参数 则 通常 需要 开发 人 员 控制 添加 ， 让 
客户 端 发 送 请 求 参数 通常 分 两 种 情况 。 
> ”GET 方式 的 请 求 : 直接 在 浏览 器 地 址 栏 输入 访问 地 址 所 发 送 的 请 求 或 提交 表单 发 送 请 求 时 ， 
该 表单 对 应 的 form 元 素 没有 设置 method 属性 ， 或 设置 method 属性 为 get， 这 几 种 请 求 都 
是 GET 方 式 的 请 求 .GET 方式 的 请 求 会 将 请 求 参 数 的 名 和 值 转换 成 字符 串 , 并 附加 在 原 URL 
之 后 ， 因 此 可 以 在 地 址 栏 中 看 到 请 求 参 数 名 和 值 。 且 GET 请 求 传送 的 数据 量 较 小 ， 一 般 不 
能 大 于 2KB。 

> ”POST 方式 的 请 求 : 这 种 方式 通常 使 用 提交 表单 〈 由 form HTML 元 素 表示 ) 的 方式 来 发 送 ， 
且 需 要 设置 form 元 素 的 method 属性 为 post.POST 方式 传送 的 数据 量 较 大 ,通常 认为 POST 
请 求 参数 的 大 小 不 受 限制 ， 但 往往 取决 于 服务 器 的 限制 ，POST 请 求 传输 的 数据 量 总 比 GET 
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传输 的 数据 量 大 。 而 且 POST 方式 发 送 的 请 求 参 数 以 及 对 应 的 值 放 在 HTML HEADER 中 传 
输 ， 用 户 不 能 在 地 址 栏 里 看 到 请 求 参数 值 ， 安 全 性 相对 较 高 。 
对 比 上 面 两 种 请 求 方式 ， 由 此 可 见 我 们 通常 应 该 采用 POST 方式 发 送 请 求 。 
几乎 每 个 网 站 都 会 大 量 使 用 表单 ， 表 单 用 于 收集 用 户 信息 ， 一 旦 用 户 提交 请 求 ， 表 单 的 信息 将 会 
提交 给 对 应 的 处 理 程序 ， 如 果 为 form 元 素 设置 method 属性 为 post， 则 表示 发 送 POST 请 求 。 
下 面 是 表单 页 面 的 代码 。 
程序 清单 : codes\02W2.9NjspObject\form.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<!Doctype html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head> 
<title> 收集 参数 的 表单 页 </title> 
</head> 
<body> 
<form id="forml”method=“post”action= “request1. jsp”> 
用 户 名 : <br/> 
<input type="text" name="name"><hr/> 
性 别 ，<br/> 
男 ; <input type="radio" name="gender"” value=" 男 "> 
女 : <input type="radio" name="gender” value=" 女 "><hr/> 
喜欢 的 颜色 ，<br/> 
红 : <input type="checkbox" name="color" value=" 红 "> 
绿 : <input type="checkbox” name="color" value=" 
蓝 : <input type="checkbox"” name="color” value=" 蓝 "><hr/> 
来 自 的 国家 : <br/> 
<select name="country"> 
<option value=" 中 国 "> 中 国 </option> 
<option value=" 美 国 "> 美国 </option> 
<option value=" 俄 罗斯 "> 俄罗斯 </option> 
</select><hr/> 
<input type="submit” value=" 提 交 "> 
<input type="reset” value=" 重 置 "> 
</form> 
</body> 
</html> 


这 个 页 面 没 有 动态 的 JSP 部 分 ， 它 只 是 包含 一 个 收集 请 求 参数 的 表单 ， 且 粗 体 字 部 分 设置 了 该 表 
单 的 action 为 requestljsp， 这 表明 提交 该 表单 时 ， 请 求 将 发 送 到 requestl.jsp 页 面 ; 粗 体 字 代码 还 设置 
了 method 为 post， 这 表明 提交 表单 将 发 送 POST 请 求 。 

除 此 之 外 ， 表 单 里 还 包含 1 个 文本 框 、2 个 单 选 框 、3 个 复 选 框 及 1 个 下 拉 列 表 框 ， 另 外 包括 “ 提 
交 ” 和 “ 重 置 ”2 个 按钮 。 页 面 的 执行 效果 如 图 2.24 所 示 。 


图 2.24 表单 页 
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在 该 页 面 中 输入 相应 信息 后 ， 单 击 “ 提 交 ” 按 钮 ， 表 单 域 所 代表 的 请 求 参数 将 通过 request 对 象 的 
getParameter() 方 法 来 取得 。 

TO 而 是 有 name 属性 的 表单 域 才 生 成 请 求 参数 ，| 
关于 表单 域 和 请 求 参数 的 关系 笨 循 如 下 4 点 : | 
| 加 每 个 有 name 属性 的 表单 域 对 应 一 个 请 求 参数 。 
人 国 如 果 有 多 个 表单 域 有 相同 的 name 属性 ， 则 多 个 表单 域 只 生成 一 个 请 求 参数 ， 只 是 | 
| 该 参数 有 多 个 值 。 : 
加 表单 域 的 name 属性 指定 请 求 参数 名 ，value 指定 请 求 参数 值 。 | 
| 曙 如 果菜 个 表单 域 设置 了 disabled-vdisabledv 属 性 ， 则 该 表单 城 不 再 生成 请 求 参数 。 


上 面 的 表单 页 向 requestl.jsp 页 面 发 送 请 求 ，requestljsp 页 面 的 代码 如 下 。 

程序 清单 : codes\02\2.9\jspObject\request1.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 

<%@ page import="java.util,.*" > 

<!DOCTYPE html PUBLIC "~//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3,0org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
<title> 获取 请 求 头 /请 求 参数 </title> 

</head> 


<% 
// 获 取 所 有 请 求 头 的 名 称 
Enumeration<string> headerNames = request.getHeaderNames(); 
while (headerNames .hasMoreElements ()) 
{ 

String headerName = headerNames.nextElement ()7 

// 获 取 每 个 请 求 、 及 其 对 应 的 值 

out .Println (headerName + "-->" + request.getHeader (headerName) + "<br/>"); 
} 
out.println ("<hr/>"); 
// 设 置 解码 方式 ， 对 于 简体 中 文 ， 使 用 gb2312 解码 

tCharacterEncoding 


request. se' ("gb2312"); 
// 下 面 依次 获取 表单 域 的 值 
String name = request.getParameter ("name") ; 


String = request .getParameter("gender") ; 

// 如 果 某 个 请 求 参数 有 多 个 值 ， 将 使 用 该 方法 获取 多 个 值 
String[] color = request.getParameterValues ("color"); 
String national = request.getParameter ("country"); 
> 

<!-- 下 面 依次 输出 表单 域 的 值 -> 

您 的 名 字 : <%=name%><hr/> 

您 的 性 别 ，<$=genders><hr/> 

<!-- 输出 复 选 框 获取 的 数组 值 --> 

您 喜欢 的 颜色 : <%for (String c : color) 

{out .printlntc + " ");}%><hr/> 

您 来 自 的 国家 :<3=national%><hr/> 

</body> 

</html> 


上 述 页 面 代码 中 粗 体 字 代码 示范 了 如 何 获取 请 求 头 、 请 求 参数 ， 在 获取 表单 域 对 应 的 请 求 参 数值 
之 前 ， 先 设置 request 编码 的 字符 集 (如 粗 斜 体 代码 所 示 ) 如 果 POST 请 求 的 请 求 参 数 里 包含 非 西 
欧 字 符 ， 则 必须 在 获取 请 求 参数 之 前 先 调用 setCharacterEncoding0 方 法 设置 编码 的 字符 集 。 

如 果 发 送 请 求 的 表单 页 采用 gb2312 字符 集 ， 该 表单 页 发 送 的 请 求 也 将 采用 gb2312 字符 集 ， 所 以 
本 页 面 需要 先 执行 如 下 方法 。 

setCharacterEncoding("gb2312"): 设置 request 编码 所 用 的 字符 集 。 
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在 表单 提交 页 的 各 个 输入 域内 输入 对 应 的 值 ， 然 后 单 击 “ 提 交 ” 按 钮 ，requestljsp 就 会 出 现 如 图 
2.25 所 示 的 效果 。 


你 的 名 字 ，craryit 


您 要 裕 的 类 名 , 红 绊 
您 条 自 的 国 东 ， 中 国 


图 2.25 获取 POST 方式 的 请 求 参数 


如 果 需 要 传递 的 参数 是 普通 字符 串 , 而 且 仅 需 传递 少量 参数 ,可 以 选择 使 用 GET 方式 发 送 请 求 参 
数 ，GET 方式 发 送 的 请 求 参 数 被 附加 到 地 址 栏 的 URL 之 后 ， 地 址 栏 的 URL 将 变 成 如 下 形式 : 

url?param1=value1&param2=value2&…paramN=valueN: URL 和 参数 之 间 以 “?” 分 隔 ， 而 多 个 参 
数 之 间 以 “及 ”分 隔 。 

下 面 的 JSP 页 面 示范 了 如 何 通过 request 来 获取 GET 请 求 参数 值 。 

程序 清单 ;codes\02\2.9WspObjectwvequest2.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" %> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 


<title> 获取 GET 请 求 参数 </title> 
</head> 


< 
7/ 获取 name 请 求 参 数 的 值 

String name = request.getParameter ("name"); 

// 获 取 gender 请 求 参数 的 什 

String gender = request.getParameter ("gender"); 
> 

<!-- 输出 name 变量 值 --> 

您 的 名 字 : <$=name%><hr/> 

<!-- 输出 gender 变量 值 --> 

您 的 性 别 ，<%=genders><hr/> 

</body> 

</html> 


上 面 的 页 面 中 粗 体 字 代码 用 于 获取 GET 方式 的 请 求 参数 , 从 这 些 代 码 不 难看 出 : request 获取 POST 
请 求 参数 的 代码 和 获取 GET 请 求 参数 代码 完全 一 样 。 向 该 页 面 发 送 请 求 时 直接 在 地 址 栏 里 增加 一 些 
GET 方式 的 请 求 参 数 ， 执 行 效果 如 图 2.26 所 示 。 

细心 的 读者 可 能 发 现 上 面 两 个 请 求 参数 值 都 由 英文 字符 组 成 ,如 果 请 求 参数 值 里 包含 非 西欧 字符 ， 
那么 是 不 是 应 该 先 调用 setCharacterEncoding() 来 设置 request 编码 的 字符 集 呢 ? 读者 可 以 试 一 下 。 答 案 
是 不 行 ， 如 果 GET 方式 的 请 求 值 里 包含 了 非 西欧 字符 ， 则 获取 这 些 参数 比较 复杂 。 
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图 2.26 获取 GET 方式 的 请 求 参数 


下 面 的 页 面 示范 了 如 何 获取 GET 请 求 里 的 中 文字 符 。 

程序 清单 : codes\02\2.9\jspObject\request3.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 

<!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3,0rg/TR/xhtml1/DTD/xhtml1-transitional .dtd"> 

<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
<title> 获取 包含 非 西欧 字符 的 GET 请 求 参数 </title> 

</head> 

<body> 


< 
// 获 取 请 求 里 包含 的 查询 字符 串 

String rawQueryStr = request.getQueryString(); 

out .println ("原始 查询 字符 申 为 : " + rawQuerystr + "<hr/>"); 
// 使 用 URLDecoder 解码 字符 囊 


rawQuerystr , "gbk"); 
out.println(" 解码 后 的 查询 字符 惠 为， "+ querystr + "<hr/>"); 
// 以 6 符号 分 解 查询 字符 串 
String[] paramPairs = queryStr.split("5&"); 
For (String ParamPair : paramPairs) 
{ 
out.println ("每 个 请 求 参数 名 、 值 对 为 "+ parampair + "<br/>"); 
// 以 = 来 分 解 请 求 参数 名 和 值 
String[] nameValue = paramPpair.split("="); 
out ,Println (nameValue[0] + "参数 的 值 是 : "+ 
nameValue [1]+ "<hr/>"); 
} 
%> 
</body> 
</html> 


上 面 的 程序 中 粗 体 字 代码 就 是 获取 GET 请 求 里 中 文 参数 值 的 关键 代码 ， 为 了 获取 GET 请 求 里 的 
中 文 参数 值 ， 必 须 借助 于 java.net.URLDecoder 类 。 关 于 URLDecoder 和 URLEncoder 两 个 类 的 用 法 请 
参考 疯狂 Java 体系 的 《疯狂 Java 讲义 》 一 书 的 17.2 节 。 

读者 可 以 编写 一 个 表单 ， 并 让 表单 以 GET 方式 提交 请 求 到 request3.jsp 页 面 ， 将 可 看 到 如 图 2.27 
所 示 的 效果 。 


鹏 码 后 的 查询 字符 久 为 ，nane= 李 刚 Aeender= 男 
等 个 请 未 参数 各、 值 寺 为 ，naoe= 李 出 
name 参 数 的 值 是 ， 地 风 


每 个 请 求 甸 孝 各 、 值 对 为，gendzr= 男 
ender 大 数 的 值 是 ， 男 


图 2.27 获取 GET 请 求 的 中 文 请 求 参 数 
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如 果 读 者 不 想 这 样 做 ， 还 可 以 在 获取 请 求 参 数值 之 后 对 请 求 参数 值 重新 编码 。 也 就 是 先 将 其 转 
换 成 字 节 数组 ,再 将 字 节 数组 重新 解码 成 字符 串 。 例 如， 可 通过 如 下 代码 来 取得 name 请 求 参数 的 参 
数值 。 

// 获 取 原 始 的 请 求 参数 值 


String rawName = request.getParameter ("name"); 

// 将 请 求 参数 值 使 用 ISO-8859-1 字符 串 分 解 成 字 节 数 组 
byte[] rawBytes = rawName.getBytes("ISO-8859-1"); 
// 将 字 节 数组 重新 解码 成 字符 串 

String name = new String(rawBytes , "gb2312"); 
通过 上 面 代码 片段 也 可 处 理 GET 请 求 里 的 中 文 请 求 参数 值 。 


2. 操作 request 范围 的 属性 


HttpServletRequest 还 包含 如 下 两 个 方法 ， 用 于 设置 和 获取 request 范围 的 属性 。 
> setAttribute(String attName , Object attValue): 将 attValue 设置 成 request 范围 的 属性 。 
> ”Object getAttribute(String attName): 获取 request 范围 的 属性 。 
当 forward 用 户 请 求 时 ， 请 求 的 参数 和 请 求 属性 都 不 会 丢失 。 看 下 一 个 JSP 页 面 ， 这 个 JSP 页 面 
是 个 简单 的 表单 页 ， 用 于 提交 用 户 请 求 。 
程序 清单 : codes\02\2.9\jspObject\drawjsp 
<%@ page contentType="text/html; charset=gb2312" language="java" $> 
<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" 多 > 
<!DOCTYPE html PUBLIC "-//W3C//DTD XBTML 1.0 Transitional//EN" 
"http: //www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 取 钱 的 表单 页 </title> 
</head> 
<body> 
<!-~ 取 钱 的 表单 --> 
<form method="post" action="first.jsp"> 
取 钱 ，<input type="text" name="balance"> 
<input type="submit”value=" 提 : 
</form> 
</body> * 
</html> 
该 页 面向 firstjsp 页 面 请 求 后 ，balance 参数 将 被 提交 到 firstjsp 页 面 ， 下 面 是 firstjsp 页 面 的 实现 
代码 。 
程序 清单 ，codes\02\2.9\jspObject\firstjsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 
<%@ page import="java.util,*" §> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> request 处 理 </title> 
</head> 
<body> 


< 

// 获 取 请 求 的 钱 数 

String bal = request.getParameter ("balance"); 
// 将 钱 数 的 字符 串 转换 成 双 精 度 浮 点 数 

double qian = Double.parseDouble (bal); 

// 对 取出 的 钱 进行 判断 

if (qian < 500) 

{ 


out.println ("给 你 ”+ qian + " 搁 ") 
out.println ("账户 减少 ”+ qian); 


else 
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// 创 建 了 一 个 List 对 象 
List<string> info = new ArrayList<string>(); 
info.add ("1111111"); 
info.add("2222222") ; 
info.add("3333333"); 
// 将 info 对 象 放 入 request 范围 内 
request .setAttribute ("info" , info); 
> 
<!-- 实现 转发 --> 
<jsp:forward page="second. jsp"/> 
< > 
</body> 
</html> 


firstjsp 页 面 首先 获取 请 求 的 取 钱 数 ， 然 后 对 请 求 的 钱 数 进行 判断 。 如 果 请 求 的 钱 数 小 于 500， 则 
允许 直接 取 钱 ， 否 则 将 请 求 转发 到 second.jsp。 转 发 之 前 ， 创 建 了 一 个 List 对 象 ， 并 将 该 对 象 设置 成 
request 范围 的 info 属性 。 

接 下 来 在 secondjsp 页 面 中 ， 不 仅 获 取 了 请 求 的 balance 参数 ， 而 且 还 会 获取 request 范围 的 info 
属性 。secondjsp 页 面 的 代码 如 下 。 

程序 清单 : codes\02\2.9\YjspObject\second.jsp 

<%0 page contentType="text/html; charset=GBK" language="java" errorPage="” 和 > 

<4@ page import="java.util.*" $> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://www.w3,org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head> 

<title> request 处 理 </title>“ 
</head> 


<% 

// 取 出 请 求 参数 

String bal = request.getParameter ("balance"); 

double qian = Double.parseDouble (bal); 

// 取 出 request 范围 内 的 info 属性 

List<string> info = (List<string>)request.getAttribute("info"); 
for (String tmp : info), 

{ 


out,.println(tmp + "<br/>"); 

dt ple + qian +“" 抉 "); 

out .println ("账户 减少 "+ qian); 

i 

</html> 

如 果 页 面 请 求 的 钱 数 大 于 500， 请 求 将 被 转发 到 second.jsp 页 面 处 理 ， 而 且 在 second.jsp 页 面 中 可 
以 获取 到 balance 请 求 参 数值 ， 也 可 获取 到 request 范围 的 info 属性 ， 这 表明 : forward 用 户 请 求 时 ， 
请 求 参数 和 request 范围 的 属性 都 不 会 丢失 ， 即 forward 动作 还 是 原来 的 请 求 ， 并 未 再 次 向 服务 器 发 

如 果 请 求 取 钱 的 钱 数 为 654， 则 页 面 的 执行 效果 如 图 2.28 所 示 。 


图 2.28 操作 request 范围 的 属性 
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3. 执行 forward 或 include 
request 还 有 一 个 功能 就 是 执行 forward 和 include， 也 就 是 代替 JSP 所 提供 的 forward 和 include 动 
作 指令 。 前 面 我 们 需要 forward 时 都 是 通过 JSP 提供 的 动作 指令 进行 的 ， 实 际 上 request 对 象 也 可 以 执 
行 forward。 
HttpServletRequest 类 提供 了 一 个 getRequestDispatcher (String path) 方 法 , 其 中 path 就 是 希望 forward 
或 者 include 的 目标 路 径 ， 该 方法 返回 RequestDispatcher， 该 对 象 提供 了 如 下 两 个 方法 。 
> forward(ServletRequest request, ServletResponse response): 执行 forward。 
> include(ServletRequest request, ServletResponse response): 执行 include。 
如 下 代码 行 可 以 将 ajsp 页 面 include 到 本 页 面 中 : 
getRequestDispatcher ("/a.jsp") .include (request , response); 
如 下 代码 行 则 可 以 将 请 求 forward 到 ajsp 页 面 : 


getRequestDispatcher ("/a.jsp") .forward(request , response); 


本 
本 -注意 :六 
使 用 request 的 getRequestDispatcher(String path) 方 法 时 ， 


须 以 斜 线 
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》>》>2.9.7 response 对 象 


response 代表 服务 器 对 客户 端的 响应 。 大 部 分 时 候 ， 程 序 无 须 使 用 response 来 响应 客户 端 请 求 ， 
因为 有 个 更 简单 的 响应 对 象 一 out， 它 代表 页 面 输出 流 ， 直 接 使 用 out 生成 响应 更 简单 。 

但 out 是 JspWriter 的 实例 ，JspWriter 是 Writer 的 子 类 ，Writer 是 字符 流 ， 无 法 输出 非 字符 内 容 
假如 需要 在 JSP 页 面 中 动态 生成 一 幅 位 图 、 或 者 输出 一 个 PDF 文档 ， 使 用 out 作为 响应 对 象 将 无 法 完 
成 ， 此 时 必须 使 用 response 作为 响应 输出 。 

除 此 之 外 ， 还 可 以 使 用 response 来 重 定向 请 求 ， 以 及 用 于 向 客户 端 增加 Cookie 。 

1， response 响应 生成 非 字符 响应 

对 于 需要 生成 非 字 符 响应 的 情况 ， 就 应 该 使 用 response 来 响应 客户 端 请 求 。 下 面 的 JSP 页 面 将 在 
客户 成 一 张 图 片 .response 是 HttpServletResponse 接 口 的 实例 ,该 接口 提供 了 一 个 getOutputStream() 
方法 ， 该 方法 返回 响应 输出 字 节 流 。 

程序 清单 : codes\02\2.9\jspObjectiimgjsp 

<$-- 通过 contentType 属性 指定 响应 数据 是 图 片 --%> 

<%@ page contentType="image/jpeg" language="java"®> 

<%@ page import="java.awt.image.*, javax.imageio.*,java.io.*,java.awt.*"> 

< 

// 创 建 Bufferedimage 对 象 

BufferedImage image = new BufferedImage(340 ， 

160, BufferedImage.TYPE_INT_RGB); 

// 以 Image 对 象 获取 Graphics 对 象 

Graphics g = image.getGraphics(); 

// 使 用 Graphics 画图 ， 所 画 的 图 像 将 会 出 现在 image 对 象 中 

g.fillRect (0,0,400, 400)» 

7/ 设置 颜色 : 红 

g.setColor (new Color{(255,0,0)); 

// 画 出 一 段 弧 

9g.£illArc(20, 20, 100;100, 30, 120); 
// 设 置 颜色 : 绿 

g.setColor (new Color(0 , 255, 0)); 
// 画 出 一 段 弧 

9.£illArc(20, 20, 100,100, 150, 120); 
7/ 设置 颜 色 : 蓝 
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gsetColor(new Colort0 , 0, 255)); 

// 画 出 一 段 弧 

g.fillaArc(20，20，100,100，270，120)7 

/7 设置 颜色 : 黑 

g.setColor (new Color(0,0,0)); 

g.setFont (new Font ("Arial Black", Font.PLAIN, 16)); 
V/ 画 出 三 个 字符 串 

g-drawstring("red:climb" , 200 , 60); 
g.drawstring ("green:swim" , 200 , 100); 
g.drawstring ("blue:jump" , 200 , 140); 
g.dispose(); 

// 将 图 像 输出 到 页 面 的 响应 

ImageIO.write (image , "jpg" , response.getOutputstream()); 
3> 


以 上 页 面 的 粗 体 字 代码 先 设置 了 服务 器 响应 数据 是 image/ipeg， 这 表明 服务 器 响应 是 一 张 JPG 图 
片 。 接 着 创建 了 一 个 BufferedImage 对 象 ( 代 表 图 像 )， 并 获取 该 BufferedImage 的 Graphics 对 象 ( 代 
表 画 笔 )， 然 后 通过 Graphics 向 BufferedImage 中 绘制 图 形 ， 最 后 一 行 代码 将 直接 将 BufferedImage 作 
为 响应 发 送 给 客户 端 。 

请 直接 在 浏览 器 中 请 求 该 页 面 ， 将 看 到 浏览 器 显示 一 张 图 片 ， 效 果 如 图 2.29 所 示 。 


图 2.29 使 用 response 生成 非 字符 响应 


也 可 以 在 其 他 页 面 中 使 用 img 标签 来 显示 这 个 图 片 页 面 ， 代 码 如 下 : 

<img src="img.jsp"> 

使 用 这 种 临时 生成 图 片 的 方式 就 可 以 非常 容易 地 实现 网 页 上 的 图 形 验证 码 功能 。 不仅 如 此 ， 使 用 
response 生成 非 字 符 响应 还 可 以 直接 生成 PDF 文件 、Excel 文件 ， 这 些 文件 可 直接 作为 报表 使 用 。 

2. 重 定向 

重 定向 是 response 的 另外 一 个 用 处 , 与 forward 不 同 的 是 , 重 定向 会 丢失 所 有 的 请 求 参数 和 request 
范围 的 属性 ， 因 为 重 定向 将 生成 第 二 次 请 求 ， 与 前 一 次 请 求 不 在 同一 个 request 范围 内 ， 所 以 发 送 一 次 
请 求 的 请 求 参 数 和 request 范围 的 属性 全 部 丢失 。 

HttpServletResponse 提供 了 一 个 sendRedirect(String path) 方 法 , 该 方法 用 于 重 定向 到 path 资源 ， 即 
重新 向 path 资源 发 送 请 求 。 

下 面 的 JSP 页 面 将 使 用 response 执行 重 定向 。 

程序 清单 : codes\02\2.9YjspObject\doRedirect.jsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" %> 
< 

// 生 成 页 面 响应 

out .println ("===="); 

// 重 定向 到 forward-result.jsp 页 面 

response.sendRedirect ("redirect-result.jsp"); 

> 


以 上 页 面 的 粗 体 字 代码 用 于 执行 重 定向 ， 向 该 页 面 发 送 请 求 时 ， 请 求 会 被 重 定向 到 redirect- 
resultjsp 页 面 。 例如， 在 地址 栏 中 输入 http://localhost:8888/jspObject/ doRedirectjsp?name=yeeku， 然 后 
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按 回 车 键 ， 将 看 到 如 图 2.30 所 示 的 效果 。 


被 重 定向 的 目标 页 
name 请 求教 的 值 ，mu 


| 


图 2.30 redirect 效果 
ne 执行 重 定向 动作 时 ， 地 址 栏 的 URL 会 变 成 重 定向 的 目标 URL。 


亚 - 注意 ， 人 
重 定向 会 丢失 所 有 的 请 求 参 数 ， 使 用 重 定向 的 至 果 与 在 地 址 重新 输入 新 地 址 
再 按 回 车 键 的 效果 完全 一 样 ， - 光 浊 让 一 多 请 订 


从 表面 上 来 看 ，forward 动作 redirect 动作 < 相似， 它们 都 可 将 请 求人 到 另 一 个 页 面 。 但 实 
际 上 forward 和 redirect 之 间 存在 较 大 的 差异 ，forward 和 redirect 的 差异 如 表 2.1 所 示 。 


表 2.1 forward 和 redirect 对 比 
转发 (forward) 重 定向 (redirect) 
执行 forward 后 依然 是 上 一 次 请 求 执行 redirect 后 生成 第 一 次 请 求 
forward 的 目标 页 面 可 以 访问 原 请 求 的 请 求 参 数 , 因为 依然 是 同 redirect 的 日 标 页 面 不 能 访问 原 请 求 的 请 求 参数 ， 因 为 是 第 一 次 请 


次 请 求 ， 所 有 原 请 求 的 请 求 参数 、request 范围 的 属性 全 部 存在 求 了 ， 所 有 原 请 求 的 请 求 参 数 、request 范围 的 属性 全 部 天 类 
地 址 栏 改 为 重 定向 的 目标 URL， 相 当 于 在 浏览 器 地 址 栏 里 输入 新 
的 URL 后 按 回 车 键 


地 址 栏 蜂 请 求 的 URL 不 会 改变 


3. 增加 Cookie 

Cookie 通常 用 于 网 站 记录 客户 的 某 些 信息 ， 比 如 客户 的 用 户 名 及 客户 的 喜好 等 。 一 旦 用 户 下 次 登 
录 , 网 站 可 以 获取 到 客户 的 相关 信息 , 根据 这 些 客户 信息 , 网 站 可 以 对 客户 提供 更 友好 的 服务 。Cookie 
与 session 的 不 同 之 处 在 于 : session 会 随 浏览 器 的 关闭 而 失效 , 但 Cookie 会 一 直 存放 在 客户 端 机 器 上 ， 
除非 超出 Cookie 的 生命 期 限 。 

由 于 安全 性 的 原因 ， 使 用 Cookie 客户 端 浏 览 器 必须 支持 Cookie 才 行 。 客 户 端 浏 览 器 完全 可 以 设 
署 禁 用 Cookie。 

增加 Cookie 也 是 使 用 response 内 置 对 象 完 成 的 ，response 对 象 提 供 了 如 下 方法 。 

> void addCookie(Cookie cookie): 增加 Cookie。 

正如 在 上 面 的 方法 中 见 到 的 ， 在 增加 Cookie 之 前 ， 必 须 先 创建 Cookie 对 象 。 增 加 Cookie 请 按 如 
下 步骤 进行 。 

人 创建 Cookie 实例 ，Cookie 的 构造 器 为 Cookie(String name, String value)。 

G 设置 Cookie 的 生命 期 限 ， 即 该 Cookie 在 多 长 时 间 内 有 效 。 

个 向 客户 端 写 Cookie。 

看 如 下 JSP 页 面 ， 该 页 面 可 以 用 于 向 客户 端 写 一 个 username 的 Cookie。 

程序 清单 :，codes\02\2.9\jspObject\addCookie.jsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorpages"" is> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://wuw.w3.0org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
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<title> 增加 Cookie </title> 
</head> 


// 获 取 请 求 参数 

String name = request.getParameter ("name"); 
7/ 以 获取 到 的 请 求 参数 为 值 ， 创 建 一 个 Cookie 对 象 
Cookie c = new Cookie("username" , name); 
// 设 置 cookie 对 象 的 生存 期 限 

c.setMaxAge (24 * 3600) 7 

/内 赛 户 吉 增加 cookie 对 要 


</body> 

</html> 

如 果 浏 览 器 没有 阻止 Cookie， 在 地 址 栏 输入 http://localhost:8888/jspObject/addCookie.jsp? 
name=crazyit， 执 行 该 页 面 后 ， 网 站 就 会 向 客户 端 机 器 写 入 一 个 名 为 username 的 Cookie， 该 Cookie 将 
在 客户 端 硬盘 上 一 直 存在 ， 直 到 超出 该 Cookie 的 生存 期 限 〈 本 Cookie 设置 为 24 小 时 )。 

访问 客户 端 Cookie 使 用 request 对 象 ，request 对 象 提供 了 getCookies0 方 法 ,该 方法 将 返回 客户 端 
机 器 上 所 有 Cookie 组 成 的 数组 ， 遍 历 该 数组 的 每 个 元 素 ， 找 到 希望 访问 的 Cookie 即 可 。 

下 面 是 访问 Cookie 的 JSP 页 面 的 代码 。 

程序 清单 ，codes\02\2.9\jspObject\readCookiejsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" 4> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 读 取 Cookie </title> 

</head> 

<body> 

<% 

// 获 取 本 站 在 客户 端 上 保留 的 所 有 Cookie 

Cookie[] cookies = request.getCockies() 


人 访客 让 并 上 的 信人 cou 
for (Cookie © : cookies) 


{ 
// 如 果 cookie 的 名 为 username， 表 明 访 cookie 是 我 们 需要 访问 的 Cookie 
if (c.getName () .equals ("username")) 
{ 
out.println (c.getValue()) ; 
} 
} 
和 > 
</body> 
</html> 


上 面 的 粗 体 字 代码 就 是 通过 request 读 取 Cookie 数组 ， 并 搜寻 指定 Cookie 的 关键 代码 ， 访 问 该 页 
面 即 可 读 出 刚才 写 在 客户 端的 Cookie。 
呈 
本- 注意 : 
使 用 Cookie 对 


烦 设 置 其 生存 期 限 ， 否 则 Cookie 将 会 随 ; 各 的 关 半自动 污 


默认 情况 下 ，Cookie 值 不 允许 出 现 中 文字 符 ， 如 果 我 们 需要 值 为 中 文 内 容 的 Cookie 怎么 办 呢 ? 
同样 可 以 借助 于 java.net.URLEncoder 先 对 中 文字 符 串 进行 编码 ， 将 编码 后 的 结果 设 为 Cookie 值 。 当 
程序 要 读 取 Cookie 时 ， 则 应 该 先 读 取 ， 然 后 使 用 java.net.URLDecoder 对 其 进行 解码 。 

如 下 代码 片段 示范 了 如 何 存 入 值 为 中 文 的 Cookie。 

程序 清单 : codes\02\2.9\jspObject\cnCookie.jsp 
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<$8 page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 


< -~ 
// 以 编码 后 的 字符 串 为 值 ， 创 建 一 个 cookie 对 象 
Cookie c = new Cookie("cnName" 
，java.net .URLEncoder .encode (" 孙 司空” ，"gbk") ) ; 
// 设 置 cookie 对象 的 生存 期 限 
c.setMaxAge (24 * 3600); 
// 向 客户 端 增加 Cookie 对 象 


response.addCookie (c); 


// 获 取 本 站 在 客户 端 上 保留 的 所 有 Cookie 
Cookie[] cookies = request.getCookies(); 
7/ 遍历 客户 端 上 的 每 个 cookie 
for (Cookie cookie : cookies) 
{ 
// 如 果 Cookie 的 名 为 username， 表 明 该 cookie 是 我 们 需要 访问 的 Cookie 
if (cookie.getName () .equals ("cnName")) 
{ 
// 使 用 java.util.URLDecoder 对 Cookie 值 进 行 解码 
out.println (java.net.URLDecoder 
:decode (cookie.getValue())); 


上 
$> 
上 面 的 程序 中 两 行 粗 体 字 代 码 是 存 入 值 为 中 文 的 Cookie 的 关键 : 存 入 之 前 先 用 
java.net.URLEncoder 进行 编码 ， 读 取 时 需要 对 读 取 的 Cookie 值 用 java.net.URLDecoder 进行 解码 。 


>》 >2.9.8 session 对 象 


session 对 象 也 是 一 个 非常 常用 的 对 象 ， 这 个 对 象 代表 一 次 用 户 会 话 。 一 次 用 户 会 话 的 含义 是 :从 
客户 端 浏 览 器 连接 服务 器 开始 ， 到 客户 端 浏 览 器 与 服务 器 断 开 为 止 ， 这 个 过 程 就 是 一 次 会 话 。 
session 通常 用 于 跟踪 用 户 的 会 话 信息 ， 如 判断 用 户 是 否 登录 系统 ， 或 者 在 购物 车 应 用 中 ， 用 于 跟 
踪 用 户 购买 的 商品 等 。 
session 范围 内 的 属性 可 以 在 多 个 页 面 的 跳 转 之 间 共享 。 一 旦 关闭 浏览 器 ， 即 session 结束 ，session 
范围 内 的 属性 将 全 部 丢失 。 
session 对 象 是 HttpSession 的 实例 ，HttpSession 有 如 下 两 个 常用 的 方法 。 
> setAttribute(String attName，Object attValue): 设置 session 范围 内 attName 属性 的 值 为 
attValue。 
> getAttribute(String attName): 返回 session 范围 内 attName 属性 的 值 。 
下 面 的 示例 演示 了 一 个 购物 车 应 用 ， 以 下 是 陈列 商品 的 JSP 页 面 代码 。 
程序 清单 : codes\02\2.9\jspObject\shop.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorpagesnn %> 
<!DOCtype html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 


<title> 选择 物品 购买 </title> 

</head> 

<body> 

<form method="post" action="processBuy.jsp"> 
书籍 ， <input type="checkbox" name="item" value="book"/><br/> 
电脑 : <input type="checkbox" name="item" value="computer"/><br/> 
汽车 : <input type="checkbox" name="item” value="car"/><br/> 
<input type="submit"” value=" 购 买 "/> 

</form> 

</body> 

</html> 
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这 个 页 面 几 乎 没有 动态 的 JSP 部 分 ， 全 部 是 静态 的 HTML 内 容 。 该 页 面包 含 一 个 表单 ， 表 单 里 包 
含 三 个 复 选 按钮 ， 用 于 选择 想 购 买 的 物品 ， 表 单 由 processBuyjsp 页 面 处 理 ， 其 页 面 的 代码 如 下 : 
程序 清单 :codes\02\2.9jspObjectwprocessBuyjsp 


<%@ page contentType="text/html; charset=gb2312" language="java" %> 
Se page import="java.util.*"%> 


7 session 范围 的 itemMap 属性 

Map<Sstring, Integer> itemMap = (Map<string,Integer>) session 
-getAttribute ("itemMap") ; 

// 如 果 Map 对 象 为 空 ， 则 初始 化 Map 对 象 

if (itemMap == null) 

{ 
itemMap = new HashMap<String, Integer>(); 
itemMap.put (" 书 籍 " ，0) 
icemMap .Put (" 电 脑 ” ， 0)7 
itemMap.put ("汽车 "”，0); 


} 

// 获 取 上 一 个 页 面 的 请 求 参数 

String[] buys = request.getParameterValues ("item"); 
// 儿 历数 组 的 各 元 素 

for (String item ; buys) 


{ 
// 如 果 item 为 book， 表 示 选 择 购 买书 籍 
if (item.equals ("book")) 
{ 
int numl = itemMap.get "书籍 ") .intValue(); 
7/ 将 书籍 key 对 应 的 数量 加 1 
itemMap .put (" 书 条"”，numl + 1); 


} 

// 如 果 item 为 computer， 表 示 选 择 购买 电脑 

else if (item.equals("computer")) 

{ 
int num2 = itemMap.get ("电脑 ") .intValue(); 
// 将 电脑 key 对 应 的 数量 加 1 
itemMap.put ("电脑 ”，num2 + 1); 


) 

// 如 果 item 为 car， 表 示 选 择 购 买 汽车 

else if (item.equals("car")) 

{ 
int num3 = itemMap.get ("汽车 ") ,intValue(); 
// 将 汽车 key 对 应 的 数量 加 1 
itemMap.put ("汽车 "”，num3 + 1); 

} 


// 光 itemMap 对 象 放 到 设置 成 session wy itemMap 属性 

session. setAttribute ("itemMap" , itemMap); 

$> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN” 
"http: //waw.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head> 
<title> new document </title> 

</head> 

<body> 

您 所 购买 的 物品 ，<br/> 

书籍 ，<$=itemMap.get ("书籍 ")$> 本 <br/> 

电脑 ，<s=itemMap .get ("电脑 ")$> 台 <br/> 

汽车 ，<$=itemMap.get ("汽车 ")$> 辆 

<p><a href="shop.jsp"> 再 次 购买 </a></p> 

</body> 

</html> 


以 上 页 面 中 粗 体 字 代码 使 用 session 来 保证 itemMap 对 象 在 一 次 会 话 中 有 效 ,这 使 得 该 购物 车 系统 
可 以 反复 购买 , 只 要 浏览 器 不 关闭 , 购买 的 物品 信息 就 不 会 丢失 , 图 2.31 显示 的 是 多 次 购买 后 的 效果 。 
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考虑 se session 本 身 的 目的 ， 通 常 只 应 该 把 与 用 户 会 话 状态 相关 的 信 包 放 入 ， session 范 
国内 。 不 要 仅仅 为 了 两 个 页 面 之 间 交 换 信 息 ， 就 将 该 信息 放 入 session 范围 内 。 如 果 仅 仅 
为 了 两 个 页 面 交换 信人 dn 内 ， forward 请 求 即 可 。 


关于 session 还 有 一 点 需要 指出 ，session 机 制 通常 用 于 保存 客户 六 的 状态 信息 这 些 闫 态 信息 尖 
要 保存 到 Web 服务 器 的 硬盘 上 ， 所 以 要 求 session 里 的 属性 值 必 须 是 可 序列 化 的 ， 否 则 将 会 引发 不 可 
os 
- 蕉 : 注意 : 
Session 的 属性 值 可 以 是 任何 可 序列 化 的 Java 对 象 . 


2.10 Servlet 介绍 


前 面 已 经 介绍 过 ，JSP 的 本 质 就 是 Servlet， 开 发 者 把 编写 好 的 JSP 页 面部 署 在 Web 容器 中 之 后 ， 
Web 容器 会 将 JSP 编译 成 对 应 的 Servlet。 但 直接 使 用 Servlet 的 坏处 是 : Servlet 的 开发 效率 非常 低 ， 
特别 是 当 使 用 Servlet 生成 表现 层 页 面 时 ， 页 面 中 所 有 的 HTML 标签 ， 都 需 采用 Servlet 的 输出 流 来 输 
出 ， 因 此 极其 烦琐 。 而 且 Servlet 标准 的 Java 类 ， 必 须 由 程序 员 开发 、 修 改 ， 美 工人 员 难 以 参与 Servlet 
页 面 的 开发 。 这 一 系列 的 问题 ， 都 阻碍 了 Serviet 作为 表现 层 的 使 用 。 

自 MVC 规范 出 现 后 ，Servlet 的 责任 开始 明确 下 来 ， 仅 仅 作为 控制 器 使 用 ， 不 再 需要 生成 页 面 标 
签 ， 也 不 再 作为 视图 层 角色 使 用 。 


2.10.1 Servlet 的 开发 


前 面 介绍 的 JSP 的 本 质 就 是 Servlet，Servlet 通常 被 称 为 服务 器 端 小 程序 ， 是 运行 在 服务 器 端的 程 
序 ， 用 于 处 理 及 响应 客户 端的 请 求 。 

Servlet 是 个 特殊 的 Java 类 ， 这 个 Java 类 必须 继承 HttpServlet。 每 个 Servlet 可 以 响应 客户 端的 请 
求 。Servlet 提供 不 同 的 方法 用 于 响应 客户 端 请 求 。 

> doGet 用 于 响应 客户 端的 GET 请求。 

> doPost: 用 于 响应 客户 端的 POST 请 求 。 

> ”doPut: 用 于 响应 客户 端的 PUT 请 求 。 

> ”doDelete: 用 于 响应 客户 端的 DELETE 请 求 。 

事实 上 ,客户 端的 请 求 通常 只 有 GET 和 POST 两 种 ,Servlet 为 了 响应 这 两 种 请 求 , 必须 重 写 doGet0 
和 doPost0 两 个 方法 。 如 果 Servlet 为 了 响应 4 个 方式 的 请 求 ， 则 需要 同时 重 写 上 面 的 4 个 方法 。 

大 部 分 时 候 ，Servlet 对 于 所 有 请 求 的 响应 都 是 完全 一 样 的 。 此 时 ， 可 以 采用 重 写 一 个 方法 来 代替 
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上 面 的 儿 个 方法 ， 只 需 重 写 service( 方 法 即 可 响应 客户 端的 所 有 请 求 。 

另外 ，HttpServlet 还 包含 两 个 方法 。 

> init(ServletConfig config): 创建 Servlet 实例 时 ， 调 用 该 方法 的 初始 化 Servlet 资源 。 

> destroy(): 销毁 Servlet 实例 时 ， 自 动 调用 该 方法 的 回收 资源 。 

通常 无 须 重 写 init0 和 destroy0 两 个 方法 , 除非 需要 在 初始 化 Servlet 时 , 完成 某 些 资源 初始 化 的 方 
法 ， 才 考虑 重 写 init 方法。 如 果 需 要 在 销毁 Servlet 之 前 ， 先 完成 某 些 资源 的 回收 ， 比 如 关闭 数据 库 连 
接 等 ， eta destroy 方法 。 


本 注重 ， 1 
不 用 为 Servlet 类 编写 构造 器 ， 如 果 需 要 对 Servlet 执行 初始 化 操作 ， 应 将 初始 化 操 
作 放 在 Servlet 的 init0 方 法 中 定义 。 如 果 重 写 了 init(ServletConfig config) 方 法 ， 则 应 在 重 村 


写 该 方法 的 第 一 行 调用 super.init(config)。 该 方法 将 调用 HttpServlet 的 init 方法 。 


下 面 提供 一 个 Servlet 的 示例 ， 该 Servlet 将 获取 表单 请 求 参数 ， 并 将 请 求 参 数 显示 给 客户 端 。 
程序 清单 : codes\02\2.10\servletDemo\WEB-INF\src\lee\FirstServletjava 
//Servlet 必须 继承 Httpservlet 类 
QWebservlet (name="firstServlet" 


, urlPatterns={"/firstServlet"}) 
public class FirstServlet extends HttpServlet 


{ 
// 客 户 端的 响应 方法 ， 使 用 该 方法 可 以 响应 客户 端 所 有 类 型 的 请 求 
Public void service (HttpServletRequest request, 


HttpServletResponse response) 

throws ServletException, java.io.IOException 
{ 

// 设 置 解码 方式 


request .setCharacterEncoding ("GBK"); 
response.setContentType ("text/html;charSet=GBK"); 
// 获 取 name 的 请 求 参数 值 
String name = request.getParameter ("name")’; 
// 获 取 gender 的 请 求 参数 值 
String gender = request.getParameter ("gender"); 
// 获 取 color 的 请 求 参数 值 
String[] color = request.getParameterValues("color"); 
/ /获取 country 的 请 求 参数 值 
String national = request.getParameter("country"); 
// 获 取 页 面 输出 流 
PrintStream out = new Printstream(response.getOoutputstream()); 
// 输 出 HTML 页 面 标签 
out.println("<html>"); 
out.println("<head>"); 
out.println ("<title>Servlet 测试 </title>"); 
out.println("</head>"); 
out.println("<body>"); 
// 输 出 请 求 参数 的 值 ，name 
out .println ("您 的 名 字 : ”+ name + "<hr/>"); 
// 输 出 请 求 参数 的 值 ，gender 
out .println ("您 的 性 别 : " + gender + "<hr/>"); 
// 输 出 请 求 参数 的 值 ，color 
out .println(" 您 喜欢 的 颜色 : “) 
for(String c : color) 
{ 
out.println(c + " ")» 
} 
out.printin("<hr/>"); 
out .println(" 您 喜欢 的 颜色 : 
// 输 出 请 求 参数 的 值 : nation 
out .println ("您 来 自 的 国家 : 
out ,println(”</body>”)2 


+ national + "<hr/>"); 
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out.printin("</html>"); 
} 
} 


上 面 的 Servlet 类 继承 了 HttpServlet 类 ， 表 明 它 可 作为 一 个 Servlet 使 用 。 程 序 的 粗 体 字 代码 定义 
了 service 方法 来 响应 用 户 请 求 .对 比 该 Servlet 和 2.9.6 节 中 的 requestl.jsp 页 面 ,该 Servlet 和 requestl.jsp 
页 面 的 效果 完全 相同 ， 都 通过 HttpServletRequest 获取 客户 端的 form 请 求 参数 ， 并 显示 请 求 参数 的 值 。 

Servlet 和 JSP 的 区 别 在 于 : 

> ”Servlet 中 没有 内 置 对 象 ， 原 来 JSP 中 的 内 置 对 象 都 必须 由 程序 显 式 创建 。 

> ”对 于 静态 的 HTML 标签 ，Servlet 都 必须 使 用 页 面 输出 流连 行 输出 。 

这 也 正 是 笔者 在 前 面 介绍 的 ，JSP 是 Servlet 的 一 种 简化 ， 使 用 JSP 只 需要 完成 程序 员 需 要 输出 到 
客户 端的 内 容 ， 至 于 JSP 脚本 如 何 嵌 入 一 个 类 中 ， 由 JSP 容器 完成 。 而 Servlet 则 是 个 完整 的 Java 类 ， 
这 个 类 的 service() 方 法 用 于 生成 对 客户 端的 响应 。 

普通 Servlet 类 里 的 service0 方 法 的 作用 ， 完 全 等 同 于 JSP 生成 Servlet 类 的 _jspService0 方 法 。 因 
此 原 JSP 页 面 的 JSP 脚本、 静态 HTML 内 容 , 在 普通 Servlet 里 都 应 该 转换 成 service0 方 法 的 代码 或 输 
出 语句 ， 原 JSP 声明 中 的 内 容 ， 对 应 为 在 Servlet 中 定义 的 成 员 变 量 或 成 员 方法 。 


提示 : 
上 面 Servlet 类 中 粗 体 宇 代码 所 定义 的 @WebServlet 属于 Servlet 3.0 的 Annotation， 下 
面 会 详细 介绍 . | 


> >2.10.2 Servlet 的 配置 


编辑 好 的 Servlet 源 文件 并 不 能 响应 用 户 请 求 ， 还 必须 将 其 编译 成 class 文件 。 将 编译 后 的 
FirstServlet.class 文件 放 在 WEB-INF/classes 路 径 下 ， 如 果 Servlet 有 包 ， 则 还 应 该 将 class 文件 放 在 对 
应 的 包 路 径 下 (例如 ， 本 例 的 FirstServlet.class 就 放 在 WEB-INF/classes/lee 路 径 下 )。 


本 注意 :# 
如 果 需 要 直接 采用 javac 命令 来 编译 Servlet 类 ， 则 必须 将 Servlet API 接口 和 类 添加 | 
到 系统 的 CLASSPATH 环境 变量 里 .也 就 是 将 Tomcat 7 安装 目录 下 lib 目录 中 servlet-api. y 


jar 和 jsp-apijar 添加 到 CLASSPATH 环境 变量 中 


Servlet 能 响应 用 户 请 求 ， 须 将 Servlet 配置 在 Web 应 用 中 。 配 置 Servlet 时 ， 需 要 修改 


web.xml 文件 。 
从 Servlet 3.0 开始 ， 配 置 Servlet 有 两 种 方式 : 
> ”在 Servlet 类 中 使 用 @WebServlet Annotation 进行 配置 。 
> ”通过 在 web.xml 文件 中 进行 配置 。 
上 面 开发 Servlet 类 时 使 用 了 @WebServlet Annotation 修饰 该 Servlet 类 ， 使 用 @WebServlet 时 可 指 
定 如 表 2.2 所 示 的 常用 属性 。 


表 2.2 @WebServlet 支持 的 常用 属性 


属 性 是 否 必 需 说 明 
asyncSuppored | 理 指定 该 Serviet 是 井 支 持 异步 操作 模式 。 关 于 Serviet 的 异步 调用 请 参考 2.15 节 
displayName 香 指定 访 Serviet 的 显示 名 
initParams 理 用 于 为 访 Serviet 配置 参数 

| eaaonsurnup 理 用 于 将 该 Serviet 配置 成 load-on-startup 的 Serviet 
name 理 指定 该 Serviet 的 名 称 
urlPattemsvalue | 理 这 两 个 属性 的 作用 完全 相同 。 都 指定 该 Serviet 处 理 的 URL 
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如 果 打 算 使 用 Annotation 来 配置 Serviet， 有 两 点 需要 指出 : 

> 不 要 在 web.xml 文件 的 根 元 素 (<web-app.../>) 中 指定 metadata-complete="true"。 

> 不 要 在 web.xml 文件 中 配置 该 Servlet。 

如 果 打算 使 用 web.xml 文件 来 配置 该 Servlet， 则 需要 配置 如 下 两 个 部 分 。 

> 配置 Servlet 的 名 字 : 对 应 web.xml 文件 中 的 <servlet/> 元 素 。 

> 配置 Servlet 的 URL: 对 应 web.xml 文件 中 的 <servlet-mapping/> 元 素 。 这 一 步 是 可 选 的 。 
但 如 果 没 有 为 Servlet 配置 URL， 则 该 Servlet 不 能 响应 用 户 请 求 。 


| 接 下 来 的 Servlet、Filter、Listener 等 相关 配置， 笔者 都 人 同时 介绍 使 用 webxml 配 
| 置 、 使 用 Annotaion 配置 的 两 种 方式 但 实际 项 目 中 只 要 采用 任意 一 种 配置 方式 即 可 ， 
| 不 需要 同时 使 用 两 种 配置 方式. 

: 


因此 ， 配 置 一 个 能 响应 客户 请 求 的 Servlet， 至 少 需 要 配置 两 个 元 素 . 关于 上 的 FirstServlet 的 配 
置 如 下 。 
程序 清单 :codes\02\2.10\servletDemoVWEB-INF\web.xml 
<!-- 配置 Servlet 的 名 字 --> 
<servlet> 
<!-- 指定 Servlet 的 名 字 ; 
相当 于 指定 eWebservlet 的 name 属性 --> 
<servlet-name>firstServlet</servlet-name> 
<!-~- 指定 Servlet 的 实现 类 --> 
<servlet-class>lee.FirstServlet</servlet-class> 
</servlet> 
<!-- 配置 Servlet 的 URL --> 
<servlet-mapping> 
指定 Servlet 的 名 字 -> 
<servlet-name>firstServlet</servlet-name> 
<!-- 指定 Servlet 映射 的 URL 地 址 ， 
相当 于 指定 8WebServlet 的 urlPatterns 属性 --> 
<url-pattern>/aa</url-pattern> 
</servlet-mapping> 


如 果 在 web.xml 文件 中 增加 了 如 上 所 示 的 粗 体 字 配 置 片段 ， 则 该 Servlet 的 URL 为 /aa。 如 果 没 有 在 
web.xml 文件 中 增加 上 面 的 粗 体 字 配 置 片段 ， 那 么 该 Servlet 类 上 的 @WebServlet Annotation 就 会 起 作用 ， 
该 Servlet 的 URL 为 /firstServlet。 

将 2.9.6 节 中 的 form.jsp 复制 到 本 应 用 中 ， 并 对 其 进行 简单 修改 ， 将 form 表单 元 素 的 action 修改 成 
aa， 在 表单 域 中 输入 相应 的 数据 ， 然 后 单 击 “ 提 交 ” 按 钮 ， 效 果 如 图 2.32 所 示 。 


,ramyit 


你 的 性 别 ， 男 
低 喜 欢 的 颜色 。 红 择 
您 达 次 的 频 色 ， 您 来 自 的 国家 ， 中 国 


3 
图 2.32 Serviet 处 理 用 户 请 求 
在 这 种 情况 下 ，Servlet 与 JSP 的 作用 效果 完全 相同 。 
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>>2.10.3 JSP/Servlet 的 生命 周期 


JSP 的 本 质 就 是 Servlet， 开 发 者 编写 的 JSP 页 面 将 由 Web 容器 编译 成 对 应 的 Servlet， 当 Servlet 
在 容器 中 运行 时 ， 其 实例 的 创建 及 销毁 等 都 不 是 由 程序 员 决 定 的 ， 而 是 由 Web 容器 进行 控制 的 。 

创建 Servlet 实例 有 两 个 时 机 。 

> ”客户 端 第 一 次 请 求 某 个 Servlet 时 ， 系 统 创建 该 Servlet 的 实例 : 大 部 分 的 Servlet 都 是 这 种 

Servlet。 

> ”Web 应 用 启动 时 立即 创建 Servlet 实例 ， 即 load-on-startup Serviet。 

每 个 Servlet 的 运行 都 遵循 如 下 生命 周期 。 

(1) 创建 Servlet 实例 。 

(2) Web 容器 调用 Servlet 的 init 方法 ， 对 Servlet 进行 初始 化 。 

(3) Servlet 初始 化 后 ， 将 一 直 存在 于 容器 中 ， 用 于 响应 客户 端 请 求 。 如 果 客 户 端 发 送 GET 请 求 ， 
容器 调用 Servlet 的 doGet 方法 处 理 并 响应 请 求 ; 如 果 客 户 端 发 送 POST 请 求 ,容器 调用 Servlet 的 doPost 
方法 处 理 并 响应 请 求 。 或 者 统一 使 用 service( 方 法 处 理 来 响应 用 户 请 求 。 

(4) Web 容器 决定 销毁 Servlet 时 ， 先 调用 Servlet 的 destroy 方法 , 通常 在 关闭 Web 应 用 之 时 销毁 
Servlet。 

Servlet 的 生命 周期 如 图 2.33 所 示 。 


ELE EET 
@— | RE “| 


区 
a 


0 
人 
Pe E.R 
图 2.33 Servlet 的 生命 周期 


>>2.10.4 load-on-startup Servlet 


:一 节 中 已 经 介绍 过 ,创建 Servlet 实例 有 两 个 时 机 : 用 户 请 求 之 时 或 应 用 启动 之 时 。 应 用 启动 时 
就 创建 Servlet， 通 常 是 用 于 某 些 后 台 服务 的 Servlet， 或 者 需要 拦截 很 多 请 求 的 Servlet， 这 种 Servlet 
通常 作为 应 用 的 基础 Servlet 使 用 ， 提 供 重要 的 后 台 服务 。 

配置 load-on-startup 的 Servlet 有 两 种 方式 : 

> 在 web.xml 文件 中 通过 <servlet ../> 元 素 的 <load-on-startup.…/> 子 元 素 进行 配置 。 

> ”通过 @WebServlet Annotation 的 loadOnStartup 属性 指定 。 

<load-on-startup.…/> 元 素 或 loadOnStartup 属性 都 只 接收 一 个 整 型 值 ， 这 个 整 型 值 越 小 ，Servlet 就 
越 优先 实例 化 。 

下 面 是 一 个 简单 的 Servlet， 该 Servlet 不 响应 用 户 请 求 ， 它 仅仅 执行 计时 器 功能 ， 每 隔 一 段 时 间 会 
在 控制 台 打 印 出 当前 时 间 。 

程序 清单 : codes\02\2.10\servletDemoVWEB-INF\src\leeVTimerServletjava 


QWebservlet (loadonstartup=1 
ee class TimerServlet extends HttpServlet 


public void init(Servietconfig config)throws ServletExoeprion 
{ 

super. init (config); 

Timer t = new Timer(1000,new ActionListener() 
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public void actionperformed (ActionEvent e) 
{ 
System.out .println (new Date()); 

} 

a 

t.start(); 

} 
} 


这 个 Servlet 没有 提供 service0 方 法 ， 这 表明 它 不 能 响应 用 户 请 求 ， 所 以 无 须 为 它 配置 URL 映射 。 
由 于 它 不 能 接收 用 户 请 求 ， 所 以 只 能 在 应 用 启动 时 实例 化 。 

以 上 程序 中 粗 体 字 代码 Annotation 即 可 将 该 Servlet 配置 了 load-on-startup Servlet。 除 此 之 外 ， 还 
可 以 在 web.xml 文件 中 增加 如 下 配置 片段 。 

程序 清单 :codes\022.10\servletDemo\WWEB-INF\web.xml 


<servlet> 
<!-- Servlet 名--> 
<servlet-name>timerServlet</servlet-name> 
<!-- Servlet 的 实现 类 --> 
<servlet-class>lee.TimerServlet</servlet-class> 
<!-- 配置 应 用 启动 时 ， 创 建 Servlet 实例 

， 相 当 于 指定 8WebServlet 的 loadOnStartup 属性 --> 

<load-on-startup>1</load-on-startup> 

</servlet> 


以 上 配置 片段 中 粗 体 字 代 码 指定 Web 应 用 启动 时 ，Web 容器 将 会 实例 化 该 Servlet， 且 该 Servlet 
不 能 响应 用 户 请 求 ， 将 一 直 作为 后 台 服 务 执行 ， 每 隔 1 分 钟 输出 一 次 系统 时 间 。 


》>》》2.10.5 访问 Servlet 的 配置 参数 


配置 Servlet 时 , 还 可 以 增加 额外 的 配置 参数 。 通 过 使 用 配置 参数 , 可 以 实现 提供 更 好 的 可 移植 性 ， 
避免 将 参数 以 硬 编码 方式 写 在 程序 代码 中 。 

为 Servlet 配置 参数 有 两 种 方式 : 

> ”通过 @WebServlet 的 initParams 属性 来 指定 。 

> ”通过 在 web.xml 文件 的 <servlet..…/> 元 素 中 添加 <init-param.../> 子 元 素来 指定 。 

第 二 种 方式 与 为 JSP 配置 初始 化 参数 极其 相似 ， 因 为 JSP 的 实质 就 是 Servlet， 而 且 配置 JSP 的 实 
质 就 是 把 JSP 当 Servlet 使 用 。 

访问 Servlet 配置 参数 通过 ServletConfig 对 象 完成 ，ServletConfig 提供 如 下 方法 。 

> java.lang.String getinitParameter(java.lang.String name): 用 于 获取 初始 化 参数 。 

人 


JSP 的 内 置 对 象 config 就 是 此 处 的 ServletConfig. ey 
息 ， 而 是 


下 面 的 Servlet 将 会 连接 数据 库 ， 并 执行 SQL 查询 ， 但 程序 并 未 直接 给 出 数据 连 : 
将 数据 库 连 接 信息 放 在 web.xml 文件 中 进行 管理 。 
程序 清单 :codes\022.10\servletDemo\WEB-INF\src\lee\TestServietjava 


QHebservlet (name="testServlet" 
, urlpatterns={"/testServlet"} 
, initParams={ 
@WebInitParam(name="driver", value="com.mysql.jdbc.Driver"), 
@WebInitParan (name="url", value="jdbc:mysql://localhost: 3306/javaee"), 
WebInitParam (name="user", value="root"), 
@WebInitParan (name="pass", value="32147") }) 
public class TestServlet extends HttpServlet 
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// 重 写 init 方法 ， ¢ 
public void init (ServletConfig config) 
throws ServletException 


// 重 写 该 方法 ， 应 该 首先 调用 父 类 的 init 方法 
super.init (config); 


} 

// 响 应 客户 端 请 求 的 方法 

public void service(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletExceptionyjava.io.IOException 


try 
本 
// 获 取 ServletConfig 对 象 
ServletConfig config = getServletConfig()7 
// 通 过 ServletConfig 对 象 获取 配置 参数 ，dirver 
String driver = config.getInitParameter("driver") 7 
// 通 过 ServletConfig 对 象 获取 配置 参数 ，url 
String url = config.getInitParaneter ("url"); 
// 通 过 ServletConfig 对 象 获取 配置 参数 : user 
String user = config.getInitParameter ("user") ; 
// 通 过 ServletConfig 对 象 获取 配置 参数 : pass 
String pass = config.getInitParameter ("pass"); 
// 注 册 驱 动 
Class. forName (driver); 
// 获 取 数 据 库 驱动 
Connection conn = DriverManager.getConnection(url,user,pass); 
// 创 建 Statement 对 象 
Statement stmt = conn.createStatement();} 
// 执 行 查询 ， 获 取 ResuletSet 对 象 
ResultSet rs = stmt.executeQuery("select * from news_inf"); 
response.setContentType ("text/html;charSet=gbk") ; 
// 获 取 页 面 输出 流 
PrintStream out = new PrintStream(response.getoutputStream()); 
// 输 出 HTML 标签 
out.printin("<html>"); 
out.printin("<head>"); 
out .println("<title> 访 问 Servlet 初始 化 参数 测试 </title>"); 
out,printin("</head>" 
out .println("<body>"); 
out .println("<table bgcolor=\"#9999dd\" border=\"1\"" + 
wwidth=\"480\">"); 
// 遍 历 结 果 集 
while lrs.next ()) 


{ 
// 输 出 结果 集 内 容 
out .sprintln("<tr>"); 
out.println("<td>" + rs.getString(1) + "</td>"); 
out.printlin("<td>" + rs.getString(2) + "</td>"); 
out.println("</tr>"); 


} 

out .printin("</table>"); 
out.printin("</body>") 
out.printin("</html>"); 


} 
catch (Exception e) 
{ 

e.printstackTrace (); 
} 


} 


ServletConfig 获取 配置 参数 的 方法 和 ServletContext 获取 配置 参数 的 方法 完全 一 样 ， 只 是 
ServletConfig 是 取得 当前 Servlet 的 配置 参数 ， 而 ServletContext 是 获取 整个 Web 应 用 的 配置 参数 。 


了 03 


http://52pdf.taobao.com 
蔗 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


以 上 程序 中 粗 体 字 @WebServlet 中 的 initParams 属性 用 于 为 该 Servlet 配置 参数 , initParams 属性 值 
的 每 个 @WebInitParam 配置 一 个 初始 化 参数 ， 每 个 @WebInitParam 可 指定 如 下 两 个 属性 。 

> name: 指定 参数 名 。 

> ”value: 指定 参数 值 。 

类 似 地 ， 在 web.xml 文件 中 为 Servlet 配置 参数 使 用 <initparam... 人 > 元素， 该 元 素 可 以 接受 如 下 两 
个 子 元 素 。 

> ”param-name: 指定 配置 参数 名 。 

> ”param-value: 指定 配置 参数 值 。 

下 面 是 该 Servlet 在 web.xml 文件 中 的 配置 片段 。 

程序 清单 : codes\02W2.10\servletDemo\WWEB-INF\web.xml 


<servlet> 
<!-- 配置 Servlet 名 --> 
<servlet-name>testServlet</servlet-name> 
<!-- 指定 Servlet 的 实现 类 --> 
<servlet-class>lee.TestServlet</servlet-class> 
<!-- 配置 Servlet 的 初始 化 参数 ; driver --> 


<init-param> 
<param-name>driver</param-name> 
<param-value>com. mysql .jdbc.Driver</param-value> 

</init-param> 

<!-- 配置 Servlet 的 初始 化 参数 : url --> 

<init-param> 


<param-name>url</param-name> 
<param-value>jdbc:mysql://localhost:3306/javaee</param-value> 
</init-param> 
<!-- 配置 Servlet 的 初始 化 参数 : user --> 
<init-param> 
<param-name>user</param-name> 
<param-value>root</param-value> 
</init-param> 
<!-- 配置 Servlet 的 初始 化 参数 ，pass --> 
<init-param> 
<param-name>pass</param-name> 
<param-value>32147</param-value> 
</init-param> 
</servlet> 
<servlet-mapping> 
<!-- 确定 Servlet 名 --> 
<servlet-name>testServlet</servlet-name> 
<!-- 配置 Servlet 映射 的 URL --> 
<url-pattern>/testServlet</url-pattern> 
</servlet-mapping> 


以 上 配置 片段 的 粗 体 字 代码 配置 了 4 个 配置 参数 ，Servlet 通过 这 4 个 配置 参数 就 可 连接 数据 库 。 
在 浏览 器 中 浏览 该 Servlet， 可 看 到 数据 库 查 询 成 功 ( 如 果 数 据 库 的 配置 正确 )。 


>>2.10.6 使 用 Servlet 作为 控制 器 


正如 前 面 见 到 的 ， 使 用 Servlet 作为 表现 层 的 工作 量 太 大 ， 所 有 的 HTML 标签 都 需要 使 用 页 面 输 
出 流 生成 。 因 此 ， 使 用 Servlet 作为 表现 层 有 如 下 三 个 劣势 。 

> ”开发 效率 低 ， 所 有 的 HTML 标签 都 需 使 用 页 面 输出 流 完成 。 

> 不 利于 团队 协作 开发 ， 美 工人 员 无 法 参与 Servlet 界面 的 开发 。 

> ”程序 可 维护 性 差 ， 即 使 修改 一 个 按钮 的 标题 ， 都 必须 重新 编辑 Java 代码 ， 并 重新 编译 。 

在 标准 的 MVC 模式 中 ，Servlet 仅 作为 控制 器 使 用 。Java EE 应 用 架构 正 是 遵循 MVC 模式 的 ， 对 
于 遵循 MVC 模式 的 Java EE 应 用 而 言 ，JSP 仅 作 为 表现 层 (View) 技术 ， 其 作用 有 两 点 : 
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> ”负责 收集 用 户 请 求 参 数 。 

> ”将 应 用 的 处 理 结果 、 状 态 数据 呈现 给 用 户 。 

Servlet 则 仅 充 当 控 制 器 (Controller) 角 色 , 它 的 作用 类 似 于 调度 员 : 所 有 用 户 请 求 都 发 送 给 Servlet， 
Servlet 调用 Model 来 处 理 用 户 请 求 ， 并 调用 JSP 来 呈现 处 理 结果 ; 或 者 Servlet 直接 调用 JSP 将 应 用 
的 状态 数据 呈现 给 用 户 。 

Model 通常 由 JavaBean 来 充当 ， 所 有 业务 逻辑 、 数 据 访问 逻辑 都 在 Model 中 实现 。 实际 上 隐藏 在 
Model 下 的 可 能 还 有 很 多 丰富 的 组 件 ， 例 如 DAO 组 件 、 领 域 对 象 等 。 

下 面 介 绍 一 个 使 用 Servlet 作为 控制 器 的 MVC 应用， 该 应 用 演示 了 一 个 简单 的 登录 验证 。 

下 面 是 本 应 用 的 登录 页 面 。 

程序 清单 : codes\02\2.10\servletDemo\loginjsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 

<!DOCTYPE html PUBLIC "~//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://wuw.w3.org/TR/xhtml1/DTD/xhtml1-transitional .dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 

<title> new document </title> 
</head> 
<body> 
<!-- 输出 出 错 提示 --> 
<span style="color:red;font-weight:bold"> 
<Hif (request.getAttribute("err") != null) 
{ 
out.println (request.getAttribute ("err") + "<br/>"); 
}%> 
</span> 
请 输入 用 户 名 和 密码 : 
<!-- 登录 表单 ， 该 表单 提交 到 一 个 Servlet --> 
<form id="login" method="post" action="login"> 
用 户 名 ， <input type="text" name="username"/><br/> 
蜜 ksnbspyknbsp 码 : <input type="password" name="pass"/><br/> 
<input type="submit”value=" 登 录 "/><br/> 
</form> 
</body> 
</html> 


以 上 页 面 除了 粗 体 字 代码 使 用 JSP 脚本 输出 错误 提示 之 外 ， 该 页 面 其 实 是 一 个 简单 的 表单 页 面 ， 
ed ei 并 将 请 求 提交 到 指定 Servlet， 该 Servlet 充当 控制 器 角色 。 


Py. 


根据 严格 的 MVC 规范 ， 上 面 的 1 login.jsp 页 面 也 不 应 该 被 客户 端 直接 访问 ， 客 户 的 
请 求 应 该 先 发 送 到 指定 Servlet， 然 后 由 Servlet 将 请 求 forward 到 该 JSP 页 面 。 守 


控制 器 Servlet 的 代码 如 下 。 
程序 清单 : codes\022.10\servletDemo\WWEB-INF\src\lee\LoginServlet.java 
@Webservlet (name="login" 


, urlPpatterns={"/login"}) 
public class LoginServlet extends HttpSservlet 


{ 

// 响 应 客户 端 请 求 的 方法 

Public void service(HttpServletRequest request; 
RttpServletResponse response) 
throws ServletException, java.io.1IOException 

{ 
String errMsg = mn 
//Servlet 本 身 并 不 输出 响应 到 客户 端 ， 因 此 必须 将 请 求 转发 
RequestDispatcher rd; 
// 获 取 请 求 参数 
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String username = request.getParameter ("username"); 
String pass = request.getParameter ("pass"); 
try 
{ 
//Servlet 本 身 ， 并 不 执行 任何 的 业务 过 辑 处 理 ， 它 调用 JavaBean 处 理 用 户 请 求 
DbDao, dd = new DbDao ("com.mysql .jdbc.Driver", 
“jdbe:mysql://localhost:3306/liuyan", "root", "32147"); 
// 查 询 结果 集 
ResultSet rs = dd.query("select pass from user_table " 
+ "where name = ?", username); 
if (rs.next()) 


// 用 户 名 和 密码 匹配 
if (rs.getstring("pass") .equals (pass)) 
{ 
// 获 取 session 对 象 
HttpSession session = request.getSession(true)7 
// 设 置 session 属性 ， 跟 踪 用 户 会 话 状态 
session, setAttribute ("name" , username); 
7/ 获取 转 发 对 象 
rd = request.getRequestDispatcher ("/welcome.jsp"); 
// 转 发 请 求 


rd.forward(request, respons: 


else 


// 用 户 名 和 密码 不 匹配 时 
errMsg +=“ 您 的 用 户 名 密码 不 符合 , 请 重新 输入 "; 


else 


// 用 户 名 不 存在 时 
errMsg +~ "您 的 用 户 名 不 存在 ,请 先 注册 "; 
} 
上 
catch (Exception e) 
{ 
@.printstackTrace(); 


上 

// 如 果 出 错 ， 转 发 到 重新 登录 

if (errMsg != null 6é !errMsg.equals("")) 

{ 
rd = request.getRequestDispatcher ("/login.jsp"); 
request.setAttribute ("err" , errMsg); 
rd. forward(request, response); 


} 
} 


控制 器 负责 接收 客户 端的 请 求 ， 它 既 不 直接 对 客户 端 输出 响应 ， 也 不 处 理 用 户 请 求 ， 只 调用 
JavaBean 来 处 理 用 户 请 求 ， 如 程序 中 粗 体 字 代码 所 示 : JavaBean 处 理 结束 后 ，Servlet 根据 处 理 结果 ， 
调用 不 同 的 JSP 页 面向 浏览 器 呈现 处 理 结果 。 

上 面 Servlet 使 用 @WebServlet Annotation 为 该 Servlet 配置 了 URL 为 /login， 因 此 向 /login 发 送 的 
请 求 将 会 交 给 该 Servlet 处 理 。 

下 面 是 本 应 用 中 DbDao 的 源 代码 。 

程序 清单 : codes\02\2.10\servletDemo\WWEB-INF\src\lee\DbDao.java 


public class ‘DbDao 
{ 
private Connection conn; 
private String driver; 
private String url; 
private String username; 
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private String pass’ 
public DbDao() 
{ 
} 
public DbDao (String driver, String Url 
, String username, String pass) 
{ 
this.driver = driver; 
this.url = url; 
this.username = username; 
this.pass = pass7 


} 

// 下 面 是 各 个 成 员 属 性 的 setter 和 getter 方法 

public void setDriver (String driver) { 
this.driver = driver; 

} 

public void setUrllstring url) { 
this.url = url; 

+ 

public void setUsername (String username) { 
this.username = username; 

上 

public void setPass(String pass) { 
this.pass = pass; 

} 

public String getDriver() { 
return (this.driver); 

} 

public string getUrl{) { 
return (this.url); 

上 

public String getUsername() { 
return (this.username); 

} 

public string getPass() { 
return (this.pass); 


】} 
// 获 取 数 据 库 连接 
public Connection getConnection() throws Exception 
{ 
if (conn == null) 
{ 
Class. forName (this.driver); 
conn = DriverManager.getConnection (url,username, 
this. pass); 


return conn; 


¥ 
// 揪 入 记录 
public boolean insert(String sql , Object... args) 
throws Exception 
{ 
PreparedStatement pstmt = getConnection() .prepareStatement (sql); 
for (int i = 0; i < args.length; i++ ) 
{ 
pstmt.setobject( i + 1, args[i]); 
} 
if (pstmt.executeUpdate() != 1) 
{ 
return false; 
站 
return true; 
上 
7/ 执行 查询 
public ResultSet query(String sql, Object... args) 
throws Exception 
{ 
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PreparedStatement pstmt = getConnection{() .prepareStatement (sql); 
for (int i = 0; i < args.length; i++t ) 
{ 
pstmt.setobject( i + 1, args[i]); 
和 
return pstmt .executeQuery()7 


} 
// 执 行 修改 
public void modify (String sql, Object... args) 
throws Exception 
{ 
Preparedstatement pstmt = getConnection() .preparestatement (sql); 
for (int i = 0; i < args.length ; i++ 小 
{ 
Ppstmt.setobject( i + 1 , args[i]); 
} 
Pstmt .executeUpdate(); 
pstmt. close(); 


} 

// 关 闭 数据 库 连 接 的 方法 

public void closeConn() 
throws Exception 

{ 
if (conn != null &5 !conn.isClosed()) 
{ 


} 


conn.close(); 


】} 


} 
上 面 DbDao 负责 完成 查询 、 插 入 、 修 改 等 操作 。 从 上 面 这 个 应 用 的 结构 来 看 ， 整 个 应 用 的 流程 非 
常 清晰 ， 下 面 是 MVC 中 各 个 角色 的 对 应 组 件 。 
> M: Model， 即 模型 ， 对 应 JavaBean。 
> V: View， 即 视图 ， 对 应 JSP 页 面 。 
> C: Controller, 即 控制 器 ， 对 应 Servlet。 


本 应 用 需要 底层 数据 库 的 支持 ， 读 者 可 以 向 MysQL 数据 库 中 导入 codes\02\2.10\db. 
sql 脚 本， 这 些 脚本 提供 了 本 应 用 所 需 的 数据 库 支持 。 可 


2.11 JSP 2 的 自 定义 标签 


在 JSP 规范 的 1.1 版 中 增加 了 自 定义 标签 库 规范 ， 自 定义 标签 库 是 一 种 非常 优秀 的 表现 层 组 件 技 
术 。 通 过 使 用 自 定义 标签 库 ， 可 以 在 简单 的 标签 中 封装 复杂 的 功能 。 

为 什么 要 使 用 自 定义 标签 呢 ? 主要 是 为 了 取代 丑陋 的 JSP 脚本 。 在 HTML 页 面 中 插入 JSP 脚本 有 
如 下 几 个 坏处 : 

> ”JSP 脚本 非常 丑陋 ， 难 以 阅读 。 

> “JSP 脚本 和 HTML 代码 混杂 ， 维 护 成 本 高 。 

> ”HTML 页 面 中 霸 入 JSP 脚本 ， 导 致 美工 人 员 难 以 参与 开发 。 

出 于 以 上 三 点 的 考虑 , 我 们 需要 一 种 可 在 页 面 中 使 用 的 标签 , 这 种 标签 具有 和 HTML 标签 类 似 的 
语法 ， 但 有 可 以 完成 JSP 脚本 的 功能 一 这 种 标签 就 是 JSP 自 定义 标签 。 

在 JSP 1.1 规范 中 开发 自 定义 标签 库 比 较 复杂 ，JSP 2 规范 简化 了 标签 库 的 开发 ， 在 JSP 2 中 开发 
标签 库 只 需 如 下 几 个 步骤 。 

人 GCC 开发 自 定义 标签 处 理 类 ; 
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2 


人 建立 一 个 ld 文件 ， 每 个 *.tld 文件 对 应 一 个 标签 库 ， 每 个 标签 库 可 包含 多 个 标签 ; 
G 在 JSP 文件 中 使 用 自 定义 标签 。 


条 注重 ， 和 
标签 库 是 非常 重要 的 技术 ， 通常 来 说 ， 初学 者 、 普通 开发 人 员 自己 开发 标签 库 的 机 会 
很 少 ,但 如 果 希 望 成 为 高 级 程序 员 ， 或 者 希望 开发 通用 框架 ,就 需要 大 量 开发 自 定义 标签 要 


了 。 所 有 的 MVC 框架 ， 如 Struts 2、 人 JSF 等 都 放 供 了 让 十 的 自 定义 标签。 


>>2.11.1 开发 自 定义 标签 类 


在 JSP 页 面 使 用 一 个 简单 的 标签 时 ， 底 层 实际 上 由 标签 处 理 类 提供 支持 ， 从 而 可 以 通过 简单 的 标 
签 来 封装 复杂 的 功能 ， 从 而 使 团队 更 好 地 协作 开发 (能 让 美工 人 员 更 好 地 参与 JSP 页 面 的 开发 )。 
自 定义 标签 类 应 该 继承 一 个 父 类 : javax.servlet.jsp.tagext.SimpleTagSupport， 除 此 之 外 ，JSP 自 定 
义 标签 类 还 有 如 下 要 求 : 
> ”如 果 标签 类 包含 属性 ， 每 个 属性 都 有 对 应 的 getter 和 setter 方法 。 
> 重 写 doTag() 方 法 ， 这 个 方法 负责 生成 页 面 内 容 。 
下 面 开 发 一 个 最 简单 的 自 定义 标签 ， 该 标签 负责 在 页 面 上 输出 HelloWorld。 
程序 清单 :codes\022.11\tagDemo\WWEB-INF\src\lee\HelloWorldTagjava 
public class HelloWorldTag extends SimpleTagSupport 
// 重 写 doTag 方法 ， 该 方法 在 标签 结束 生成 页 面 内 容 
Public void doTag () throws JspException, 
IOException 
// 获 取 页 面 输出 流 ， 并 输出 字符 申 
getJspContext () .getout () .write ("Hello World " 
+ new java.util.Date()); 
} 
上 面 这 个 标签 处 理 类 非常 简单 ， 它 继承 了 SimpleTagSupport 父 类 , 并 重 写 doTag0 方 法 , 而 doTag0) 
方法 则 负责 输出 页 面 内 容 。 该 标签 没有 属性 ， 因 此 无 须 提供 setter 和 getter 方法 。 


> >2.11.2 建立 TLD 文 件 


TLD 是 Tag Library Definition 的 缩写 ， 即 标签 库 定义 ， 文 件 的 后 缀 是 td， 每 个 TLD 文件 对 应 一 
个 标签 库 ， 一 个 标签 库 中 可 包含 多 个 标签 。TLD 文件 也 称 为 标签 库 定义 文件 。 
标签 库 定义 文件 的 根 元 素 是 taglib, 它 可 以 包含 多 个 tag 子 元 素 , 每 个 tag 子 元 素 都 定义 一 个 标签 。 
通常 我 们 可 以 到 Web 容器 下 复制 一 个 标签 库 定义 文件 , 并 在 此 基础 上 进行 修改 即 可 。 例如 Tomcat 7.0， 
在 webapps\examples\WEB-INF\jsp2 路 径 下 包含 了 一 个 jsp2-example-taglib.tld 文件 ， 这 就 是 一 个 TLD 
文件 的 范例 。 
将 该 文件 复制 到 Web 应 用 的 WEB-INF/ 路 径 ， 或 WEB-INF 的 任意 子路 径 下 ， 并 对 该 文件 进行 简 
单 修改 ， 修 改 后 的 mytaglib.tld 文件 代码 如 下 。 
程序 清单 : codes\02W2.11\tagDemo\WWEB-INF\src\mytaglib.tld 
<?xml version="1.0" encoding="GBK"?> 
<taglib xmlns="http://java.sun.com/xml/ns/j2ee" 


xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java. sun.com/xml /ns/j2ee web-jsptaglibrary 2 0.xsd" 
version="2.0"> 

<tlib-version>1.0</tlib-version> 

<short-name>mytaglib</short-name> 
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<!-- 定义 该 标签 库 的 URI --> 
<uri>http://ww.crazyit.org/mytaglib</uri> 
<!-- 定义 第 一 个 标签 -> 

tag> 


<!-- 定义 标签 处 理 类 --> 


</taglib> 


上 面 的 标签 库 定义 文件 也 是 一 个 标准 的 XML 文件， 该 XML 文件 的 根 元 素 是 taglib 元 素 ， 因 此 我 


们 每 次 编写 标签 库 定 义 文件 时 都 直接 添加 该 元 素 即 可 。 
taglib 下 有 如 下 三 个 子 元 素 。 
> ”tib-version: 指定 该 标签 库 实现 的 版 本 ， 这 是 一 个 作为 标识 的 内 部 版 本 号 ， 对 程序 没有 太 大 


的 作用 。 


> ”short-name: 该 标签 库 的 默认 短 名 ， 该 名 称 通常 也 没有 太 大 的 用 处 。 
> “uri: 这 个 属性 非常 重要 ， 它 指定 该 标签 库 的 URI， 相 当 于 指定 该 标签 库 的 唯一 标识 。 如 上 面 


斜体 字 代码 所 示 ，JSP 页 面 中 使 用 标签 库 时 就 是 根据 该 URI 属性 来 定位 标签 库 的 。 


除 此 之 外 ，taglib 元 素 下 可 以 包含 多 个 tag 元 素 , 每 个 tag 元 素 定义 一 个 标签 ，tag 元 素 下 允许 出 现 
如 下 常用 子 元 素 。 

> ”name: 该 标签 库 的 名 称 ， 这 个 子 元 素 很 重要 ，JSP 页 面 中 就 是 根据 该 名 称 来 使 用 此 标签 的 。 

> ”tag-class: 指定 标签 的 处 理 类 ， 毋 庸 置疑 ， 这 个 子 元 素 非常 重要 ， 它 指定 了 标签 由 哪个 标签 


YY ™ 


?各 


:三 .注意 : 


处 理 类 来 处 理 。 

body-content 这 个 子 元 素 也 很 重要 ， 它 指定 标签 体内 容 。 该 子 元 素 的 值 可 以 是 如 下 几 个 。 
tagdependent: 指定 标签 处 理 类 自己 负责 处 理 标签 体 。 

empty: 指定 该 标签 只 能 作为 空 标签 使 用 。 

scriptless: 指定 该 标签 的 标签 体 可 以 是 静态 HTML 元 素 、 表 达 式 语言 ， 但 不 允许 出 现 JSP 
脚本 。 

JSP: 指定 该 标签 的 标签 体 可 以 使 用 JSP 脚本 。 

dynamic-attributes: 指定 该 标签 是 否 支持 动态 属性 。 只 有 当 定义 动态 属性 标签 时 才 需 要 该 子 
元 素 。 


因为 JSP2 规 范 不 再 推荐 使 用 JSP 脚本 ,所 以 JSP2 自 定义 标签 的 标签 体 中 不 能 包含 


JSP 脚本 。 所 以 ， 实 际 上 body-content 元 素 的 值 不 可 以 是 JSP。 


定义 了 上 面 的 标签 库 定义 文件 后 ,将 标签 库 文件 放 在 Web 应 用 的 WEB-INF 路 径 或 任意 子路 径 下 ， 
Java Web 规范 会 自动 加 载 该 文件 ， 则 该 文件 定义 的 标签 库 也 将 生效 。 


>> 


2.11.3 使 用 标签 库 


在 JSP 页 面 中 确定 指定 的 标签 需要 两 点 。 

> ”标签 库 URI: 确定 使 用 哪个 标签 库 。 

> 标签 名 : 确定 使 用 哪个 标签 。 

使 用 标签 库 分 成 以 下 两 个 步骤 。 

> ”导入 标签 库 : 使 用 taglib 编译 指令 导入 标签 库 ， 就 是 将 标签 库 和 指定 前 级 关联 起 来 。 
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和 2 


> ”使 用 标签 :在 JSP 页 面 中 使 用 自 定义 标签 。 
taglib 的 语法 格式 如 下 : 
<%@ taglib uri="tagliburi" prefix=ntagpreEiXn > 
其 中 uri 属性 确定 标签 库 的 URI， 这 个 URI 可 以 确定 一 个 标签 库 。 而 prefix 属性 指定 标签 库 前 级 ， 
即 所 有 使 用 该 前 组 的 标签 将 由 此 标签 库 处 理 。 
使 用 标签 的 语法 格式 如 下 : 
<tagPrefix:tagName tagAttribute="tagValue” .> 


<tagBody/> 
</tagPrefix: tagName> 


如 果 该 标签 没有 标签 体 ， 则 可 以 使 用 如 下 语法 格式 : 

<tagPrefix:tagName tagAttribute="tagValue” 3 

上 面 使 用 标签 的 语法 里 都 包含 了 设置 属性 值 ,前面 我 们 介绍 的 HelloWorldTag 标签 没有 任何 属性 ， 
所 以 使 用 该 标签 只 需 用 <mytag:helloWorld> 即 可 。 其 中 mytag 是 taglib 指令 为 标签 库 指定 的 前 级 ， 而 


helloWorld 是 标签 名 。 
下 面 是 使 用 helloWorld 标签 的 JSP 页 面 代 码 。 
程序 清单 :codes\022.11\tagDemo\helloWorldTagjsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 
<!-- 导入 标签 库 ， 指 定 mytag 前 级 的 标签 ， 
由 http://www. crazyit .org/mytaglib 的 标签 库 处 理 --> 
<%0 taglib uri="http://www.crazyit.org/mytaglib" prefix="mytag"®> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 自 定义 标签 示范 </title> 
</head> 
<body bgcolor="#ffffc0"> 
<h2> 下 面 显示 的 是 自 定义 标签 中 的 内 容 </h2> 
<!-- 使 用 标签 ， 其 中 mytag 是 标签 前 级 ， 根 据 taglib 的 编译 指令 ， 
mytag 前 纺 将 由 http://www.crazyit.org/mytaglib 的 标签 库 处 理 --> 
<mytag:helloWorld/><br/> 
</body> 
<yhtml> 


以 上 页 面 中 第 一 行 粗 体 字 代 码 指定 了 http://www.crazyit.org/mytaglib 标签 库 的 前 级 为 mytag， 第 二 
行 粗 体 字 代 码 表明 使 用 mytag 前 缀 对 应 标签 库 里 的 helloWorld 标签 。 浏览 该 页 面 将 看 到 如 图 2.34 所 示 
的 效果 。 


>>2.11.4 带 属性 的 标签 


前 面 的 简单 标签 既 没 有 属性 ， 也 没有 标签 体 ， 用 法 、 功 能 都 比较 简单 。 实 际 上 还 有 如 下 两 种 常用 
的 标签 : 
> 带 属 性 的 标签 。 
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> 。” 带 标签 体 的 标签 。 

正如 前 面 介绍 的 , 带 属性 标签 必须 为 每 个 属性 提供 对 应 的 setter 和 getter 方法 。 带 属性 标签 的 配置 
方法 与 简单 标签 也 略 有 差别 ， 下 面 介绍 一 个 带 属性 标签 的 示例 。 

程序 清单 :codes\02W2.11\tagDemo\WEB-INF\src\lee\Query Tagjava 

public class QueryTag extends SimpleTagSupport 


// 标 签 的 属性 

Private String driver; 

Private String url; 

Private String user; 

Private String pass; 

Private String sql; 

// 执 行 数据 库 访问 的 对 象 

private Connection conn = null; 
private Statement stmt = null; 
private Resultset rs = null; 
private ResultSetMetaData rsmd = null; 
// 省 略 driver 属性 的 setter 和 getter 方法 


77 省 略 url 属性 的 setter 和 getter 方法 
17/ 省略 user 属性 的 setter 和 getter 方法 
/7 省 略 pass 属性 的 setter 和 getter 方法 
77 省 略 sql 属性 的 setter 和 getter 方 法 


public void doTag()throws JspException, 
IOException 
{ 
try 
{ 
/7/ 注 册 驱 动 
Class. forName (driver) 7 
// 获 取 数 据 库 连接 
conn = DriyerManager.getConnection (url,user,pass); 
// 创 建 Statement 对 象 
stmt = conn.createStatement (); 
// 执 行 查询 
rs = Stmt.executeQuery(sq1)7 
rsmd = rs.getMetaData(); 
// 获 取 列 数 目 
int columnCount = rsmd.getColumnCount()7 
// 获 取 页 面 输出 流 
Writer out = getJspContext().getout(); 
// 在 页 面 输出 表格 
out.write("<table border='1' bgColor='#9999ce' width='400'>"); 
7/ 遍历 结果 集 
while (rs.next()) 
{ 
out.write("<tr>");} 
// 逐 列 输 出 查询 到 的 数据 
for (int i = 1 #1 <= ColumnCount ; i++ ) 
{ 
out .write("<td>"); 
out.write(rs.getstring (1)); 
out.write("</td>"); 


} 
out.write("</tr>"); 
} 
} 
catch (ClassNotFoundException cnfe) 
{ 
cnfe.printstackTrace(); 
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throw new JspException{" 自 定义 标签 错误 "+ cnfe.getMessage()); 
ee {SQLException ex) 
, ex.printstackTrace(); 

throw new JspException(" 自 定义 标签 错误 "+ ex.getMessage()); 
finally 


// 关 闭 结果 集 
try 
{ 
if (rs 1= null) 
rs:close(); 
if (stmt += null) 
stmt.close(); 
if (conn != null) 
conn.close(); 


} 
catch (SQLException sqle) 
{ 


aqle,printStackTrace ()7 
} 


} 
} 
上 面 这 个 标签 稍微 复杂 一 点 ， 它 包含 了 5 个 属性 ， 如 程序 中 粗 体 字 代 码 所 示 ， 程 序 需 要 为 这 5 个 
属性 提供 setter 和 getter 方法 。 
该 标签 输出 的 内 容 依然 由 doTag0 方 法 决定 ， 该 方法 会 根据 SQL 语句 查询 数据 库 ， 并 将 查询 结果 
显示 在 当前 页 面 中 。 
对 于 有 属性 的 标签 ， 需 要 为 <tag.… 人 > 元 素 增 加 <attribute.… 人 > 子 元 素 ， 每 个 attribute 子 元 素 定义 一 个 
标签 属性 。<attribute.…/> 子 元 素 通常 还 需要 指定 如 下 几 个 子 元 素 。 
> name: 设置 属性 名 ， 子 元 素 的 值 是 字符 串 内 容 。 
> ”required: 设置 该 属性 是 否 为 必需 属性 ， 该 子 元 素 的 值 是 true 或 false。 
> fragment: 设置 该 属性 是 否 支持 JSP 脚本 、 表 达 式 等 动态 内 容 ， 子 元 素 的 值 是 true 或 false。 
为 了 配置 上 面 的 QueryTag 标签 ， 我 们 需要 在 mytaglib.tld 文件 中 增加 如 下 配置 片段 。 
程序 清单 : codes\022.11\tagDemo\WWEB-INF\src\mytaglib.tld 
<!-- 定义 第 二 个 标签 --> 
<tag> 
<!-- 定义 标签 名 -=-> 
<name>query</name> 
<!-- 定义 标签 处 理 类 --> 
<tag-class>lee.QueryTag</tag-class> 
<!-- 定义 标签 体 为 空 --> 
<body-content>empty</body-content> 
<!-- 配置 标签 属性 :driver --> 


<attribute> 
<name>driver</name> 
<required>true</required> 
<fragment>true</fragment> 
</attribute> 
<!-- 配置 标签 属性 :url --> 
<attribute> 
<name>url</name> - pt | 
grequired>true</required> 
<fragment>true</fragment> a 
</attribute> 
<!-- 配置 标签 属性 :user 一 -> 
<attribute> 
<name>user</name> 
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<required>true</required> 
<fragment>true</fragment> 
</attribute> 
<!-- 配置 标签 属性 :Pass -> 
<attribute> 
<name>pass</name> 
<required>true</required> 
<fragment>true</fragment> 
</attribute> 
<!-- 配置 标签 属性 :sql --> 
<attribute> 
<name>sql</name> 
<required>true</required> 
<fragment>true</fragment> 
</attribute> 
</tag> 


上 面 5 行 粗 体 字 代 码 分 别 为 该 标签 配置 了 driver、url、user、pass 和 sql 5 个 属性 ， 并 指定 这 5 个 
属性 都 是 必需 属性 ， 而 且 属 性 值 支持 动态 内 容 。 

配 夺 后 ， 就 可 在 页 面 中 使 用 标签 了 ， 先 导入 标签 库 ， 然 后 使 用 标签 。 使 用 标签 的 JSP 页 面 片 
段 如 下 。 

程序 清单 :codes\022.11\tagDemo\queryTag.jsp 


<!-- 导入 标签 库 ， 指 定 mytag 前 级 的 标签 , 
由 http://www.crazyit ,org/mytaglib 的 标签 库 处 理 --> 
<88 taglib uri="http://www.crazyit.org/mytaglib" prefix="mytag"$> 


<!-- 其 他 HTML 内 容 --> 
<!-- 使 用 标签 ， 其 中 mytag 是 标签 前 级 ， 根 据 taglib 的 编译 指令 ， 

mytag 前 织 将 由 http: //www.crazyit.org/mytaglib 的 标签 库 处 理 --> 
<mytag: 


:query 
driver="com.mysql .jdbc.Driver" 
url="jdbe:mysql://localhost:3306/javaee" 
User="root" 

pass="32147" 

sql="select * from news_inf"/><br/> 


在 浏览 器 中 浏览 该 页 面 ， 效 果 如 图 2.35 所 示 。 


了 四 换个 下 历 四 3 加。 上 RD N39 


图 2.35 带 属性 的 标签 


在 JSP 页 面 中 只 需要 使 用 简单 的 标签 ， 即 可 完成 “复杂 ”的 功能 ， 执 行 数据 库 查 询 ， 并 将 查询 结 
果 在 页 面 上 以 表格 形式 显示 。 这 也 正 是 自 定义 标签 库 的 目的 一 一 以 简单 的 标签 ， 隐 藏 复杂 的 逻辑 。 

当然 ， 并 不 推荐 在 标签 处 理 类 中 访问 数据 库 ， 因 为 标签 库 是 表现 层 组 件 ， 它 不 应 该 包含 任何 业务 
逻辑 实现 代码 ， 更 不 应 该 执行 数据 库 访 问 ， 它 只 应 该 负责 显示 逻辑 


提示 :一 一 一 一 一 一 一 一 一 一 一 一 一 一 .一 一 
JSTL 是 Sun 提供 的 一 套 标 签 库 ， 这 套 标 签 库 的 功能 非常 强大 。 另外 ，DisplayTag 是 ， 
Apache 组 织 下 的 一 套 开 源 标签 库 ， 主 要 用 于 生成 页 面 并 显示 效果 . | 
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>>2.11.5 带 标签 体 的 标签 


带 标签 体 的 标签 ， 可 以 在 标签 内 嵌入 其 他 内 容 〈 包 括 静态 的 HTML 内 容 和 动态 的 JSP 内 容 )， 通 
常用 于 完成 一 些 逻 辑 运算 ， 例 如 判断 和 循环 等 。 下 面 以 一 个 迭代 器 标签 为 示例 ， 介 绍 带 标签 体 标签 的 
开发 过 程 。 

一 样 先 定义 一 个 标签 处 理 类 ， 该 标签 处 理 类 的 代码 如 下 。 

程序 清单 : codes\02\2.11\tagDemovWEB-INF\srcWee\lteratorTag,java 

public class IteratorTag extends SimpleTagSupport 


{ 
// 标 签 属性 ， 用 于 指定 需要 被 迁 代 的 集合 
private String collection; 
// 标 签 属性 ， 指 定 选 代 集合 元 素 ， 为 集合 元 素 指定 的 名 称 
private String item; 
// 省 略 collection 属性 的 setter 和 getter 方 法 


// 省 略 item 属性 的 setter 和 getter 方法 


// 标 签 的 处 理 方法 ， 简 单 标签 处 理 类 只 需要 重 写 doTag 方法 
public void doTag() throws JspException, IOException 


{ 
// 从 page scope 中 获取 属性 名 为 collection 的 集合 
Collection itemList = (Collection)getJspContext(). 
getAttribute (collection); 
// 遍 历 集合 
for (Object s : itemList) 


{ 
// 将 集合 的 元 素 设置 到 page 范围 
getJspContext () ,setAttribute(item, s ); 
// 输 出 标签 体 
getJspBody () .invoke (nul1) ; 


) 
} 

上 面 的 标签 处 理 类 与 前 面 的 处 理 类 并 没有 太 大 的 不 同 ， 该 处 理 类 包含 两 个 属性 ， 并 为 这 两 个 属性 
提供 了 setter 和 getter 方法 。 标签 处 理 类 的 doTag 方法 首先 从 page 范围 内 获取 了 指定 名 称 的 Collection 
对 象 ， 然 后 遍历 Collection 对 象 的 元 素 ， 每 次 饥 历 都 调用 了 geUspBody0 方 法 ， 如 程序 中 粗 体 字 代码 所 
示 ， 该 方法 返回 该 标签 所 包含 的 标签 体 ，JspFragment 对 象 ， 执 行 该 对 象 的 invoke0 方 法 ， 即 可 输出 标 
签 体内 容 。 该 标签 的 作用 是 ， 遍历 指 定 集 合 ， 每 遍历 一 个 集合 元 素 ， 即 输出 标签 体 一 次 。 

因为 该 标签 的 标签 体 不 为 室 ， 配 置 该 标签 时 指定 body-content 为 scriptless， 该 标签 的 配置 代码 片 
段 如 下 所 示 。 

程序 清单 ,codes\2\2.11\tagDemoVWEB-INF\srcumytaglib.tld 

<1-- 定义 第 三 个 标签 --> 
<tag> 
<!-- 定义 标签 名 --> 
<name>iterator</name> 
<!-- 定义 标签 处 理 类 --> 
<tag-class>lee. IteratorTag</tag-class> 
<!- 定义 标签 体 不 允许 出 现 JSP 脚本 一 > 
content>scriptless</body-content> 
<!-~ 配置 标签 属性 :collection --> 
<attribute> 
<name>collection</name> 
<required>true</required> 
<fragment>true</fragment> 
</attribute> 
<!-- 配置 标签 属性 :item 一 -> 
<attribute> 
<name>item</name> 
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<required>true</required> 
<fragment>true</fragment> 
</attribute> 
</tag> 
上 面 的 配置 片段 中 粗 体 字 代 码 指定 该 标签 的 标签 体 可 以 是 静态 HTML 内 容 ， 也 可 以 是 表达 式 语 
言 ， 但 不 允许 出 现 JSP 脚本 。 
为 了 测试 在 JSP 页 面 中 使 用 该 标签 的 效果 , 我 们 首先 把 一 个 List 对 象 设置 成 page 范围 的 属性 , 然 
后 使 用 该 标签 来 迭代 输出 List 集合 的 全 部 元 素 。 
JSP 页 面 中 使 用 该 标签 的 代码 片段 如 下 。 
程序 清单 : codes\02W2.11\tagDemo\iteratorTag.jsp 
<%@ page contentType="text/html; charset=GBK" le errorPage="" 8> 
<%0@ page import="java.util.*"$> 
<!-- 导入 标签 库 ， 指 定 mytag 前 级 的 标签 ， 
由 http://www.crazyit.org/mytaglib 的 标签 库 处 理 --> 
<%8 taglib uri="http://www.craryit.org/mytaglib" prefix="mytag"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<body> 
<h2> 带 标签 体 的 标签 - 选 代 器 标签 </h2><hr/> 
<% 
// 创 建 一 个 List 对 象 
st<string> a new ArrayList<String>(); 
("疯狂 Java") ; 
("www.crazyit .org"); 
("java"); 
77 将 于 st 对 象 放 入 page 范围 内 
pageContext.setAttribute("a" , a); 
%> 
<table border="1" bgcolor="#aaaadd" width="300"> 
<!-- 使 用 选 代 器 标签 ， 对 a 集合 进行 选 代 --> 
<mytag:iterator collection="a" item="item"> 
<tr> 
<td>${pagescope. item)</td> 
<tr> 
</mytag:iterator> 
</table> 
</body> 


上 面 的 页 面 代码 中 粗 体 字 代 码 即 可 实现 通过 iterator 标签 来 遍历 指定 集合 , 浏览 该 页 面 即 可 看 到 如 
图 2.36 所 示 的 界面 。 

图 2.36 显示 了 使 用 iterator 标签 遍历 集合 元 素 的 效果 ， 从 iteratorTagjsp 页 面 的 代码 来 看 ， 使 用 
iterator 标签 遍历 集合 元 素 比 使 用 JSP 脚本 遍历 集合 元 素 要 优雅 得 多 ， 这 就 是 自 定义 标签 的 魅力 。 


图 2.36 带 标签 体 的 标签 
实际 上 JSTL 标签 库 提供 了 一 套 功 能 非常 强大 的 标签 ， 例 如 普通 的 输出 标签 ， 像 我 们 刚刚 介绍 的 
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迁 代 器 标签 ， 还 有 用 于 分 支 判 断 的 标签 等 ，JSTL 都 有 非常 完善 的 实现 。 


A 可 能 有 读者 感到 疑 起 :; 这 个 JSP 页 面 自己 先 把 多 个 字符 囊 添加 到 ArrayList， 然 后 再 使 : 

用 这 个 iterator 标签 进行 选 代 输 出 ， 好 像 意义 不 是 很 大 啊 。 实际 上 这 个 标签 的 用 处 非常 大 ， | 

| ”在 严格 的 MVC 规范 下 ，JSP 页 面 只 负责 显示 数据 一 一 而 数据 通常 由 控制 器 ( Servlet ) 放 入 
request 范围 内 ， 而 JSP 页 面 就 通过 iterator 标签 迁 代 输出 request 范围 内 的 数据 。 


>>2.11.6 以 页 面 片段 作为 属性 的 标签 


JSP2 规范 的 自 定义 标签 还 允许 直接 将 一 段 “ 页 面 片段 ”作为 属性 ， 这 种 方式 给 自 定义 标签 提供 了 
更 大 的 灵活 性 。 

以 “页 面 片段 ”为 属性 的 标签 与 普通 标签 区 别 并 不 大 ， 只 有 两 个 简单 的 改变 

> ”标签 处 理 类 中 定义 类 型 为 JspFragment 的 属性 ， 该 属性 代表 了 “页 面 片段 ”。 

> ”使 用 标签 库 时 ， 通 过 <jsp:attribute..…/> 动 作 指 令 为 标签 库 属性 指定 值 。 

下 面 的 程序 定义 了 一 个 标签 处 理 类 ， 该 标签 处 理 类 中 定义 了 一 个 JspFragment 类 型 的 属性 ， 即 表 
明 该 标签 允许 使 用 “页 面 片段 ”类 型 的 属性 。 

程序 清单 : codes\02W2.11\tagDemo\WWEB-INF\src\lee\FragmentTag.java 


public class FragmentTag extends SimpleTagSupport 
{ 
private JspFragment fragment; 
//fragment 属性 的 setter 和 getter 方法 
public void setFragment (JspFragment fragment) 
{ 
this.fragment = fragment; 
} 
public JspFragment getFragment () 
{ 
return this.fragment; 


} 

QOverride 

public void doTag() throws JspException, IOException 

{ 
JspWriter out = getJspContext () .getOut ()7 
out .println("<div style='padding:10px;border:1px solid black'>")7 
out .println("<h3> 下 面 是 动态 传 入 的 JSP 片段 </h3>"); 
7/ 调用 、 输 出 “页 面 片段 ” 
fragment. invoke( null ); 
out.println("</div"); 

上 

} 


上 面 的 程序 中 定义 了 fragment 属性 ， 该 属性 代表 了 使 用 该 标签 时 的 “页 面 片段 "， 配 置 该 标签 与 
配置 普通 标签 并 无 任何 区 别 ， 增 加 如 下 配置 片段 即 可 。 
程序 清单 : codes\02W2.11\tagDemo\WWEB-INF\srcmytaglib.tld 
和 
<name>fragment</name> 
理 类 --> 


lass>lee. FragmentTag</tag-class> 
指定 该 标签 不 支持 标签 体 -> 
tent> 


<body-content>empty</body-con 

<!-- 定义 标签 属性 :fragment 一 > 

<attribute> 
<name>fragment</name> 
<required>true</required> 
<fragment>true</fragment> 
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</attribute> 
</tag> 


从 上 面 标签 库 的 配置 片段 来 看 ， 这 个 自 定义 标签 并 没有 任何 特别 之 处 ， 就 是 一 个 普通 的 带 属性 标 
由 于 该 标签 需要 一 个 fragment 属性 ， 该 属性 的 类 型 为 JspFragment， 因 此 使 用 该 标签 时 需要 使 用 
<jsp:attribute..… 户 动作 指令 来 设置 属性 值 ， 如 以 下 代码 片段 所 示 。 
程序 清单 : codes\02W2.11\tagDemo\fragmentTag.jsp 
<h2> 下 面 显示 的 是 自 定义 标签 中 的 内 容 </h2> 
<mytag: fragment> 
<!-- 使 用 jsp:attribute 标签 传 入 fragment 参数 --> 
<jsp:attribute name="fragment"> 
<!-~ 下 面 是 动态 的 JsP 页 面 片段 --> 
<mytag:helloWorld/> 
</jsp:attribute> 
</mytag: fragment> 
<br/> 
<mytag:fragment> 
<jsp:attribute name="fragment"> 


</jsp:attribute> 
</mytag: fragment> 
上 面 的 代码 片段 中 粗 体 字 代码 用 于 为 标签 的 fragment 属性 赋值 ， 第 一 个 例子 使 用 了 另 一 个 简单 标 
签 来 生成 页 面 片 段 ; 第 二 个 例子 使 用 了 JSP2 的 EL 来 生成 页 面 片 段 ; 在 浏览 器 中 浏览 该 页 面 , 将 看 到 
如 图 2.37 所 示 效 果 。 


Efren 


下 面 显示 的 是 自 定义 标签 中 的 内 容 


下 面 是 动态 传 入 的 JSP 片 自 
Rello Norld Sun Nov 0T 14:57:31 CST 2010 


下 面 基 动态 传 入 的 JSP 片 段 


图 2.37 页 面 片段 为 属性 的 标签 
》>》》2.11.7 动态 属性 的 标签 


前 面 介绍 带 属性 标签 时 ， 那 些 标签 的 属性 个 数 是 确定 的 ， 属 性 名 也 是 确定 的 ， 绝 大 部 分 情况 下 这 
种 带 属性 的 标签 能 处 理 得 很 好 ， 但 在 某 些 特殊 情况 下 ， 我 们 需要 传 入 自 定义 标签 的 属性 个 数 是 不 确定 
的 ， 属 性 名 也 不 确定 ， 这 就 需要 借助 于 动态 属性 的 标签 了 。 

动态 属性 标签 比 普通 标签 多 了 如 下 两 个 额外 要 求 : 

> ”标签 处 理 类 还 需要 实现 DynamicAttributes 接口 。 

> ”配置 标签 时 通过 <dynamic-attributes.../> 子 元 素 指定 该 标签 支持 动态 属性 。 

下 面 是 一 个 动态 属性 标签 的 处 理 类 。 

程序 清单 :codes\022.11\agDemo\WWEB-INF\src\lee\DynaAttributesTag.java 

Public class DynaAttributesTag 
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extends SimpleTagSupport implements Dynamichttributes 


// 保 存 每 个 属性 名 的 集合 

private ArrayList<string> keys = new ArrayList<string>(); 
// 保 存 每 个 属性 值 的 集合 

Private ArrayList<Object> values = new ArrayList<Object>(); 
QOverride 


public void doyag() throws JspException, IOException 
{ 
JspWriter out = getJspContext ().getOut (); 
// 此 处 只 是 简单 地 输出 每 个 属性 
out .println("<ol>"); 
for( int 1 = 0; i < keys.size(); i++ ) 
{ 
String key = keys.get( i ); 
Object value = values.get( i ); 
out.println( "<li>" + key + " = " + value + "</1i>" )7 
} 
out.printin("</o1>"); 


} 
@Override 


Public void setDynamicAttribute( String uri, String localName, 
Object value ) 
throws JspException 


// 添 加 属性 名 
keys.add( localName ); 
// 添 加 属性 值 


values.add( value ); 
} 
} 


上 面 的 标签 处 理 类 实现 了 DynaAttributesTag 接口 ， 就 是 动态 属性 标签 处 理 类 必须 实现 的 接口 ， 实 
现 该 接口 必须 实现 setDynaAttributes 方法 ， 该 方法 用 于 为 该 标签 处 理 类 动态 地 添加 属性 名 和 属性 值 。 
标签 处 理 类 使 用 ArrayList<String> 类 型 的 keys 属性 来 保存 标签 的 所 有 属性 名 ， 使 用 ArrayList<Object> 
类 型 的 values 属性 来 保存 标签 的 所 有 属性 值 。 
配置 该 标签 时 需要 额外 地 指定 <dynamic-attributes.… 人 > 子 元 素 ， 表 明 该 标签 是 带动 态 属性 的 标签， 
下 面 是 该 标签 的 配置 片段 。 
程序 清单 :，codes\022.11\tagDemo\WEB-INF\src\mytaglib.tld 
<!-- 定义 接受 动态 属性 的 标签 --> 
<tag> 
<name>dynaAttr</name> 
<tag-class>lee.DynaAttributesTag</tag-class> 
<body-content>empty</body-content> 
<!-- 指定 支持 动态 属性 --> 
<dynamic-attributes>true</dynamic-attributes> 
</tag> 
上 面 的 配置 片段 指定 该 标签 支持 动态 属性 。 
一 旦 定义 了 动态 属性 的 标签 ， 接 下 来 在 页 面 中 使 用 该 标签 时 将 十 分 灵活 ， 我 们 可 以 为 该 标签 设置 
任意 的 属性 ， 如 以 下 页 面 片段 所 示 。 
程序 清单 : codes\022.11\tagDemo\dynaAttrTag.jsp 
<!-- 导入 标签 库 ， 指 定 mytag 前 组 的 标签 ， 


由 http://www.crazyit.org/mytaglib 的 标签 库 处 理 --> 
<%@ taglib uri="http://www.crazyit.org/mytaglib" prefix="mytag"®> 


<h2> 下 面 显 示 的 是 自 定义 标签 中 的 内 容 </h2> 
<h4> 指 定 两 个 属性 </h4> 
<mytag:dynaAttr name="crazyit" url="crazyit.org"/><br/> 
<h4> 指 定 四 个 属性 </h4> 
<mytag:dynaAttr 书 名 =" 妆 狂 Java 讲义 ”价格 ="99.0" 
出 版 时 间 ="2008 年 ”描述 ="Java 图 书 "/><br/> 
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上 面 的 页 面 片 段 中 使 用 <mytag:dynaAttr.…/> 时 十 分 灵活 : 可 以 根据 需要 动态 地 传 入 任意 多 个 属性 ， 
如 以 上 粗 体 字 代码 所 示 。 不 管 传 入 多 少 个 属性 ， 这 个 标签 都 可 以 处 理 得 很 好 ， 使 用 浏览 器 访问 该 页 面 
将 看 到 如 图 2.38 所 示 效 果 。 


下 面 显示 的 是 自 定义 标签 中 的 内 容 


的 定 两 个 属性 


1 neme = crazyit 
2 wl = craryit.ors 


图 2.38 动态 属性 的 标签 


2.12 Filter 介绍 


Filter 可 认为 是 Servlet 的 一 种 “加 强 版 ”， 它 主要 用 于 对 用 户 请 求 进行 预 处 理 ， 也 可 以 对 
HttpServletResponse 进行 后 处 理 , 是 个 典型 的 处 理 链 。Filter 也 可 对 用 户 请 求生 成 响应 , 这 一 点 与 Servlet 
相同 ， 但 实际 上 很 少 会 使 用 Filter 向 用 户 请 求生 成 响应 。 使 用 Filter 完整 的 流程 是 ;Filter 对 用 户 请 求 
进行 预 处 理 ， 接 着 将 请 求 交 给 Servlet 进行 处 理 并 生成 响应 ， 最 后 Filter 再 对 服务 器 响应 进行 后 处 理 。 

Filter 有 如 下 儿 个 用 处 。 

> ”在 HttpServletRequest 到 达 Servlet 之 前 ， 拦 截 客户 的 HttpServletRequest。 

> ”根据 需要 检查 HttpServletRequest， 也 可 以 修改 HttpServletRequest 头 和 数据 。 

> 在 HttpServletResponse 到 达 客 户 端 之 前 ， 拦 截 HtpServletResponse。 

> ”根据 需要 检查 HttpServletResponse， 也 可 以 修改 HttpServletResponse 头 和 数据 。 

Filter 有 如 下 几 个 种 类 。 

> ”用 户 授权 的 Fiter， Fitter 负责 检查 用 户 请 求 ， 根 据 请 求 过 滤 用 户 非法 请 求 。 

> 日志 Filter: 详细 记录 某 些 特殊 的 用 户 请 求 。 

> ”负责 解码 的 Filter: 包括 对 非 标准 编码 的 请 求解 码 。 

> ”能 改变 XML 内 容 的 XSLT Fitter 等 。 

> Filter 可 负责 拦截 多 个 请 求 或 响应 ， 一 个 请 求 或 响应 也 可 被 多 个 Filter 拦截 。 

创建 一 个 Filter 只 需 两 个 步骤 : 

人 CC 创建 Filter 处 理 类 。 

@ web.xml 文件 中 配置 Filter。 


>2.12.1 创建 Filter 类 


创建 Filter 必须 实现 javax.servlet Filter 接口 ， 在 该 接口 中 定义 了 如 下 三 个 方法 。 

> void init (FilterConfig config) : 用 于 完成 Filter 的 初始 化 。 

> void destroy(): 用 于 Filter 销毁 前 ， 完 成 某 些 资源 的 回收 。 

> void doFilter (ServletRequest request，ServletResponse response,FilterChain chain) : 
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实现 过 滤 功 能 ， 该 方法 就 是 对 每 个 请 求 及 响应 增加 的 额外 处 理 。 
下 面 介绍 一 个 日 志 Filter， 这 个 Filter 负责 拦截 所 有 的 用 户 请 求 ， 并 将 请 求 的 信息 记录 在 日 志 中 。 
程序 清单 : codes\02W2.12\filterTest\WEB-INF\src\lee\LogFilterjava 


WebFilter (filterName="log" 
,urlPatterns={"/*"}) 

public class LogFilter implements Filter 

{ 
//Filterconfig 可 用 于 访问 Filter 的 配置 信息 
private FilterConfig config; 
// 实 现 初始 化 方法 
public void init(FilterConfig config) 
{ 

this.config = config; 


) 
7/ 实现 销 毁 方法 
public void destroy() 
{ 
this:config = null; 


} 

// 执 行 过 滤 的 核心 方法 

public void doFilter (ServletRequest request, 
ServletResponse response, Filterchain chain) 
throws IOException, ServletException 


//--------- 下 面 代码 用 于 对 用 户 请 求 执行 预 处 理 -------- 

// 获 取 ServletContext 对 象 ， 用 于 记录 日 志 

ServletContext context = this.config.getServletContext(); 

long before = System.currentTimeMillis(); 

System.out .println ("开始 过 滤 ...") ; 

// 将 请 求 转换 成 HttpServletRequest 请 求 

HttpServletRequest hrequest = (HttpServletRequest)request; 

// 输 出 提示 信息 

System.out .println ("Filter 已 经 截获 到 用 户 的 请 求 的 地 址 ， ”+ 
hrequest .getServletPath()); 

//Filter 只 是 链 式 处 理 ， 请 求 依然 放行 到 目的 地 址 

chain.doFilter (request, response); 

-下 面 代码 用 于 对 服务 器 响应 执行 后 处 理 -~ 一 -~ 一 

System.CurrentTimeMillis()7 


// 输 出 提示 信息 

System.out .println ("过滤 结束 "); 

// 输 出 提示 信息 

System.out ,println ("请 求 被 定位 到 " + hrequest .getRequestURI() + 
”所 花 的 时 间 为 : ”+ (after - before)); 


} 
} 


上 面 的 程序 中 粗 体 字 代码 实现 了 doFilter0 方 法 ， 实 现 该 方法 就 可 实现 对 用 户 请 求 进行 预 处 理 ， 也 
可 实现 对 服务 器 响应 进行 后 处 理 一 一 它们 的 分 界线 为 是 否 调用 了 chain.doFilter(), 执行 该 方法 之 前 ， 即 
对 用 户 请 求 进行 预 处 理 ， 执 行 该 方法 之 后 ， 即 对 服务 器 响应 进行 后 处 理 。 

在 上 面 的 请 求 Fitter 中 ， 仅 在 日 志 中 记录 请 求 的 URL， 对 所 有 的 请 求 都 执行 chain.doFilter 
(request,reponse) 方 法 ， 当 Filter 对 请 求 过 滤 后 ， 依 然 将 请 求 发 送 到 目的 地 址 。 如 果 需 要 检查 权限 ， 可 
以 在 Filter 中 根据 用 户 请 求 的 HttpSession， 判 断 用 户 权限 是 否 足够 。 如 果 权 限 不 够 ， 直 接 调 用 重 定向 
即 可 ， 无 须 调用 chain.doFilter(request,reponse) 方 法 。 


》>2.12.2 配置 Filter 


前 面 已 经 提 到 ，Filter 可 以 认为 是 Servlet 的 “增强 版 ” 因此 配置 Filter 与 配置 Servlet 非常 相似 ， 
都 需要 配置 如 下 两 个 部 分 : 
> 配置 Filter 名。 
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> 配置 Filter 拦截 URL 模式 。 

区 别 在 于 ，Servlet 通常 只 配置 一 个 URL， 而 Filter 可 以 同时 拦截 多 个 请 求 的 URL。 因 此 ， 在 配置 
Filter 的 URL 模式 时 通常 会 使 用 模式 字符 串 , 使 得 Filter 可 以 拦截 多 个 请 求 。 与 配置 Servlet 相似 的 是 ， 
配置 Filter 同样 有 两 种 方式 : 

> 在 Filter 类 中 通过 Annotation 进行 配置 。 

> ”在 web.xml 文件 中 通过 配置 文件 进行 配置 。 

上 面 Filter 类 的 粗 体 字 代码 使 用 @WebFilter 配置 该 Filter 的 名 字 为 og， 它 会 拦截 向 /* 发 送 的 所 有 
的 请 求 。 
@WebFilter 修饰 一 个 Filter 类 ， 用 于 对 Filter 进行 配置 ， 它 支持 如 表 2.3 所 示 的 常用 属性 。 


表 2.3 @WebFilter 支持 的 常用 属性 
属 性 是 否 必需 说 明 ] 
Filer 是 否 支持 异步 操作 模式 。 关 于 Fiher 的 异步 调用 请 参考 2.15 节 | 
iker 仪 对 那 种 dispatcher 模式 的 请 求 进行 过 滤 。 该 属性 支持 ASYNC、ERROR、FORWARD、 


asyncSupported 理 指 ; 


dispatcherlypes | 否 


LUDE、REQUEST 这 5 个 值 的 任意 默认 值 为 同时 过 泪 5 种 模式 的 请 求 
displayName 再 指定 该 Fiher 的 显示 名 
filterName 指定 该 Fiher 的 名 称 
initharams 否 用 于 为 该 Filer 配置 参数 
servletNames 理 该 属性 值 可 指定 多 个 Serviet 的 名 称 ， 用 于 指定 该 Filter 仅 对 这 几 个 Servlet 执行 过 小 
urlPatterns/value 否 这 两 个 属性 的 作用 完全 相同 。 都 指定 该 Fiher 所 拦截 的 URL 


在 web.xml 文件 中 配置 Filter 与 配置 Servlet 非常 相似 ， 需 要 为 Filter 指定 它 所 过 滤 的 URL， 并 且 
也 可 以 为 Filter 配置 参数 。 
在 web.xml 文件 中 为 该 Filter 增加 如 下 配置 片段 : 


<!1-- 定义 Filter --> 
<filter> 
<!-- Filter 的 名 字 ， 相 当 于 指定 @WebFilter 
的 filterName 属性 --> 
<filter-name>log</filter-name> 
<!-- Filter 的 实现 类 --> 
<filter-class>lee. LogFilter</filter-class> 
</filter> 
<!-- 定义 Filter 拦截 的 URL 地 址 --> 
<filter-mapping> 
<!-- Filter 的 名 字 --> 
<filter-name>log</filter-name> 
<!-- Filter 负责 拦截 的 URL， 相 当 于 指定 8WebFilter 
的 urlPatterns 属性 --> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


上 面 的 粗 体 字 代码 用 于 配置 该 Filter， 从 这 些 代码 中 可 以 看 出 配置 Filter 与 配置 Servlet 非常 相似 ， 
只 是 配置 Filter 时 指定 url-pattern 为 /*,， 即 表示 该 Filter 会 拦截 所 有 用 户 请 求 。 该 Filter 并 未 对 客户 端 请 
求 进行 额外 的 处 理 ， 仅 仅 在 日 志 中 简要 记录 请 求 的 信息 。 

为 该 Web 应 用 提供 任意 一 个 JSP 页 面 ， 并 通过 浏览 器 来 访问 该 JSP 页 面 ， 即 可 在 Tomeat 的 控制 
台 看 到 如 图 2.39 所 示 的 信息 。 


re 和 用 户 的 请 的 地 址 /filter. jsp 
清 求 被 定位 到 /filterTest/filter. jsp 。 所 花 的 时 间 为 : 15 


2.39 Filter 过 滤 客 户 端 请 求 
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实际 上 Filter 和 Servlet 极其 相似 , 区 别 只 是 Filter 的 doFilter0 方 法 里 多 了 一 个 FilterChain 的 参数 ， 
通过 该 参数 可 以 控制 是 否 放行 用 户 请 求 。 在 实际 项 目 中 ，Filter 里 doFilter0 方 法 里 的 代码 就 是 从 多 个 
Servlet 的 service() 方 法 里 抽取 的 通用 代码 ， 通 过 使 用 Filter 可 以 实现 更 好 的 代码 复 用 。 

假设 系统 有 包含 多 个 Servlet， 这 些 Servlet 都 需要 进行 一 些 的 通用 处 理 : 比如 权限 控制 、 记 录 日 志 
等 ， 这 将 导致 在 这 些 Servlet 的 service 方法 中 有 部 分 代码 是 相同 的 一 一 为 了 解决 这 种 代码 重复 的 问题 ， 
我 们 可 以 考虑 把 这 些 通用 处 理 提取 到 Filter 中 完成 ， 这 样 各 Servlet 中 剩 下 的 只 是 特定 请 求 相 关 的 处 理 
代码 ， 而 通用 处 理 则 交 给 Filter 完成 。 图 2.40 显示 了 Filter 的 用 途 。 


rm NN 
图 2.40 Filter 的 作用 


由 于 Filter 和 Servlet 如 此 相似 ， 所 以 Filter 和 Servlet 具有 完全 相同 的 生命 周期 行为 ， 且 Filter 也 
可 以 通过 <init-param... 人 > 元 素 或 @WebFilter 的 initParams 属性 来 配置 初始 化 参数 ， 获 取 Filter 的 初始 化 
参数 则 使 用 FilterConfig 的 getInitParameter() 方 法 。 
下 面 将 定义 一 个 较为 实用 的 Filter， 该 Filter 对 用 户 请 求 进行 过 滤 ，Filter 将 通过 doFilter 方法 来 设 
置 request 编码 的 字符 集 ， 从 而 避免 每 个 JSP、Servlet 都 需要 设置 ， 而 且 还 会 验证 用 户 是 否 登录 ， 如 果 
用 户 没有 登录 ， 系 统 直接 跳 转 到 登录 页 面 。 
下 面 是 该 Filter 的 源 代码 。 
程序 清单 : codes\02\2.12\ filterTest\WEB-INF\src\lee\AuthorityFilterjava 
@WebFilter (filterName="authority" 
, urlPatterns={"/*"} 
， initParams={ 
@WebInitParam(name="encoding", value="GBK"), 
@WebInitParam (name="loginPage", value="/login.jsp"), 
@WebInitParam (name="proLogin", value="/proLogin.jsp")}) 
public class AuthorityFilter implements Filter 


{ 
//FilterConfig 可 用 于 访问 Filter 的 配置 信息 
private FilterConfig config; 


// 实 现 初始 化 方法 
Public woid init (Filterconfig config) 


{ 
this.config = config; 


} 
/7 实现 销毁 方法 
public void destroy() 
{ 
this.config = null; 


上 
// 执 行 过 滤 的 核心 方法 
public void doFilter (ServletRequest request, 
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} 
. 


上 面 Filter 的 doFilter 方法 里 开始 三 行 粗 体 字 代 码 用 于 获取 Filter 的 配置 参数 ， 而 程序 中 的 粗 体 字 
代码 则 是 此 Filter 的 核心 ， 号 代码 按 配置 参数 设置 了 request 编码 所 用 的 字符 集 ， 接 下 来 的 粗 体 字 代 
码 判 断 session 范围 内 是 否 有 user 属性 一 一 没有 该 属性 即 认为 没有 登录 , 如 果 既 没有 登录 , 而 且 请 求 地 


ServletResponse response, FilterChain chain) 
throws IOException, ServletException 


// 获 取 该 Filter 的 配置 参数 
String encoding = config.getInitParameter ("encoding"); 
String loginPage = config.getInitParameter{("loginPage"); 
‘string proLogin = config.getInitParameter ("proLogin"); 
// 设 置 request 编码 用 的 字符 集 
request. setCharacterEncoding (encoding) ; 1/@ 
HttpServletRequest requ = (HttpServletRequest)request; 
HttpSession session = requ.getSession(true); 
// 获 取 客 户 请 求 的 页 面 
String requestPath = requ.getServletpath(j; 
// 如 果 session 范围 的 user 为 null， 即 表明 没有 登录 
// 且 用 户 请 求 的 既 不 是 登录 页 面 ， 也 不 是 处 理 登录 的 页 面 
if( session.getAttribute("user") == null 

65 !requestPath.endsWith (loginPage) 

55 IrequestPath.endsWith (proLogin)) 


//forward 到 登录 页 面 

request .setAttribute ("tip"” ，" 仿 还 没有 登录 ") ; 

request .getRequestDispatcher (loginPage) 
forward(request, response); 


} 

71" 放行" 请求 
else 

{ 


chain.doFilter (request, response); 
} 


址 也 不 是 登录 页 和 处 理 登录 页 ， 系 统 直 接 跳 转 到 登录 页 面 。 


通过 @WebFilter 的 initParams 属性 可 以 为 该 Filter 配置 初始 化 参数 ， 它 可 以 接受 多 个 


@WeblnitParam， 每 个 @WeblnitParam 指定 一 个 初始 化 参数 。 


在 web.xml 文件 中 也 使 用 <init-param..…/> 元 素 为 该 Filter 配置 参数 , 与 配置 Servlet 初始 化 参数 完全 


相同 。 


如 果 需 要 在 web.xml 文件 中 配置 该 Filter， 该 Filter 的 配置 片段 如 下 : 
<!-- 定义 Filter --> 


<filter> 


<!-- Filter 的 名 字 --> 
<filter-name>authority</filter-name> 

<!-- Filter 的 实现 类 --> 
<filter-class>lee.AuthorityFilter</filter-class> 
<!-- 下 面 三 个 init-param 元 素 配置 了 三 个 参数 -> 


<init-param> 
<param- name> 
<param-value>GBK</param-value> 
</init-param> 
<init-param> 
<param-name>loginPage</param-name> 
<param-value>/login. jsp</param-value> 
</init-param> 
<init-param> 
<param-name>proLogin</param-name> 
<param-value>/proLogin. jsp</param-value> 
</init-param> 
</filter> 


<!-- 定义 Filter 拦 蕉 的 URL 地 址 --> 
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<filter-mapping> 
<!-- Filter 的 名 字 --> 
<filter-name>authority</filter-name> 
<!-- Filter 负责 拦截 的 URL --> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


上 面 的 配置 片段 中 粗 体 字 代码 为 该 Filter 指定 了 三 个 配置 参数 ， 指 定 loginPage 为 /loginjsp， 
proLogin 为 /proLogin.jsp， 这 表明 ， 如 果 没 有 登录 该 应 用 ， 普 通用 户 只 能 访问 /login.jsp 和 /proLogin.jsp 
页 面 。 只 有 当 用 户 登录 该 应 用 后 才 可 自由 访问 其 他 页 面 。 


>>2.12.3 使 用 URL Rewrite 实现 网 站 伪 静 坊 
对 于 以 JSP 为 表现 层 开发 的 动态 网 站 来 说 ， 用 户 访问 的 URL 通常 有 如 下 形式 : 


xxx.jsp?param=value. .. 

大 部 分 搜索 引擎 都 会 优先 考虑 收录 静态 的 HTML 页 面 ， 而 不 是 这 种 动态 的 *jsp、*.php 页 面 。 但 
实际 上 绝 大 部 分 网 站 都 是 动态 的 ， 不 可 能 全 部 是 静态 的 HTML 页 面 ， 因 此 互联 网 上 的 大 部 分 网 站 都 会 
考虑 使 用 伪 静 态 一 就 是 将 *jsp、*.php 这 种 动态 URL 伪装 成 静态 的 HTML 页 面 

对 于 Java Web 应 用 来 说 ， 要 实现 伪 静态 非常 简单 ， 可 以 通过 Filter 拦截 所 有 发 向 *.html 请 求 ， 然 
后 按 某 种 规则 将 请 求 forward 到 实际 的 *jsp 页 面 即 可 。 现 有 的 URL Rewrite 开源 项 目 为 这 种 思路 提供 
了 实现 ， 使 用 URL Rewrite 实现 网 站 伪 静 态 也 很 简单 。 

下 面 详细 介绍 如 何 利用 URL Rewrite 实现 网 站 伪 静 态 : 

人 登录 httpy//wwwtuckey.org/urlrewrite/ 站 点 下 载 Url Rewrite 的 最 新 版 本 ， 笔 者 成 书 时 该 项 目的 
最 新 版 本 是 3.2， 建 议 读者 也 下 载 该 版 本 的 Url Rewrite。 

a 不 知 为 何 该 站 点 又 被 电信 网 络 “ 封 ” 了， 笔者 通过 代理 服务 器 才 可 访问 ， 
该 站 点 ， 如 果 读 者 的 网 络 无 法 登录 该 站 点 ， 请 使 用 代理 服务 器 登录 . 


G 下 载 URL Rewrite 应 下 载 其 sre 项 (urlrewritefilter-3.2.0-sre.zip)， 下 载 完成 后 得 到 一 个 
urlrewritefilter-3.2.0-src.zip 文件 ， 将 该 压缩 文件 解压 缩 ， 得 到 如 下 文件 结构 。 
> ”api: 该 路 径 下 存放 了 URL Rewrite 项 目的 API 文档 。 
> lib: 该 路 径 下 存放 了 URL Rewrite 项 目的 编译 和 运行 所 需 的 第 三 方 类 库 。 
> manual: 该 路 径 下 存放 了 URL Rewrite 项 目 使 用 手册 。 
> src; 该 路 径 下 存放 了 URL Rewrite 项 目的 源 代码 。 
> ”webapp: 该 路 径 是 一 个 URL Rewrite 的 示例 应 用 。 
LICENSE.txt 等 杂项 文档 。 
个 在 web.xml 文件 中 配置 启用 URL Rewrite Filter， 在 web.xml 文件 中 增加 如 下 配置 片段 。 
程序 清单 ，codes\02\2.12wurlrewriteAWEB-INF\web xml 


<1-- 配置 Url Rewrite 的 Filter --> 
<filter> 

<filter-name>UrlRewriteFilter</filter-name> 

<filter-class>org.tuckey.web. filters.urlrewrite.UrlRewriteFilter</filter-class> 
</filter> 
<!-- 配置 Url Rewrite 的 Filter 拦截 所 有 请 求 --> 
<filter-mapping> 

<filter-name>UrlRewriteFilter</filter-name> 

<url-pattern>/*</url-pattern> 
</filter-mapping> 


上 面 的 配置 片段 指定 使 用 URL Rewrite Filter 拦截 所 有 的 用 户 请 求 。 
人 @ 在 应 用 的 WEB-INF 路 径 下 增加 urlrewrite.xml 文件 ， 该 文件 定义 了 伪 静 态 映射 规则 ， 这 份 伪 
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静态 规则 是 基于 正则 表达 式 的 。 
下 面 是 本 应 用 所 使 用 的 urirewrite.xml 伪 静 态 规则 文件 。 
程序 清单 : codes\022.12\urlrewrite\WWEB-INF\urlrewrite.xml 
<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE urlrewrite PUBLIC "~-//tuckey.org//DTD UrlRewrite 3.2//EN™” 
"http://tuckey.org/res/dtds/urlrewrite3.2.dtd"> 
<urlrewrite> 
<rule> 
<!-- 所 有 配置 如 下 正则 表达 式 的 请 求 一 > 
<from>/userinf- (\w*) .html</from> 
<!-- 将 被 forward 到 如 下 JSP 页 面 ， 其 中 $1 代表 
上 面 第 一 个 正则 表达 式 所 匹配 的 字符 串 一-> 
<to type="forward">/userinf.jsp?username=$1</to> 
</rule> 
</urlrewrite> 
上 面 的 规则 文件 中 只 定义 了 一 个 简单 的 规则 :所 有 发 向 /userinf-(\w*)html 的 请 求 都 将 被 forward 到 
userjsp 页 面 ， 并 将 (w*) 正 则 表达 式 所 匹配 的 内 容 作为 usemame 参数 值 。 根 据 这 个 伪 静 态 规则 ， 我 们 应 该 
为 该 应 用 提供 一 个 userinfjsp 页 面 ， 该 页 面 只 是 一 个 模拟 了 一 个 显示 用 户 信息 的 页 面 ， 该 页 面 代码 如 下 。 
程序 清单 ;codes\02\2.12Vurlrewritevuserinfjsp 
<$@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 
< 
// 获 取 请 求 参数 
String user = request.getParameter ("username"); 
%> 
<!DOCTYPE html PUBLIC "~//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head> 
<title> <%=user$> 的 个 人 信息 </title> 
</head> 


// 此 处 应 该 通过 数据 库 读 取 该 用 户 对 应 的 信息 

// 此 处 只 是 模拟 ， 因 此 简单 输出 : 

out.println(" 现 在 时 间 是 : ”+ new java.util.Date() + "<br/>"); 
out .println ("用 户 名 : " + user); 

> 

</body> 

</html> 


上 面 的 页 面 中 粗 体 字 代码 usemame 请 求 参数 来 输出 用 户 信息 ， 但 因为 系统 使 用 了 URL Rewrite， 
因此 用 户 可 以 请 求 类 似 于 userinf-xxx.html 页 面 ， 图 2.41 显示 了 “ 伪 静 态 ” 示 意 。 


可 在 时 间 是 ，Sat ov 06 21:30:22 CST 2010 
用 户 和 名 ,crazyit 


图 2.41 伪 静 坊 示意 
2.13 Listener 介绍 


当 Web 应 用 在 Web 容器 中 运行 时 ，Web 应 用 内 部 会 不 断 地 发 生 各 种 事件 ， 如 Web 应 用 被 启动 、 
Web 应 用 被 停止 用户 session 开始 、 用 户 session 结束 、 用 户 请 求 到 达 等 ， 通 常 来 说 ， 这 些 Web 事件 
对 开发 者 是 透明 的 。 
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实际 上 , Servlet API 提供 了 大 量 监听 器 来 监听 Web 应 用 的 内 部 事件 , 从 而 允许 当 Web 内 部 事件 发 
生 时 回调 事件 监听 器 内 的 方法 。 

使 用 Listener 只 需要 两 个 步骤 : 

人 定义 Listener 实现 类 。 

@ 通过 Annotation 或 在 web.xml 文件 中 配置 Listemer。 


>>2.13.1 实现 Listener 类 


与 AWT 事件 编程 完全 相似 ,监听 不 同 Web 事件 的 监听 器 也 不 相同 。 常 用 的 Web 事件 监听 器 接口 
有 如 下 几 个 。 
> ”ServletContextListener: 用 于 监听 Web 应 用 的 启动 和 关闭 。 
> ”ServletContextAttributeListener: 用 于 监听 ServletContext 范围 (application ) 内 属性 的 
改变 。 
ServletRequestListener: 用 于 监听 用 户 请 求 。 
ServletRequestAttributeListener: 用 于 监听 ServletRequest 范围 (request) 内 属性 的 改变 。 
HttpSessionListener: 用 于 监听 用 户 session 的 开始 和 结束 。 
> ”HttpSessionAttributeListener: 用 于 监听 HttpSession 范围 (session〉 内 属性 的 改变 。 
下 面 先 以 ServletContextListener 为 例 来 介绍 Listener 的 开发 和 使 用 ，ServletContextListener 用 于 监 
听 Web 应 用 的 启动 和 关闭 。 该 Listener 类 必须 实现 ServletContextListener 接口 ， 该 接口 包含 如 下 两 个 
方法 。 
> ”contextlnitialized(ServletContextEvent sce): 启动 Web 应 用 时 ， 系 统 调用 Listener 的 该 
方法 。 
> contextDestroyed(ServletContextEvent sce): 关闭 Web 应 用 时 ， 系 统 调用 Listener 的 该 
方法 。 
通过 上 面 的 介绍 不 难看 出 ，ServletContextListener 的 作用 有 点 类 似 于 load-on-startup Servlet， 都 可 
用 于 在 Web 应 用 启动 时 ， 回 调 方法 来 启动 某 些 后 台 程序 ， 这 些 后 台 程 序 负责 为 系统 运行 提供 支持 。 
下 面 将 创建 一 个 获取 数据 库 连 接 的 Listener, 该 Listener 会 在 应 用 启动 时 获取 数据 库 连 接 ， 并 将 获 
取 到 的 连接 设置 成 application 范围 内 的 属性 。 下 面 是 该 Listener 的 代码 。 
程序 清单 : codes\02\2.13\listenerTest\WEB-INF\src\lee\GetConnListenerjava 


QWebListener 
public class GetConnListener implements ServletContextListener 
{ 


vvyvy 


// 应 用 启动 时 ， 该 方法 被 调用 
Ppublic void contextInitialized(ServletContextEvent sce) 
{ 


try 

{ 
// 尸 帮 芒 应 豚 的 Servletcontext 医生 
ServletContext application = sce.getservletContext (); 
// 扩 肥 第 参 烧 四 我 下 守 动 
String driver ~ application.getInitParameter ("driver"); 
/7 有 策 夫 押 岂 交 到 费 榴 庄 =r1 
String url = application. getInitParameter(mur1"); 
// 欠 忆 复 参 烧 中 我 避 甩 户 各 
String user = application. getInitParameter ("user"); 
// 人 肥 介 参 才思 我 避 第 好 
String pass = application.getInitParameter ("pass"); 
// 注 册 驱 动 
Class.forName(driver)7 
7/ 获取 数据 库 连 接 


Connection conn = DriverManager.getConnection {url 
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+ user , pass); 
// 将 数据 库 连接 设置 成 application 范围 内 的 属性 
application. setAttribute ("conn" , conn); 
} 
catch (Exception ex) 


System.out .println ("Listener 中 获取 数据 库 连接 出 现 异常 " 
+ ex.getMessage())7 
} 


} 
// 应 用 关闭 时 ， 该 方法 被 调用 
public void contextDestroyed (ServletContextEvent sce) 
// 取 得 该 应 用 的 Servletcontext 实例 
ServletContext application = sce.getServletContext()7 
Connection conn = (Connection)application.getAttribute ("conn"); 
// 关 闭 数据 库 连 接 
if (conn != null) 
{ 
try 
{ 
conn.close(); 
} 
catch (SQLException ex) 
{ 
ex.printstackTrace(); 
} 


) 
} 

上 面 的 程序 中 粗 体 字 代码 重 写 了 ServletContextListener 的 contextInitialized()、contextDestroyed() 
方法 ， 这 两 个 方法 分 别 在 应 用 启动 、 关 闭 时 被 触发 。 上 面 ServietContextListener 的 两 个 方法 分 别 实现 
获取 数据 库 连 接 、 关 闭 数据 库 连 接 的 功能 ， 这 些 功 能 都 是 为 整个 Web 应 用 提供 服务 的 。 

程序 中 斜体 字 代码 用 于 获取 配置 参数 ， 细 心 的 读者 可 能 已 经 发 现 ServletContextListener 获取 的 是 
Web 应 用 的 配置 参数 ， 而 不 是 像 Servlet 和 Filter 获取 本 身 的 配置 参数 。 这 是 因为 配置 Listener 时 十 分 
简单 ， 只 要 简单 地 指定 Listener 实现 类 即 可 ， 不 能 配置 初始 化 参数 。 


>>2.13.2 配置 Listener 


配置 Listener 只 要 向 Web 应 用 注册 Listener 实现 类 即 可 ， 无 须 配 置 参数 之 类 的 东西 ， 因 此 十 分 简 
单 。 为 Web 应 用 配置 Listener 也 有 两 种 方式 : 

> ”使 用 @WebListener 修饰 Listener 实现 类 即 可 。 

> ”在 web.xml 文 档 中 使 用 <listener..…/> 元 素 进行 配置 。 

使 用 @WebListener 时 通常 无 须 指定 任何 属性 ， 只 要 使 用 该 Annotation 修饰 Listener 实现 类 即 可 向 
Web 应 用 注册 该 监听 器 。 

在 web.xml 中 使 用 <listener.. 人 > 元 素 进 行 配置 时 只 要 配置 如 下 子 元 素 即 可 。 

> “listener-class: 指定 Listener 实现 类 。 

车 将 ServletContextListener 配置 在 Web 容器 中 ， 且 Web 容器 (支持 Servlet 2.3 以 上 规范 ) 支持 
Listener， 则 该 ServletContextListener 将 可 以 监听 Web 应 用 的 启动 、 关 闭 。 

如 果 选 择 web.xml 文件 来 配置 Listener， 则 应 在 web.xml 文档 中 增加 如 下 配置 片段: 


<listener> 
<!-- 指定 Listener 的 实现 类 --> 
<listener-class>lee.GetConnListener</listener-class> 
</listener> 


上 面 的 配置 片段 向 Web 应 用 注册 了 一 个 Listener， 其 实现 类 为 lee.GetConnListener。 当 Web 应 用 
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/ 
被 启动 时 ， 该 Listener 的 contextInitialized 方法 被 触发 ， 该 方法 会 获取 一 个 JDBC Connection， 并 放 入 
application 范围 内 ， 这 样 我 们 的 所 有 JSP 页 面 都 可 通过 application 获取 数据 库 连 接 ， 从 而 可 以 非常 方 
便 地 进行 数据 库 访问 。 
-要 -注意 :x 
本 例 中 的 ServletContextListener 把 一 个 数据 库 连 接 ( Connection 实例 ) 设置 成 

application 属性 ， 这 样 将 导致 所 有 页 面 都 使 用 相同 的 Connection 实例 ， 实 际 上 这 种 做 法 
的 性 能 非常 差 。 较 为 实用 的 做 法 是 : 应 用 启动 时 将 一 个 数据 源 (javax.sql.DataSource 实 
例 ) 设 置 成 application 属性 , 而 所 有 JSP 页 面 都 通过 DataSource 实例 来 取得 数据 库 连 接 ， 
再 进行 数据 库 访问 ， 这 样 就 会 好 得 多 。 关 于 数据 库 连 接 池 的 介绍 请 参看 疯狂 Java 体系 的 守 


《疯狂 Java 讲义 》 的 13.8 节 


》>》》>2.13.3 使 用 ServletContextAttributeListener 


ServletContextAttributeListener 用 于 监听 ServletContext (application) 范围 内 属性 的 变化 ， 实 现 该 
接口 的 监听 器 需要 实现 如 下 三 个 方法 。 
> attributeAdded(ServletContextAttributeEvent event): 当 程 序 把 一 个 属性 存 入 application 范 


围 时 触发 该 方法 。 

> attributeRemoved(ServletContextAttributeEvent event): 当 程序 把 一 个 属性 从 application 范 
围 删除 时 触发 该 方法 。 

> attributeReplaced(ServletContextAttributeEvent event): 当 程 序 替 换 application 范围 内 的 属 
性 时 将 触发 该 方法 。 


下 面 是 一 个 监听 ServletContext 范围 内 属性 改变 的 Listener。 
程序 清单 :codes\02\2.13MistenerTest\WEB-INF\src\lee\MyServletContextAttributeListenerjava 
QWebListener 
public class MyServletContextAttributeListener 
implements ServletContextAttributeListener 
{ 
// 当 程序 向 application 范围 添加 属性 时 角 发 该 方法 
public void attributeAdded (ServletContextAttributeEvent event) 
{ 
ServletContext application ~ event.getServletContext (); 
// 获 取 添加 的 属性 名 和 属性 值 
String name = event.getName(); 
object value = event.getValue(); 
System.out.printin(application + "范围 内 添加 了 名 为 " 
+ name + "， 值 为 ”+ value + "的 属性 1"); 


上 
// 当 程序 从 application 范围 删除 属性 时 触发 该 方法 
Public void attributeRemoved(ServletContextAttributeEvent event) 
{ 

ServletContext application ~ event.getServletContext (); 

// 获 取 被 删除 的 属性 名 和 属性 值 

String name = event.getName(); 

Object value = event.getValue(); 

System.out .println(application + "范围 内 名 为 " 

+ name + "， 值 为 "+ value + "的 属性 被 避 除 了 !") > 


} 

// 当 application 范围 的 属性 被 替换 时 触发 该 方法 

public void attributeReplaced {ServietContextAttributeEvent event) 
‘ io 


ServletContext application = event.getServletContext()7 
// 获 取 被 替换 的 属性 名 和 属性 值 
String name = event.getName()» 
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Object value = event.getValue(); 
System.out .println (application + "范围 内 名 为 " 
+ name + "， 值 为 ”+ value + “的 属性 被 替换 了 !") 7 


¥% 
} 


上 面 的 ServletContextAttributeListener 使 用 了 @WebListener Annotation 修饰 ， 这 就 是 向 Web 应 用 
中 注册 了 该 Listener， 该 Listener 实现 了 attributeAdded、attributeRemoved、attributeReplaced 方法 ， 因 
此 当 application 范围 内 的 属性 被 添加 、 删 除 、 蔡 换 时 ， 这 些 对 应 的 监听 器 方法 将 会 被 触发 。 


2.13.4 使 用 ServletRequestListener 和 ServletRequestAttributeListener 


ServletRequestListener 用 于 监听 用 户 请 求 的 到 达 ， 实 现 该 接口 的 监听 器 需要 实现 如 下 两 个 方法 。 

> requestlnitialized(ServletRequestEvent sre): 用 户 请 求 到 底 、 被 初始 化 时 触发 该 方法 。 

> ”requestDestroyed(ServiletRequestEvent sre): 用 户 请 求 结束 、 被 销毁 时 触发 该 7 

ServletRequestAttributeListener 则 用 于 监听 ServletRequest (request) 范围 内 属性 的 变化 ， 实 现 该 接 
口 的 监听 器 需要 实现 attributeAdded 、attributeRemoved 、attributeReplaced 三 个 方法 。 由 此 可 见 ， 
ServletRequestAttributeListener 与 ServletContextAttributeListener 的 作用 相似 ， 都 用 于 监听 属性 的 改变 ， 
只 是 ServletRequestAttributeListener 监听 request 范围 内 属性 的 改变 ， 而 ServletContextAttributeListener 
监听 的 是 application 范围 内 属性 的 改变 。 

需要 指出 的 是 ， 应 用 程序 完全 可 以 采用 一 个 监听 器 类 来 监听 多 种 事件 ， 只 要 让 该 监听 器 实现 类 同 
时 实现 多 个 监听 器 接口 即 可 ， 如 以 下 代码 所 示 。 

程序 清单 : codes\02\2.13\listenerTest\WEB-INF\src\lee\RequestListener.java 


@WebListener 
public class RequestListener 
implements ServletRequestListener , ServletRequestAttributeListener 


// 当 用 户 请 求 到 达 、 被 初始 化 时 触发 该 方法 
public void requestInitialized(ServletRequestEvent sre) 


{ 


{ 


HttpServletRequest request = (HttpServletRequest)sre.getServletRequest (); 
System.out .println("---- 发 向 ”+ request.getRequestURI() 
+ "请 求 被 初始 化 一 -一 ") ; 


} 
// 当 用 户 请 求 结束 、 被 销毁 时 触发 该 方法 
public void requestDestroyed(ServletRequestEvent sre) 


{ 


HttpServletRequest request = (HttpServletRequest)sre.getservletRequest (); 
System.out .println("---- 发 向 " + request.getRequestURI() 
+ "请 求 被 销毁 -一 


} 

// 当 程序 向 request 范围 添加 属性 时 触发 该 方法 

public void attributehdded(SeryletRequestRttributeEvent event) 
{ 


ServletRequest request = event.getServletRequest(); 
// 获 取 添加 的 属性 名 和 属性 值 
String name = event.getName(); 
Object value = event.getValue(); 
System.out .println (request + "范围 内 深 加 了 名 为 " 
+ name + "， 值 为 ”+ value + "的 属性 1") 


} 
// 当 程序 从 request 范围 删除 属性 时 触发 该 方法 
public void attributeRemoved (ServletRequestAttributeEvent event) 
{ 
ServletRequest request = event.getServletRequest(); 
// 获 取 被 删除 的 属性 名 和 属性 值 
String name = event.getName(); 
Object value = event.getValue(); 
System.out.println (request + "范围 内 名 为 " 
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+ name + "， 值 为 ”+ value + "的 属性 被 萍 除了 !"); 


} 
// 当 request 范围 的 属性 被 替换 时 触发 该 方法 
public void attributeReplaced (ServletRequestAttributeEvent event) 


{ 
ServletRequest request = event.getServletRequest (); 
/ /获取 被 替换 的 属性 名 和 属性 值 
String name = event.getName(); 
Object value = event.getValue(); 
System.out.println (request + "范围 内 名 为 " 

+ name + "， 值 为 ”+ value + "的 属性 被 替换 了 !"); 
} 
} 


上 面 的 监听 器 实现 类 同时 实现 了 ServletRequestListener 接口 和 ServletRequestAttributerListener 接 
口 ， 因 此 它 既 可 以 监听 用 户 请 求 的 初始 化 和 销毁 ， 也 可 监听 request 范围 内 属性 的 变化 。 

由 于 实现 了 ServletRequestListener 接口 的 监听 器 可 以 非常 方便 地 监听 到 每 次 请 求 的 创建 、 销 毁 ， 
因此 Web 应 用 可 通过 实现 该 接口 的 监听 器 来 监听 访问 该 应 用 的 每 个 请 求 ， 从 而 实现 系统 日 志 。 


> 2.13.5 使 用 HttpSessionListener 和 HttpSessionAttributeListener 


HttpSessionListener 用 于 监听 用 户 session 的 创建 和 销毁 ， 实 现 该 接口 的 监听 器 需要 实现 如 下 两 个 
方法 。 

> ”sessionCreated(HttpSessionEvent se): 用 户 与 服务 器 的 会 话 开始 、 创 建 时 时 触发 该 方法 。 

> sessionDestroyed(HttpSessionEvent se): 用 户 与 服务 器 的 会 话 断 开 、 销 毁 时 触发 该 方法 。 

HttpSessionAttributeListener 则 用 于 监听 HttpSession (session》 范围 内 属性 的 变化 ， 实 现 该 接口 的 
监听 器 需要 实现 attributeAdded 、attributeRemoved 、attributeReplaced 三 个 方法 。 由 此 可 见 ， 
HttpSessionAttributeListener 与 ServletContextAttributeListener 的 作用 相似 ， 都 用 于 监听 属性 的 改变 , 只 
是 HttpSessionAttributeListener 监听 session 范围 内 属性 的 改变 ， 而 ServletContextAttributeListener 监听 
的 是 application 范围 内 属性 的 改变 。 

实现 HttpSessionListener 接口 的 监听 器 可 以 监听 每 个 用 户 会 话 的 开始 和 断 开 ， 因 此 应 用 可 以 通过 
该 监听 器 监听 系统 的 在 线 用 户 。 

下 面 是 该 监听 器 的 实现 类 。 

程序 清单 :codes\02\2.13\listenerTest\WEB-INF\src\lee\OnlineListenerjava 


QWebListener 
public class OnlineListener 
implements HttpSessionListener 
{ 
// 当 用 户 与 服务 器 之 间 开 始 session 时 触发 该 方法 
Public void sessionCreated(HttpSessionEvent se) 
{ 
HttpSession session = se.getSession(); 
ServletContext application = session.getServletContext ()# 
// 获 取 session ID 
String sessionId = session.getId(); 
// 如 果 是 一 次 新 的 会 话 
if (session.isNew()) 
{ 
String user = (String)session.getAttribute ("user"); 
// 未 登录 用 户 当 游 客 处 理 
user = (User == null) ? "游客 " : user; 
Map<string , String> online = (Map<String , String>) 
application.getAttribute ("online"); 
if {online == null) 
{ 
online = new Hashtable<String , String>(); 
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} 

// 将 用 户 在 线 信息 放 入 Map 中 

online.put (sessionId , user); 

application. setAttribute("online" , online); 
} 


上 

// 当 用 户 与 服务 器 之 间 session 断 开 时 触发 该 方法 

public void sessionDestroyed (HttpSessionEvent se) 

{ 
HttpSession session = se.getSession(); 
ServletContext application = session.getServletContext (); 
String sessionId = session.getId(); 
Map<string , String> online = (Map<string , String>) 

application.getAttribute("online"); 

if (online != null) 


{ 
// 副 除 该 用 户 的 在 线 信息 


online. remove (sessionId); 


y 
application. setAttribute ("online" , online); 
上 
} 


上 面 的 监听 器 实现 类 实现 了 HttpSessionListener 接口 ， 该 监听 器 可 用 于 监听 用 户 与 服务 器 之 间 
session 的 开始 、 关 闭 ， 当 用 户 与 服务 器 之 间 的 session 开始 时 ， 如 果 该 session 是 一 次 新 的 session， 程 
序 就 将 当前 用 户 的 session ID、 用 户 名 存 入 application 范围 的 Map 中 ; 当 用 户 与 服务 器 之 间 的 session 
关闭 时 ， 程 序 从 application 范围 的 Map 中 删除 该 用 户 的 信息 。 通 过 上 面 的 方式 ，application 范围 内 的 
Map 就 记录 了 当前 应 用 的 所 有 在 线 用 户 。 

显示 在 线 用户 的 页 面 代 码 很 简单 ， 只 要 迭代 输出 application 范围 的 Map 即 可 ， 如 以 下 代码 所 示 。 

程序 清单 ， codes\02\2.13\listenerTest\online.jsp 


<¥8 page contentType="text/html; charset-GBK" 1anguager"jaya”errorPager"” 和 > 

<%@ page import="java.util.*" $> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1l-transitional.dtd"> 

<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
<title> 用 户 在 线 信息 </title> 

</head> 

<body> 

在 线 用 户 : 

<table width="400" border="1"> 

< 

Map<string , String> online = (Map<string , String>)application 
getAttribute ("online") ; 

for (String sessionId : online.keyset()) 

{%> 

<tr> 


<td><h=sessionId$> 
<td><%=online.get (sessionId)§> 
</tr> 
<18> 
</body> 
</html> 


笔者 在 本 机 启动 三 个 不 同 的 浏览 器 来 模拟 三 个 用 户 访问 该 应 用 , 访问 onlinejsp 页 面 将 可 看 到 如 图 
2.42 所 示 页 面 。 

需要 指出 的 是 : 采用 HttpSessionListener 监听 用 户 在 线 信息 比较 “粗糙 "， 只 能 监听 到 有 多 少 人 在 
线 ， 每 个 用 户 的 session ID 等 基本 信息 。 如 果 应 用 需要 监听 到 每 个 用 户 停留 在 哪个 页 面 、 本 次 在 线 的 
停留 时 间 、 用 户 的 访问 P 等 信息 ， 则 应 该 考虑 定时 检查 HttpServletRequest 来 实现 。 
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图 2.42 ”使 用 HttpSessionListener 监听 在 线 信息 


通过 检查 HttpServletRequest 的 做 法 可 以 更 精确 地 监控 在 线 用 户 的 状态 ， 这 种 做 法 的 思路 是 : 

> ”定义 一 个 ServletRequestListener， 这 个 监听 器 负责 监听 每 个 用 户 请 求 ， 当 用 户 请 求 到 达 时 ， 
系统 将 用 户 请 求 的 session ID、 用 户 名 、 用 户 IP、 正 在 访问 的 资源 、 访 问 时 间 记 录 下 来 。 

> ”启动 一 条 后 台 线 程 ， 这 条 后 台 线 程 每 隔 一 段 时 间 检 查 上 面 的 每 条 在 线 记 录 ， 如 果菜 条 在 线 记 
录 的 访问 时 间 与 当前 时 间 相差 超过 了 指定 值 ， 将 这 条 在 线 记录 删除 即 可 。 这 条 后 台 线 程 应 随 
着 Web 应 用 的 启动 而 启动 ， 可 考虑 使 用 ServletContextListener 来 完成 。 

下 面 先 定义 一 个 ServletRequestListener， 它 负责 监听 每 次 用 户 请 求 : 每 次 用 户 请 求 到 达 时 ， 如 果 

是 新 的 用 户 会 话 ， 将 相关 信息 插入 数据 表 ， 如 果 是 老 的 用 户 会 话 ， 则 更 新 数据 表 中 已 有 的 在 线 记 录 。 
程序 清单 :codes\02\2.13\ online\WEB-INF\src\lee\RequestListener.java 


QWebListener 
public class RequestListener 
implements ServletRequestListener 


// 当 用 户 请 求 到 达 、 被 初始 化 时 触发 该 方法 
public void requestInitialized(ServletRequestEvent sre) 
{ 


{ 


HttpServletRequest request = (HttpServletRequest)sre.getServletRequest (); 
HttpSession session = request,getSession(); 
// 获 取 session ID 

String sessionId = session.getId(); 

// 获 取 访 问 的 IP 和 正在 访问 的 页 面 

String ip = request.getRemoteAddr (); 

String page = request.getRequestURI(); 

String user = (String)session.getAttribute ("us: 
// 未 登录 用 户 当 游 客 处 理 

user = (user == null) ? "游客 ”: useri 

try 

{ 


DbDao dd = new DbDao ("com.mysql.jdbc.Driver" 
， "jdbc:mysql://localhost:3306/online_inf" 
7 "root" 
1 "32147"); 
Resultset rs = dd.query("select * from online_inf where session_ id=?" 
, true , sessionId); 
// 如 果 访 用 户 对 应 的 session ID 存在 ， 表 明 是 旧 的 会 话 
if (rs.next()) 


{ 
// 更 新 记录 
rs.updatestring (4, page); 
rs.updateLong (5, System.currentTimeMillis()); 
rs.updateRow(); 
rs.close(); 


// 播 入 该 用 户 的 在 线 信息 
dd.insert("insert into online_inf values(? ，? ,? ，? ，3) 0 
sessionId , user , ip ，Page , System.currentTimeMillis()); 
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} 
catch (Exception ex) 
{ 


ex.printstackTrace (); 
} 


} 
// 当 用 户 请 求 结束 、 被 销毁 时 触发 该 方法 
public void requestDestroyed(ServletRequestEvent sre) 
{ 
} 
} 


上 面 的 程序 中 粗 体 字 代码 控制 用 户 会 话 是 新 的 session， 还 是 已 有 的 session， 新 的 session 将 插入 
数据 表 ， 旧 的 session 将 更 新 数据 表 中 对 应 的 记录 。 

接 下 来 定义 一 个 ServletContextListener， 它 负责 启动 一 条 后 台 线程 ， 这 条 后 台 线程 将 会 定期 检查 
在 线 记录 ， 并 删除 那些 长 时 间 没有 重新 请 求 过 的 记录 。 该 Listerner 代码 如 下 。 

程序 清单 :codes\02\2.13\ online\WWEB-INF\src\lee\OnlineListenerjava 


QWebListener 
public class OnlineListener 
implements ServletContextListener 


// 超 过 该 时 间 (10 分 钟 》 没 有 访问 本 站 即 认为 用 户 已 经 离线 

public final int MAX_MILLIS = 10 * 60 * 1000; 

// 应 用 启动 时 触发 该 方法 

public void contextInitialized(ServletContextEvent sce) 


{ 


// 每 5 秒 检查 一 次 
new javax.swing.Timer (1000 * 5 ，new RctionListener() 
{ 
public void actionPerformed(ActionEvent e) 
{ 
try 
{ 
DbDao dd = new DbDao ("com.mysql.jdbc.Driver" 
, "jdbc:mysql://localhost:3306/online_inf" 
» "root” 
"32147"); 
Resultset rs = dd.query("select * from online_inf" , false); 
StringBuffer beRemove = new StringBuffer("("); 
while(rs.next ()) 


// 如 果 距 离 上 次 访问 时 间 超过 了 指定 时 间 
if ((System.currentTimeMillis () - rs.getLong(5)) 
> MAX_MILLIS) 
{ 
se ID 添加 进来 
append ("'"); 


ee append (rs.getstring (1)); 
beRemove.append("' ，") 7 
} 


} 
// 有 需要 删除 的 记录 
if (beRemove.length() > 3) 
{ 

beRemovessetLength (beRemove. length() - 3); 

9 beRemove.append(") "); 
// 删 除 所 有 “超过 指定 时 间 未 重新 请 求 的 记录 ” 
dd.modify ("delete from online_inf where session_id in " 
+ beRemove.toString()); 


} 
dd.closeConn(); 
上 
catch (Exception ex) 
{ 
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2 


ex.printStackTrace (); 


} 
1D) .start() 7 


nu void contextDestroyed(ServletContextEvent sce) 
} 
} 
上 面 的 程序 中 粗 体 字 代码 负责 收集 系统 中 “超过 指定 时 间 未 访问 ”的 在 线 记录 ， 然 后 程序 通过 一 
条 SQL 语句 删除 这 些 在 线 记录 。 
需要 指出 的 是 ， 上 面 程序 启动 的 后 台 线 程 定期 检查 的 时 间 间 隔 为 5 秒 ， 实 际 项 目 中 这 个 时 间 应 该 
适当 加 大 ， 尤 其 是 在 线 用 户 较 多 时 ， 否 则 应 用 将 会 频繁 地 检查 online_inf 数据 表 中 的 全 部 记录 ， 这 将 
导致 系统 开销 过 大 。 
显示 在 线 用 户 的 页 面 十 分 简单 ， 只 要 查询 online_inf 表 中 全 部 记录 ， 并 将 这 些 记录 显示 出 来 即 可 。 
以 下 是 该 页 面 代码 。 
程序 清单 : codes\02W2.13\ online\online.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" 4 
<%@ page import="java.sql.*,lee.*" %> 
<1DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
‘<head> 
<title> 用 户 在 线 信息 </title> 
</head> 
<body> 
在 线 用 户 : 
<table width="640" border="1"> 
<% 
DbDao dd = new DbDao ("com.mysql.jdbc.Driver" 
, "jdbc:mysql://localhost:3306/online_inf" 
1 "root" 
"32147"); 
// 查 询 online_inf 表 (在线 用 户 表 ) 的 全 部 记录 EE: 
ResultSet rs = dd.query("select * from online_inf" , false); yn 
while (rsnext()) 
{%> 
<tr> 


</body> 
</html> 


启动 不 同 浏览 器 访问 该 应 用 的 不 同 页 面 ， 然 后 访问 onlinejsp 页 面 将 可 看 到 如 图 2.43 所 示 页 面 。 


在 线 用 户 


isEzsbrFFO7562850c371563081T8E9 ha.0.0.1 online/ 
N47B28C34E52BD1C5020206090F C34 


六 
图 2.43 详细 的 在 线 信息 
对 于 应 用 中 所 有 需要 统计 在 线 用 户 页 面 ， 只 要 将 上 面 的 onlinejsp 页 面包 含 到 页 面 中 即 可 。 
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区 
大- 注意 :二 一 一 一 - 
本 应 用 需要 使 用 数据 表 来 保存 在 线 用 户 信息 ， 因 此 读者 应 该 先 将 codes\02\2.13\ 3 


online\WEB-INF 目 录 下 的 者 内 本 导入 才 所 话 


2.14 JSP 2 特性 


2003 年 发 布 的 JSP 2.0 升级 了 JSP 1.2 规范 , 新 增 了 一 些 额 外 的 特性 。 JSP 2.0 使 得 动态 网 页 的 设计 
更 加 容易 ， 甚 至 可 以 无 须 学习 Java， 也 可 做 出 JSP 页 面 ， 从 而 可 以 更 好 地 支持 团队 开发 。 目 前 Servlet 
3.0 对 应 于 JSP 2.2 规范 ， 不 过 JSP 2.2 与 JSP 2.0 相差 并 不 大 ， 我 们 将 其 统称 为 JSP 2。 

相 比 JSP 1.2，JSP 2 主要 增加 了 如 下 新 特性 。 

> ”直接 配置 JSP 属性 。 

> ”表达 式 语言 。 

> ”简化 的 自 定义 标签 API。 

> ”Tag 文件 语法 。 

如 果 需 要 使 用 JSP 2 语法 ， 其 web.xml 文件 必须 使 用 Serviet 2.4 以 上 版 本 的 配置 文件 。Servlet 2.4 
以 上 版 本 的 配置 文件 的 根 元 素 写法 如 下 : 

<?xml version="1.0" encoding="GBK"?> 

<!-- 不 再 使 用 DYD， 而 是 使 用 Schema 描述 ， 版 本 也 升级 为 2.4--> 

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance™" 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun. 


com/xml/ns/j2ee/web-app_2_4.xsd" version="2.4"> 
<!-- 此 处 是 Web 应 用 的 其 他 配置 --> 


/uel 


本 书 所 给 出 的 Web 应 用 都 是 使 用 Servlet 3.0 规范 , 也 就 是 对 应 于 JSP 2. 2 规范 ， 因此 完 
全 支持 JSP2 的 特性 。 


>>2.14.1 配置 JSP 属性 


JSP 属性 定义 使 用 <jsp-property-group/> 元 素 配 置 ， 主 要 包括 如 下 4 个 方面 。 

> ”是 否 允 许 使 用 表达 式 语言 使 用 <el-ignored/> 元 素 确定 ， 默 认 值 为 false， 即 允许 使 用 表达 式 

> ”是 否 允许 使 用 JSP 脚本 : 使 用 <scripting-invalid/> 元 素 确定 , 默认 值 为 false, 即 允许 使 用 JSP 
脚本 。 

> ”声明 JSP 页 面 的 编码 : 使 用 <page-encoding/> 元 素 确定 ， 配置 该 元 素 后 ， 可 以 代替 每 个 页 面 
里 page 指令 contentType 属性 的 charset 部 分 。 

> ”使 用 隐 式 包含 : 使 用 <include-prelude/> 和 <include-coda/> 元 素 确定 , 可 以 代替 在 每 个 页 面 里 
使 用 include 编译 指令 来 包含 其 他 页 面 。 


下 面 的 web.xml 文件 配置 了 该 应 用 下 的 系列 属性 。 
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程序 清单 :codes\022.14\jsp2\WWEB-INF\web.xml 


<?xml version="1.0" encoding="GBK"?> 
<web-app xmlns="http://java.sun.com/xml /ns/javaee" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java. sun.com/xml/ns/javaee 
//java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0"> 
关于 JSP 的 配置 信息 --> 
<jsp-config> 
<jsp-property-group> 
<!-- 对 哪些 文件 应 用 配置 一 > 
<url-pattern>/noscript/*</url-pattern> 
<!-- 忽略 表达 式 语言 一 > 
<el-ignored>true</el-ignored> 
<!-- 页 面 编码 的 字符 集 --> 
<page-encoding>GBK</page-encoding> 
<!-- 不 允许 使 用 Java 脚本 一 -> 
<scripting-invalid>true</scripting-invalid> 
<!-- 隐 式 导入 页 面 头 。--> 
<include-prelude>/inc/top.jspf</include-prelude> 
<!-- 隐 式 导入 页 面 尾 --> 
<include-coda>/inc/bottom.jspf</include-coda> 
</jsp-property-group> 
<jsp-property-group> 
<!-- 对 哪些 文件 应 用 配置 --> 
<url-pattern>*.jsp</url-pattern> 
<el-ignored>false</el-ignored> 
<!-- 页 面 编码 字符 集 --> 
<page-encoding>GBK</page-encoding> 
<!-- 允许 使 用 Java 脚本 --> 
<scripting-invalid>false</scripting-invalid> 
</jsp-property-group> 
<jsp-property-group> 
<!-- 对 哪些 文件 应 用 配置 一 > 
<url-pattern>/inc/*</url-pattern> “ 
<el-ignored>false</el-ignored> 
<!-- 页 面 编码 字符 集 --> 
<page-encoding>GBK</page-encoding> 
<!-~ 不 允许 使 用 Java 脚本 --> 
<scripting-invalid>true</scripting-invalid> 
</jsp-property-group> 
</jsp-config> 
</web-app> 


上 面 的 配置 文件 中 配置 了 三 个 jsp-property-group 元 素 ， 每 个 元 素 配置 一 组 JSP 属性 ， 用 于 指定 哪 
些 JSP 页 面 应 该 满足 怎样 的 规则 。 例 如 ， 第 一 个 jsp-property-group 元 素 指定 ，/noscript/ 下 的 所 有 页 面 
应 该 使 用 GBK 字符 集 进 行 编码 ， 且 不 允许 使 用 JSP 脚本 ， 忽 略 表达 式 语 言 ， 并 隐 式 包含 页 面 头 、 页 
面 尾 。 


昌 -天 - 注意 : ee 
如 果 在 不 允许 使 用 JSP 脚本 的 页 面 中 使 用 JSP 脚本 ， 则 该 页 面 将 出 现 错误 。 即 


/noscript/ 下 的 页 面 中 使 用 JSP 脚本 将 引起 错误 -。 


i 下 面 的 JSP 页 面 代码 ， 为 testljsp 页 面 代码 。 
程序 清单 :codes\02W2.14\jsp2\noscript\test1.jsp 
<$B@ page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
“http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 页 面 配置 1 </title> 
</head> 
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<body> 

<h2> 页 面 配置 1</h2> 

下 面 是 表达 式 语言 输出 : <br/> 
${1 + 2} 

</body> 

</html> 


上 面 的 页 面 中 粗 体 字 代码 就 是 表达 式 语言 ， 关 于 表达 式 语言 请 看 下 一 节 介 绍 。 但 由 于 我 们 在 
web.xml 文件 中 配置 了 表达 式 语言 无 效 ， 所 以 浏览 该 页 面 将 看 到 系统 直接 输出 表达 式 语言 。 在 浏览 器 
中 浏览 该 页 面 的 效果 如 图 2.44 所 示 。 


Tag, 
Lp ! 


项 
图 2.44 页 面 配置 的 运行 效果 


从 图 2.44 中 可 以 看 出 ，testljsp 的 表达 式 语言 不 能 正常 输出 ， 这 是 因为 我 们 配置 了 忽略 表达 式 语 
言 。 上 面 页 面 中 看 到 隐 式 include 的 页 面 头 分 别 是 topjspf 和 bottom.jspf， 这 两 个 文件 依然 是 JSP 页 面 ， 
只 是 将 文件 名 后 缀 改 为 了 jspf 而 已 。 
而 位 于 应 用 根 路 径 下 的 JSP 页 面 则 支持 表达 式 语言 和 JSP 脚本 , 但 没有 使 用 隐 式 include 包含 页 面 
头 和 页 面 尾 。 应 用 根 路 径 下 的 test2jsp 页 面 代码 如 下 。 
程序 清单 : codes\2\2.14\jsp2\test2.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" $%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 页 面 配 置 2 </title> 
</head> 
<body> 
<h2> 页 面 配 置 2</h2> 
下 面 是 表达 式 语言 输出 :<br/> 
${1 + 2}<br/> 
下 面 是 小 脚本 输出 ，<br/> 
<hout.println ("hello Java");%> 
</body> 
</html> 


上 面 的 页 面 中 两 行 粗 体 字 代码 正 是 嵌 套 在 JSP 页 面 中 的 JSP 脚本 和 表达 式 语言 ， 浏 览 该 页 面 将 看 
到 如 图 2.45 所 示 的 效果 。 

图 2.45 中 椭圆 形 图 出 的 3 就 是 ${1+2} 的 结果 一 一 这 就 是 
表达 式 语言 的 计算 结果 。 


>>2.14.2 表达 式 语言 


表达 式 语言 (Expression Language) 是 一 种 简化 的 数据 


而 要 小 
hello Jova 


本 输出 ， 
二 一 一 一 访问 方式 。 使 用 表达 式 语言 可 以 方便 地 访问 JSP 的 隐 含 对 象 


和 JavaBeans 组 件 ， 在 JSP 2 规范 中 ， 建 议 尽量 使 用 表达 式 
语言 使 JSP 文件 的 格式 一 致 ， 避 免 使 用 Java 脚本 。 
表达 式 语言 可 用 于 简化 JSP 页 面 的 开发 ， 允 许 美 工 设计 人 员 使 用 表达 式 语言 的 语法 获取 业务 逻辑 
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组 件 传 过 来 的 变量 值 。 


${expression} 
1. 表达 式 语言 支持 的 算术 运算 符 和 逻辑 运算 符 
表达 式 语言 支持 的 算术 运算 符 和 人 逻辑 运算 符 非 常 多 ， 所 有 在 Java 语言 里 支持 的 算术 运算 符 , 表达 
式 语言 都 可 以 使 用 ， 甚 至 Java 语言 不 支持 的 一 些 算术 运算 符 和 逻辑 运算 符 ， 表 达 式 语言 也 支持 。 
下 面 的 JSP 页 面 示范 了 在 表达 式 语 言 中 使 用 算术 运算 符 。 
程序 清单 : codes\02\2.14\jsp2\arithmeticOperatorjsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 表达 式 语言 -~ 算术 运算 符 </title> 
</head> 
<body> 
<h2> 表 达 式 语言 - 算术 运算 符 </h2><hr/> 


<table border="1" bgcolor="#aaaadd"> 
<tr> 


<td><b> 表 达 式 语言 </b></td> 
<td><b> 计 算 结果 </b></td> 
</tr> 
<!-- 直接 输出 常量 --> 
<tr> 
<td>\${1}</td> 
<td>${1}</td> 


<td>\$(1.2 + 2.3}</td> 
<ta>$11.2 + 2.3}</td> 


<td>\$11.2E4 + 1.4}</td> 
<td>${1.2E4 + 1.4}</td> 


<td>\${-4 - 2}</td> 
<td>${-4 - 2}</td> 


<td>\${21 * 2}</td> 
<td>${21 * 2J</td> 


</tr> 

<!-- 计算 除法 一 > 

<tr> 
<td>\${3/4}</td> 
<td>${3/4}</td> 

</tr> 

<1-- 计算 除法 --> 

<tr> 


<td>\St3 div 4}</td> 
<td>${3 div 4}</td> 
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</tr> 

<!-- 计算 除法 一 > 

<tr> 
<td>\${3/0}</td> 
<ta>${3/0}</ta> 

</tr> 

<!-- 计算 求 余 --> 

<tr> 
<td>\${10%4}</td> 
<td>${10%4}</td> 

</tr> 

<!-- 计算 求 余 -> 

<tr> 


<td>\${10 mod 4}</td> 
<td>${110 mod 4}</td> 


<td>\${ (1==2) ? 3 : 4}</td> 
<td>${ (1==2) ? 3 : 4)</td> 


</tr> 
</table> 
</body> 
</html> 


上 面 的 页 面 中 示 
也 发 现 了 表达 式 语言 
以 3/0 的 实质 是 3.0/0.0， 得 到 结果 应 该 是 Infinity 。 


范 了 表达 式 语言 所 支持 的 加 、 减 、 乘 、 除 、 求 余 等 算术 运算 符 的 功能 ， 读 者 可 能 


支持 div、mod 等 运算 符 。 而 且 表达 式 语言 把 所 有 数值 都 当成 浮 点 数 处 理 ， 所 


浏览 arithmeticOperatorjsp 页 面 ， 将 看 到 如 图 2.46 所 示 的 效果 。 


XND MAD WD em WED IAD WED 


表达 式 语言 - 算术 运算 符 


图 2.46 支持 算术 运算 符 的 表达 式 语言 
如 果 需 要 在 支持 表达 式 语言 的 页 面 中 正常 输出 “$” 符 号 ， 则 在 “$” 符 号 前 加 转 义 字符 “\”， 否 


则 系统 以 为 “$” 是 表达 式 语言 的 特殊 标记 。 


也 可 以 在 表达 式 语言 中 使 用 逻辑 运算 符 ， 如 下 面 的 JSP 页 面 所 示 。 


程序 清单 : codes\02\2.14Njsp2\logicOperatorjsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1l-transitional.dtd"> 


<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 

<title> 表达 式 语言 - 逻辑 运算 符 </title> 
</head> 
<body> 


140 


http://52pdf.taobao.com 


2 


<h2> 表 达 式 语言 - 逻辑 运算 符 </h2><hr/> 
数字 之 间 的 比较 : 
<table border="1" bgcolor="#aaaadd"> 
<tr> 
<td><b> 表 达 式 语言 </b></td> 
<td><b> 计 算 结果 </b></td> 


</tr> 
<!-- 直接 比较 两 个 数字 --> 
<tr> 
<td>\${1 slt; 2}</td> 
<td>$f1 < 2}</td> 
</tr> 
<!-- 使 用 1t 比较 运算 符 --> 
<tr> 
<td>\s{1 1t 2}</td> 
<td>${1 1t 2}</td> 
</tr> 
<!-- 使 用 > 比较 运算 符 --> 
<tr> 
<td>\${1 sgt; (4/2)}</td> 
<ta>$11 > (4/2)}</td> 
</tr> 
<!-- 使 用 gt 比较 运算 符 --> 
<tr> 
<td>\${1 gt (4/2)}</td> 
<td>${1 gt (4/2)}</ta> 
</tr> 
<!-- 使 用 >= 比 较 运算 符 --> 
<tr> 
<td>\${4.0 sgt= 3}</td> 
<td>${4.0 >= 3}</td> 
</tr> 
<!-- 使 用 ge 比较 运算 符 --> 
<tr> 
<td>\$14.0 ge 3}</td> 
<td>${4.0 ge 3}</td> 


<!-- 使 用 <= 比 较 运算 符 一 > 


<td>\$14 &lt;= 3}</td> 
<td>$14 <= 3}</td> 
</tr> 
<!-- 使 用 le 比较 运算 符 --> 
<tr> 
<td>\${4 le 3}</td> 
<ta>$14 le 3}</td> 
</tr> 
<!-~ 使 用 == 比 较 运算 符 一 > 
<tr> 
<td>\${100.0 == 100}</td> 
<td>${100.0 == 100}</td> 
</tr> 
<!-- 使 用 eq 比较 运算 符 --> 
<tr> 
<td>\${100.0 eq 100}</td> 
<td>${100.0 eq 100}</td> 
</tr> 
<!-- 使 用 != 比 较 运算 符 --> 
<tr> 
<td>\${ (10*10) != 100}</td> 
<td>${ (10*10) 1= 100}</td> 
</tr> 
<!-- 先 执行 运算 ， 再 进行 比较 运算 ， 使 用 ne 比较 运算 符 --> 
<tr> 
<td>\${ (10*10) ne 100}</td> 
<td>${ (10*10) ne 100}</td> 
</tr> 
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</table> 
字符 之 间 的 比较 : 
<table border="1" bgcolor="#aaaadd"> 
<tr> 
<td><b> 表 达 式 语言 </b></td> 
<td><b> 计 算 结果 </b></td> 
</tr> 
<tr> 
<td>\${'a' élt; 'b'}</td> 
<td>${'a' < 'b'}</ta> 
</tr> 
<tr> 
<td>\${'hip' sgt; ‘hit'}</td> 
<td>${'hip' > 'hit'j</td> 
</tr> 
<tr> 
<td>\${'4' sgt; 3}</td> 
<td>${'4' > 3}</td> 
</tr> 
</table> 
</body> 
</html> 


从 上 面 程序 的 粗 体 字 代码 中 可 以 看 出 : 表达 式 语 言 不 仅 可 在 数字 与 数字 之 间 比 较 ， 还 可 在 字符 与 
字符 之 间 比 较 ， 字 符 串 的 比较 是 根据 其 对 应 UNICODE 值 来 比较 大 小 的 。 

2. 表达 式 语 言 的 内 置 对 象 

使 用 表达 式 语言 可 以 直接 获取 请 求 参数 值 ， 可 以 获取 页 面 中 JavaBean 的 指定 属性 值 ， 获 取 请 求 头 
及 获取 page、request、session 和 application 范围 的 属性 值 等 ， 这 些 都 得 益 于 表达 式 语 言 的 内 置 对 象 。 

表达 式 语言 包含 如 下 11 个 内 置 对 象 。 


> 
> 


pageContext:， 代表 该 页 面 的 pageContext 对 象 ， 与 JSP 的 pageContext 内 署 对 象 相同 。 
pageScope: 用 于 获取 page 范围 的 属性 值 。 

requestScope: 用 于 获取 request 范围 的 属性 值 。 

sessionScope: 用 于 获取 session 范围 的 属性 值 。 

applicationScope: 用 于 获取 application 范围 的 属性 值 。 

param: 用 于 获取 请 求 的 参数 值 。 

paramValues: 用 于 获取 请 求 的 参数 值 ， 与 param 的 区 别 在 于 ， 该 对 象 用 于 获取 属性 值 为 数 
组 的 属性 值 。 

header: 用 于 获取 请 求 头 的 属性 值 。 

headerValues: 用 于 获取 请 求 头 的 属性 值 ， 与 header 的 区 别 在 于 ， 该 对 象 用 于 获取 属性 值 
为 数组 的 属性 值 。 

initParam: 用 于 获取 请 求 Web 应 用 的 初始 化 参数 。 

cookie: 用 于 获取 指定 的 Cookie 值 。 


下 面 的 JSP 页 面 示范 了 如 何 使 用 表达 式 语 言 的 内 置 对 象 的 方法 。 
程序 清单 : codes\02\2.14\jsp2\implicit-objects.jsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 


<title> 表达 式 语言 - 内 置 对 象 </title> 


</head> 
<body> 
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<form action="implicit-objects.jsp" method="post"> 
<!-- 通过 $ {param[ "name']) 获取 请 求 参 数 --> 
你 的 名 字 = <input type="text" name="name" value-"${paran[ 'name']}"/> 
<input type="submit” value=' 提 交 '/> 
</form><br/> 
<$ session.setAttribute("user"” , "abc"); 
// 下 面 三 行 代 码 添加 Cookie 
Cookie c = new Cookie("name" , "yeeku"); 
c.setMaxAge(24 * 3600)7 
response.addCookie (c); 
3> 
<table border="1" width="660" bgcolor="#aaaadd"> 
<tr> 
<td width="170"><b> 功 能 </b></td> 
<td width="200"><b> 表 达 式 语言 </b></td> 
<td width="300"><b> 计 算 结 果 </b></td> 
<tr> 
<!-- 使 用 两 种 方式 获取 请 求 参 数值 -> 
<td> 取 得 请 求 参数 值 </td> 后 
<td>\${param.name}</td> 
<td>${param. name} snbsp;</td> 
</tr> 
<tr> 
<td> 取 得 请 求 参数 值 </td> 
<td>\${param["name"] }</td> 
<td>$ {param["name"] }snbsp;</td> 
</tr> 
<tr> 
<!-- 使 用 两 种 方式 获取 指定 请 求 头 信息 --> 
<td> 取 得 请 求 头 的 值 </td> 
<td>\$fheader.hostj</td> 
<td>${header.host}</td> 
</tr> 
<tr> 
<td> 取 得 请 求 头 的 值 </cd> 
<td>\${header["accept"]}</td> 
<td>${header ["accept"] }</td> 


</tr> 

<1-- 获取 Web 应 用 的 初始 化 参数 值 -> 

<tr> 
<td> 取 得 初始 化 参数 值 </td> 
<td>\${initParam["authorn]j</td> 
<td>$tinitparam["author"]}</td> 

</tr> 

<!-- 获取 session 返回 的 属性 值 --> 

<tr> 
<td> 取 得 session 的 属性 值 </td> 
<td>\${sessionscope["user"]}</td> 
<td>${sessionscope["user"]}</td> 

</tr> 

<!-- 获取 指定 Cookie 的 值 一 > 

<tr> 
<td> 取 得 指定 Cookie 的 值 </td> 
<td>\${cookie["name"] .value}</td> 
<td>${cookie["name"] .value}</td> 

</tr> 

</table> 
</body> 
</html> 


上 面 的 页 面 中 粗 体 字 代码 就 是 使 用 表达 式 语言 内 置 对 象 的 关键 代码 。 浏 览 上 面 页 面 ， 并 通过 页 面 
中 表单 来 提交 请 求 ， 将 看 到 如 图 2.47 所 示 的 效果 。 

3. 表达 式 语 言 的 自 定义 函数 

表达 式 语言 除了 可 以 使 用 基本 的 运算 符 外 ， 还 可 以 使 用 自 定义 函数 。 通 过 自 定义 函数 ， 能 够 大 大 
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加 强 表达 式 语言 的 功能 。 自 定义 函数 的 开发 步骤 非常 类 似 于 标签 的 开发 步骤 ， 定 义 方式 也 几乎 一 样 。 
区 义 标签 语言 中 使 用 。 


表达 式 语 言 - 内 置 对 象 


请 输入 你 的 名字 
你 的 名 字 = [cryit E33 


图 2.47 表达 式 语言 


中 的 内 置 对 象 
提示 :;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
函数 功能 大 大 扩充 了 EL 的 功能 ，EL 本 身 只 是 一 种 数据 访问 语言 ， 因 此 它 不 支持 调用 ， 
SS. 方法 。 如 果 需 要 在 EL 中 进行 更 复杂 的 处 理 ， 就 可 以 通过 函数 来 完成 。 函 数 的 本 质 是 : 提 ! 
| 。 供 一 种 语法 允许 在 EL 中 调用 某 个 类 的 静态 方法 


下 面 介 绍 表达 式 语言 中 自 定义 函数 的 开发 步骤 。 


人 @ 开发 函数 处 理 类 : 函数 处 理 类 就 是 普通 类 ， 这 个 普通 类 中 包含 若干 个 静态 方法 ， 每 个 静态 方 
法 都 可 定义 成 一 个 函数 。 实 际 上 这 个 步骤 也 是 可 省 略 的 一 一 完全 可 以 直接 使 用 JDK 或 其 他 项 目 提供 的 
类 ， 只 要 这 个 类 包含 静态 方法 即 可 。 

程序 清单 :codes\02\2.14\jsp2\WWEB-INF\src\lee\Functions.java 

ti class Functions 


// 对 字符 串 进 行 反 转 


public static String reverse( String text ) 
{ 


return new StringBuffer( text ).reverse().tostring(); 


} 

// 统 计 字符 串 的 个 数 
public static int countChar( String text ) 
{ 


return text,length(); 
} 


最 
得- 注意 : 


完全 可 以 直接 使 用 JDK 或 其 他 项 目 提供 的 类 作为 函数 处 理 类 , 只 要 这 个 类 包含 静态 
方法 即 


可 


【@ 使 用 标签 库 定义 函数 ; 定义 函数 的 方法 与 定义 标签 的 方法 大 到 相似 。 在 <taglib.…/> 元 素 下 增加 


<tag.…. 人 元素 用 于 定义 自 定义 标签 ， 增加 <function... 人 > 元 素 则 用 于 定义 自 定义 函数 。 每 个 <function.… 亡 
元 素 只 要 三 个 子 元 素 即 可 。 


> name: 指定 自 定义 函数 的 函数 名 。 
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> ”function-class: 指定 自 定义 函数 的 处 理 类 。 

> ”function-signature: 指定 自 定义 函数 对 应 的 方法 。 

下 面 的 标签 库 定义 TLD) 文件 将 上 面 的 Functions.java 类 中 所 包含 的 两 个 方法 定义 成 两 个 函数 。 
程序 清单 : codes\022.14\jsp2\WEB-INF\srcmytaglib.tld 


<?xml Version="1.0”encoding="GBK"?> 
<taglib xmlns="http://java. sun. com/xml/ns/j2ee"™ 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
chemaLocation="http://java.sun.com/xml /ns/j2ee 
sptaglibrary_2_0.xsd" version="2.0"> 
<tlib-version>1.0</tlib-version> 
<short-name>crazyit</short-name> 
<!-- 定义 该 标签 库 的 URI 一 -> 
<uri>http://www.crazyit.org/tags</uri> 
<!-- 定义 第 一 个 函数 一 > 
<function> 
<!-- 定义 函数 名 :reverse --> 


<!-- 定义 函数 的 处 理 类 --> 
<function-class>lee. Functions</function-class> 
<!- 定义 函数 的 实现 方法 --> 
<function-signature> 
java.lang.String reverse(java.lang.String)</function-signature> 
</function> 
<!-- 定义 第 二 个 函数 : countChar --> 
<function> 
<!-- 定义 函数 名 :countChar 
<name>countChar</, 
<!-- 定义 函数 的 处 理 类 - 
<function-class>lee .Functions</function-class> 
<!-- 定义 函数 的 实现 方法 --> 
<function-signature>int countChar (java.lang.String) 
</function-signature> 
</function> 
</taglib> 


上 面 的 粗 体 字 代码 定义 了 两 个 函数 ， 不 难 发 现 其 
义 函数 只 需 配置 三 个 子 元 素 即 可 ， 变 化 更 少 。 

人 @ 在 JSP 页 面 的 EL 中 使 用 函数 : 一 样 需要 先导 入 标签 库 ， 然 后 再 使 用 函数 。 下 面 是 使 用 函数 的 
JSP 页 面 代码 。 

程序 清单 : codes\02\2.14\jsp2\useFunctions.jsp 


<%@ page conteéntType="text/html; charset=GBK" language="java" errorPage="" %> 
<%8 taglib prefix="crazyit" uri="http://ww.crazyit.org/tags"®> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN™ 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 4 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> new document </title> 
</head> 
<body> 
<h2> 表 达 式 语言 - 自 定义 函数 </h2><hr/> 
请 输入 一 个 字符 趾 : 
<form action="useFunctions.jsp" method="post"> 
字符 串 = <input type="text" name="name" value="${param['name’]}"> 
<input type="submit" value=" 提 交 "> 
</form> 
<table border="1" bgcolor="aaaadd"> 
<tr> 
<td><b> 表 达 式 语言 </b></td> 
<td><b> 计 算 结 果 </b></td> 
<tr> 
<tr> 


义 函 数 比 定义 自 定义 标签 更 简单 ， 因 为 自 定 


<td>\${param["name"]}</td> 
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<td>${param[ "name"]} snbsp;</td> 
</tr> 
<!-- 使 用 reverse 函数 --> 
<tr> 
<td>\${crazyit:reverse (param["name"])}</td> 
<td>${crazyit:reverse (param["name"]) } énbsp;</td> 
</tr> 
<tr> lS 
<td>\${crazyit:reverse (crazyit:reverse(param["name"]))}</td> 
<td>$fcrazyit:reverse (crazyit:reverse (param["name"])) }énbsp;</td> 
</tr> 
<!-- 使 用 countchar 函数 --> 
<tr> 
<td>\${crazyit:countChar (param["name"]) }</td> 
<td>${crazyit:countChar (param["name"]) } énbsp;</td> 


</tr> 
</table> 
</body> 
</html> 
如 上 面 程序 中 粗 体 字 代码 所 示 ， 导 入 标签 库 定义 文件 后 (实质 上 也 是 函数 库 定义 文件 ), 就 可 以 在 


本 


Tag File 是 自 定义 标签 的 简化 用 法 ,使 用 Tag File 可 以 无 须 定义 标签 处 理 类 和 标签 库 文 件 ， 但 仍然 
可 以 在 JSP 页 面 中 使 用 自 定义 标签 。 

下 面 以 Tag File 建立 一 个 迭代 器 标签 ， 其 步骤 如 下 。 

人 @G 建立 Tag 文 件 , 在 JSP 所 支持 Tag File 规范 下 , Tag File 代理 了 标签 处 理 类 , 它 的 格式 类 似 于 JSP 


文件 。 可 


以 这 样 理解 ， 如 同 JSP 可 以 代替 Servlet 作为 表现 层 一 样 ，Tag File 则 可 以 代替 标签 处 理 类 。 


Tag File 具有 以 下 5 个 编译 指令 。 


> 
3 
> 


> 
> 
下 面 
程序 


taglib: 作用 与 JSP 文件 中 的 taglib 指令 效果 相同 ， 用 于 导入 其 他 标签 库 。 

include: 作用 与 JSP 文件 中 的 include 指令 效果 相同 ， 用 于 导入 其 他 JSP 或 静态 页 面 。 

tag: 作用 类 似 于 JSP 文件 中 的 page 指令 ， 有 pageEncoding、body-content 等 属性 ， 用 于 
设置 页 面 编码 等 属性 。 

attribute: 用 于 设置 自 定义 标签 的 属性 ， 类 似 于 自 定义 标签 处 理 类 中 的 标签 属性 。 

variable: 用 于 设置 自 定义 标签 的 变量 ， 这 些 变量 将 传 给 JSP 页 面 使 用 。 

是 迭代 器 标签 的 Tag File， 这 个 Tag File 的 语法 与 JSP 语法 非常 相似 。 

清单 : codes\02\2.14\isp2\WEB-INF\tags\iteratortag 


<%@ tag pageEncoding="GBK" import="java.util.LIistnS> 


lm 


定义 了 4 个 标签 属性 --> 


<s@ attribute name="bgColor" %> 


<S@ a 


ttribute name="cellColor" %> 


<%@ attribute name="title" %> 


<%@ a 
<tabl' 
<tr> 

<td>< 
</tr> 


ttribute name="bean"” 和 > 
@ border="]1" bgcolor="${bgColor}"> 


b>${title}</b></td> 


<!-- 取出 request 范围 的 a 集合 --> 


<%Lie 


t<string> list = (List<string>) 


request .getAttribute ("a") ; 
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for (Object ele : list){%> 
<tr> 

<td bgcolor="${cellColor}"> 
<%=eles> 

</tad> 

</tr> 

<%}%> 

</table> 


上 面 的 页 面 代码 中 的 粗 体 字 代 码 就 是 Tag File 的 核心 代码 , 可 能 细心 的 读者 会 发 现 上 面 的 Tag File 
并 不 会 输出 完整 的 HTML 页 面 ， 它 只 包含 一 个 table 元 素 ， 即 只 有 一 个 表格 ， 这 是 正确 的 。 回 忆 自 定 
义 标 签 的 作用 : 通过 简单 的 标签 在 页 面 上 生成 一 个 内 容 片段 。 同 理 ， 这 个 Tag File 也 只 负责 生成 一 个 
页 面 片段 ， 所 以 它 并 不 需要 输出 完整 的 HTML 页 面 。 

Tag File 的 命名 必须 遵守 如 下 规则 : tagName.tag。 即 Tag File 的 主 文件 名 就 是 标签 名 ， 文 件 名 后 级 
必须 是 tag。 将 该 文件 存在 Web 应 用 的 某 个 路 径 下 ， 这 个 路 径 相当 于 标签 库 的 URI 名 。 笔 者 将 其 放 在 
/WEB-INF/tags 下 ， 即 笔者 的 标签 库 路 径 为 /WEB-INF/tags。 

人 在 页 面 中 使 用 自 定义 标签 时 ， 需 要 先导 入 标签 库 ， 再 使 用 标签 。 使 用 Tag File 标签 与 普通 自 
定义 标签 的 用 法 完全 相同 ， 只 是 在 导入 标签 库 时 存在 一 些 差异 。 由 于 此 时 的 标签 库 没 有 URI， 只 有 标 
签 库 路 径 。 因 此 导入 标签 时 ， 使 用 如 下 语法 格式 : 

<%8 taglib prefix="tagprefix" tagdir=npathw $%> 

其 中 ，prefix 与 之 前 的 taglib 指令 的 prefix 属性 完全 相同 ， 用 于 确定 标签 前 缀 ， 而 tagdir 标签 库 路 

径 下 存放 很 多 Tag File， 每 个 Tag File 对 应 一 个 标签 。 
下 面 是 使 用 Tag File 标签 的 JSP 页 面 代码 。 

程序 清单 : codes\02\2.14\jsp2\useTagFile.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" $%> 

<%@ page import="java.util,.*" $%> . 

<%@ taglib prefix="tags" tagdir="/WEB-INF/tage" %> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http;//www.w3.org/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 

<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head> 

<title> 迁 代 器 tag file</title> 
</head> 
<body> 

<h2> 选 代 器 tag file</h2> 

<% 


// 创 建 集合 对 象 ， 用 于 测试 Tag File 所 定义 的 标签 

List<string> a = new RrrayList<String> ()7 Rt 

a.add("hello"); 

a.add ("world"); 

aadd ("java"); 和 ri 

// 将 集合 对 象 放 入 页 面 范围 

request. setAttribute("a” , a);%> 

// 使 用 自 定义 标签 并 部 

<tags:iterator bgColor="#99dd99" cellColor="#9999ce" 1 
title=" 选 代 器 标签 ”bean="a”/> 


</body> 
</html> 


从 上 面 的 粗 体 字 代码 可 以 看 出 ， 在 JSP 页 面 中 使 用 Tag File 标签 也 很 简单 。 在 该 JSP 页 面 中 ， 使 
用 了 如 下 代码 导入 标签 : 
<%@ taglib prefix="tags" tagdir="/WEB-INF/tags" 和 > 
即 以 tags 开头 的 标签 ， 使 用 /WEB-INF/tags 路 径 下 的 标签 文件 处 理 。 在 JSP 页 面 中 则 使 用 如 下 代 
码 来 使 用 标签 : 


<tags:iterator bgColor="#99dd99" cellColor="#9999ce™ 
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title=" 和 迭代 器 标签 ”bean="a” /> 


tags 表明 该 标签 使 用 /WEB-INF/tags 路 径 下 的 Tag File 来 处 理 标签 ; 而 iterator 是 标签 名 ,即使 用 
WEB-INF/tags 路 径 下 的 iteratortag 文件 负责 处 理 该 标签 。useTagFile 页 面 最 终 的 执行 效果 如 图 2.48 


所 示 。 


办 代 器 tag file 
// 使 用 自 定义 标签 
dL 


图 2.48 使 用 Tag File 的 迭代 器 标签 


Tag File 是 自 定义 标签 的 简化 。 事实 上 ， 就 如 同 JSP 文件 会 编译 成 Servlet 一 样 ，Tag File 也 会 编译 
成 标签 处 理 类 ， 自 定义 标签 的 后 台 依 然 由 标签 处 理 类 完成 ， 而 这 个 过 程 由 容器 完成 。 打 开 Tomcat 的 
work\Catalina\localhost\jsp2\org\apache\jsp\tag\web 路 径 ， 即 可 看 到 iterator tagjava、iterator tag.class 两 
个 文件 ， 这 两 个 文件 就 是 Tag File 所 对 应 的 标签 处 理 类 。 

通过 查看 iterator_tagjava 文件 的 内 容 不 难 发 现 ，Tag File 中 只 有 如 下 几 个 内 置 对 象 。 


> 


Vvvvyv 


2.15 


request: 与 JSP 脚本 中 的 request 对 象 对 应 。 
response: 与 JSP 脚本 中 的 response 对 象 对 应 。 
session: 与 JSP 脚本 中 的 session 对 象 对 应 。 
application: 与 JSP 脚本 中 的 application 对 象 对 应 。 
config: 与 JSP 脚本 中 的 config 对 象 对 应 。 

out: 与 JSP 脚本 中 的 out 对 象 对 应 。 


Servlet 3.0 新 特性 


伴随 Java EE6 一 起 发 布 的 Servlet 3.0 规范 是 Servlet 规范 历史 上 最 重要 的 变革 之 一 , 它 的 许多 特性 
都 极 大 地 简化 了 Java Web 应 用 的 开发 ， 例 如 前 面 介绍 开发 Servlet、Listener、Filter 时 所 使 用 的 
Annotation。 这 些 变革 必 将 带 给 广大 Java 开发 人 员 巨 大 的 便利 ， 大 大 加 快 Java web 应 用 的 开发 效率 。 


>>2.15.1 Servlet 3.0 的 Annotation 


Servlet 3.0 的 一 个 显著 改变 是 “顺应 ”了 潮流 ， 抛 弃 了 采用 web.xml 配置 Servlet、Filter、Listener 
的 烦琐 步骤 ， 允 许 开 发 人 员 使 用 Annotation 修饰 它们 ， 从 而 进行 部 署 。 
Servlet 3.0 规范 在 javax.servleLannotation 包 下 提供 了 如 下 Annotation。 
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@WebServlet: 用 于 修饰 一 个 Servlet 类 ， 用 于 部 署 Serviet 类 。 

@WeblnitParam: 用 于 与 @WebServlet 或 @WebFilter 一 起 使 用 ， 为 Servlet、Filter 配置 参数 。 
@WebListener: 用 于 修饰 Listener 类 ， 用 于 部 署 Listener 类 。 

@WebFitter: 用 于 修饰 Filter 类 ， 用 于 部 署 Filter 类 。 

@MultipartConfig: 用 于 修饰 Servlet， 指 定 该 Servlet 将 会 负责 处 理 multipart/form-data 类 
型 的 请 求 〈 主 要 用 于 文件 上 传 ) 。 
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条 2 


> @ServletSecurity: 这 是 一 个 与 JAAS 有 关 的 Annotation， 修 饰 Servlet 指定 该 Servlet 的 安 
全 与 授权 控制 。 
> @HttpConstraint: 用 于 与 @ServietSecurity 一 起 使 用 ， 用 于 指定 该 Servlet 的 安全 与 授权 控制 。 
> @HttpMethodConstraint: 用 于 与 @ServletSecurity 一 起 使 用 , 用 于 指定 该 Servlet 的 安全 与 
授权 控制 。 
上 面 这 些 Annotation 有 一 些 已 经 在 前 面 有 了 详细 的 介绍 ， 此 处 不 再 熬 述 。@MultipartConfig 的 用 
法 将 会 在 2.15.4 节 有 更 详细 的 说 明 。 至 于 上 面 三 个 与 JAAS 相关 的 Annotation， 由 于 本 书 并 没有 涉及 
JAAS 方面 的 内 容 ， 因 此 请 参考 本 书 姊妹 篇 《经 典 Java EE 企业 应 用 实战 》 的 相关 章节 。 


》》>2.15.2 Servlet 3.0 的 Web 模块 支持 


Servlet 3.0 为 模块 化 开发 提供 了 良好 的 支持 ，Servlet 3.0 规范 不 再 要 求 所 有 Web 组 件 〈 如 Servlet、 
Listener、Filter 等 ) 都 部 署 在 web.xml 文件 中 ， 而 是 允许 采用 “Web 模块 ”来 部 署 、 管 理 它们 。 

一 个 Web 模块 通常 对 应 于 一 个 JAR 包 ， 这 个 JAR 包 有 如 下 文件 结构 : 

<webModule>jar 一 一 这 是 Web 模块 的 JAR 包 ， 可 以 改变 

| 一 META-INFE 

| | 一 web-fragmentxml 

| 一 Web 模块 所 用 的 类 文件 、 资 源 文件 等 。 

从 上 面 的 文件 结构 可 以 看 出 ，Web 模块 与 普通 JAR 的 最 大 区 别 在 于 需要 在 META-INF 目录 下 添 
加 一 个 web-fragment.xml 文件 ， 这 个 文件 也 被 称 为 Web 模块 部 署 描述 符 。 

web-fragment.xml 文件 与 web.xml 文件 的 作用 、 文 档 结构 都 基本 相似 ， 因 为 它们 都 用 于 部 署 、 管 
理 各 种 Web 组 件 。 只 是 web-fragment.xml 用 于 部 署 、 管 理 Web 模块 而 已 ,但 web-fragment.xml 文件 可 
以 多 指定 如 下 两 个 元 素 。 

> ”<name..…/>: 用 于 指定 该 Web 模块 的 名 称 。 

> ”<ordering.…/>; 用 于 指定 加 载 该 Web 模块 的 相对 顺序 。 

上 面 <ordering.… 记 元 素 用 于 指定 加 载 当前 Web 模块 的 相对 顺序 ,该 元 素 的 内 部 结构 如 图 2.49 所 示 。 


图 2.49 ordering 元 素 的 内 部 结构 


下 面 我 们 开发 第 一 个 Web 模块 , 该 Web 模块 内 只 定义 了 一 个 简单 的 ServletContextListner, 该 Web 
模块 对 应 的 web-fragment.xml 文件 如 下 。 
程序 清单 : codes\02\2.15\crazyit\sreIMETA-INF\web-fragment.xml 
<?xml version="1.0" encoding="GBK"?> 
<web-fragment xmlns="http://java. sun.com/xnl/ns/javaee" 
xmlns:xsi="http://ww.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
://java. sun. com/xml/ns/javaee/web-fragment. 3_0.xsd" version="3.0"> 
<!-- 指定 该 Web 模块 的 唯一 标识 --> 
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it</name> 
<listener> 
<listener-class>lee.CrazyitListener</listener-class> 
</listener> 
<ordering> 
<!-- 用 于 配置 该 Web 模块 必须 位 于 哪些 模块 之 前 加 载 --> 
<before> 
<!-- 用 于 指定 位 于 其 他 所 有 模块 之 前 加 载 --> 
<others/> 
</before> 
</ordering> 
</web-fragment> 


上 面 的 Web 模块 部 署 描述 文件 的 根 元 素 是 web-fragment， 粗 体 字 代 码 指定 该 Web 模块 的 名 称 是 
crazyiit， 接 下 来 的 粗 体 字 代 码 指定 该 Web 模块 将 在 其 他 所 有 Web 模块 之 前 加 载 。 

接 下 来 再 开发 一 个 Web 模块 ， 接 下 来 的 Web 模块 同样 只 定义 了 一 个 ServletContextListener， 该 
Web 模块 对 应 的 web-fragmentxml 文件 如 下 。 

程序 清单 : codes\02\2.15\leegang\srce\META-INF\web-fragment.xml 


<?xml version="1.0" encoding="GBK"?> 

<web-fragment xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java. sun.com/xml/ns/javaee 
http://java. sun.com/xml/ns/javaee/web-fragment_3_0.xsd" version="3.0"> 
<!-- 指定 该 web 模块 的 唯一 标识 --> 


<name>leegang</name> 

<!-- 配置 Listener -> 

<listener> 
<listener-class>lee.LeegangListener</listener-class> 

</listener> 

<ordering> 


<!-- 用 于 配置 该 Web 模块 必须 位 于 哪些 模块 之 后 加 载 --> 
<after> 


<!-- 此 处 可 用 多 个 name 元 素 列 出 
该 模块 必须 位 于 这 些 模块 之 后 加 载 --> 
<name>crazyit</name> 
</after> 
</ordering> 
</web-fragment> 


将 这 两 个 Web 模块 打包 成 JAR 包 ，Web 模块 JAR 包 的 内 部 结构 如 图 2.50 所 示 。 

将 这 两 个 Web 模块 对 应 的 JAR 包 复 制 到 任意 Web 应 用 的 WEB-INF/lib 目录 下 ， 启 动 Web 应 用 ， 
将 可 以 看 到 两 个 Web 模块 被 加 载 ， 先 加 载 crazyit 模块 ， 再 加 载 leegang 模块 。 

Web 应 用 除了 可 按 web-fragment.xml 文件 中 指定 的 加 载 顺 序 来 加 载 Web 模块 之 外 ， 还 可 以 通过 
web.xml 文件 指定 各 Web 模块 加 载 的 绝对 顺序 。 在 web.xml 文件 中 指定 的 加 载 顺 序 将 会 禾 盖 Web 模块 
中 web-fragment.xml 文件 所 指定 的 加 载 顺 序 。 


图 2.50 ”Web 模块 的 内 部 结构 


例如 我 们 在 Web 应 用 的 web.xml 文件 中 增加 如 下 配置 片段 : 
<absolute-ordering> 


<!- 指定 Web 模块 按 如 下 顺序 加 载 “一 > 
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<name>leegang</name> 
<name>crazyit</name> 
</absolute-ordering> 


上 面 的 配置 片段 指定 了 先 加 载 leegang 模块 ， 后 加 载 crazyit 模块 ， 如 果 重 新 启动 该 Web 应 用 ， 将 
可 看 到 leegang 模块 被 优先 加 载 。 

Servlet 3.0 的 Web 模块 支持 为 模块 化 开发 、 框 架 使 用 提供 了 巨大 的 方便 , 例如 需要 在 Web 应 用 中 
使 用 Web 框架 ， 这 就 只 要 将 该 框架 的 JAR 包 复 制 到 Web 应 用 中 即 可 。 因 为 这 个 JAR 包 的 META-INF 
目录 下 可 以 通过 web-fragment.xml 文件 来 配置 该 框架 所 需 的 Servlet、Listener、Filter 等 ， 从 而 避免 修 
改 Web 应 用 的 web.xml 文件 。Web 模块 支持 对 于 模块 化 开发 也 有 很 大 的 帮助 ， 开 发 者 可 以 将 不 同 模块 
的 Web 组 件 部 署 在 不 同 的 web-fragment.xml 文件 中 ， 从 而 避免 所 有 模块 的 配置 、 部 署 信息 都 写 在 
web.xml 文件 中 ， 这 对 以 后 的 升级 、 维 护 将 更 加 方便 。 


>>2.15.3 Servlet 3.0 提供 的 异步 处 理 


在 以 前 的 Servlet 规范 中 ， 如 果 Servlet 作为 控制 器 调用 了 一 个 耗 时 的 业务 方法 ， 那 么 Servlet 必须 
等 到 业务 方法 完全 返回 之 后 才 会 生成 响应 ， 这 将 使 得 Servlet 对 业务 方法 的 调用 变 成 一 种 阻塞 式 的 调 
用 ， 因 此 效率 比较 低 。 

Servlet 3.0 规范 引入 了 异步 处 理 来 解决 这 个 问题 ， 异 步 处 理 允许 Servlet 重新 发 起 一 条 新 线程 去 调 
用 耗 时 的 业务 方法 ， 这 样 就 可 避免 等 待 。 

Servlet 3.0 的 异步 处 理 是 通过 AsyncContext 类 来 处 理 的 , Servlet 可 通过 ServletRequest 的 如 下 两 个 
方法 开启 异步 调用 、 创 建 AsyncContext 对 象 ; 

> AsyncContext startAsync() 

> AsyncContext startAsync(ServletRequest, ServletResponse) 

重复 调用 上 面 的 方法 将 得 到 同一 个 AsyncContext 对 象 .AsyncContext 对 象 代表 异步 处 理 的 上 下 文 ， 
它 提供 了 一 些 工具 方法 ， 可 完成 设置 异步 调用 的 超时 时 长 ，dispatch 用 于 请 求 、 启 动 后 台 线程 、 获 取 
request、response 对 象 等 功能 。 

下 面 是 一 个 进行 异步 处 理 的 Servlet 类 。 

程序 清单 :codes\02\2.15\servlet3\WEB-INF\src\lee\AsyncServlet.java 


QWebservlet (urlpatterns="/async", asyncSupported=true) 
public class AsyncServlet extends HttpServlet 
{ 
QOverride 
public void doGet (BttpServletRequest request 
, HttpServletResponse response) throws IOExceptiony ServletException 
{ 
response. setContentType ("text/html; charset-GBK") ; NE 
PrintWriter out = response.getWriter(); 
out .println ("<title> 异 步调 用 示例 </title>"); 
out .println(" 进 入 Servlet 的 时 间 : " 
+ new java.util.Date() + ".<br/2"); 
out .flush()7 
// 创 建 asyncContext， 开 始 异 步调 用 
AsyncContext actx = request.startRsync() ; 
// 设 置 异步 调用 的 超时 时 长 
actx. setTimeout (30*1000) ; 
// 启 动 异步 调用 的 线程 
actx.start (new Executor (actx)); 
out .println ("结束 Servlet 的 时 间 : " 
+ new java.util.Date() + ".<br/>"); 
out. flush()? 
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上 面 的 Servlet 类 中 粗 体 字 代码 创建 了 AsyncContext 对 象 ， 并 通过 该 对 象 以 异步 方式 启动 了 一 条 
后 台 线 程 。 该 线程 执行 体 模拟 调用 耗 时 的 业务 方法 ， 下 面 是 线程 执行 体 的 代码 。 
程序 清单 ，codes\02\2.15\servlet3\WEB-INF\srclee\Executorjava 


public class Executor implements Runnable 
{ 
private RsyncContext actx = null; 
public Executor (AsyncContext actx) 
{ 


this.actx = actx; 


} 
public void run() 
{ 
try 
{ 
// 等 待 5 秒 钟 ， 以 模拟 业务 方法 的 执行 
Thread. sleep(5 * 1000); 
ServletRequest request ~ actx.getRequest(); 
List<string> books = new ArrayList<string>(); 
books.add(" 瘦 狂 Java 讲义 "); 
books.add ("经 典 Java EE 企业 应 用 实战 ") 7 
books.add(" 疯 狂 XML 讲义 ") 7 
request .setRttribute("books”，books)7 
actx.dispatch("/async.jsp"); 
} 
catch (Exception e) 
{ 
e.printstackTrace ()7 
} 
} 
} 


该 线程 执行 体内 让 线程 暂停 5 秒 来 模拟 调用 耗 时 的 业务 方法 ， 最 后 调用 AsyncContext 的 dispatch 
方法 把 请 求 dispatch 到 指定 JSP 页 面 。 

被 异步 请 求 dispatch 的 目标 页 面 需要 指定 session="false"， 表 明 该 页 面 不 会 重新 创建 session。 下 面 
是 asyncjsp 页 面 的 代码 。 

程序 清单 ， codes\02\2.1S\servlet3\vasyncjsp 


<¥@ page contentType="text/html; charset=GBK" language="java" 
session="false"s> 

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" > 

<ul> 

<c:forgach items="${books}" var="book"> 
<1li>${book}</1i> 

</c:forgach> 

</ul> 

<sout .println ("业务 调用 结束 的 时 间 : ”+ new java.util.Date()); 

// 完 成 异步 调用 

request .getAsyncContext () .complete() ;$> 


上 面 的 页 面 只 是 一 个 普通 JSP 页 面 ， 只 是 使 用 了 JSTL 标签 库 来 办 代 输出 books 集合 ， 因 此 读者 
需要 将 JSTL 的 两 个 JAR 包 复 制 到 Web 应 用 的 WEB-INFVlib 路 径 下 。 

对 于 希望 启用 异步 调用 的 Servlet 而 言 ， 开 发 者 必须 显 式 指定 开启 异步 调用 ， 为 Servilet 开启 异步 
调用 有 两 种 方式 : 

> ”为 @WebServlet 指定 asyncSupported=true- 

> ”在 web.xml 文件 的 <servlet.../> 元 素 中 增加 <async-supported.../> 子 元 素 。 

例如 希望 开启 上 面 Servilet 的 异步 调用 可 通过 如 下 配置 片段 : 


<servlet> 
<servlet-name>async</servlet-name> 
<servlet-class>lee.AsyncServlet</servlet-class> 


<!-- 开启 异步 调用 支持 --> 
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<async-supported>true</async-supported> 
</servlet> 
<servlet-mapping> 
<servlet-name>async</servlet-name> 
<url-pattern>/async</url-pattern> 
</servlet-mapping> 
对 于 支持 异步 调用 的 Servlet 来 说 ， 当 Servlet 以 异步 方式 启用 新 线程 之 后 ， 该 Servlet 的 执行 不 会 
被 阻塞 ， 该 Servlet 将 可 以 向 客户 端 浏览 器 生成 响应 一 一 当 新 线程 执行 完成 后 ， 新 线程 生成 的 响应 再 次 
被 送 往 客户 端 浏 览 器 。 


通过 浏览 器 访问 上 面 的 Servlet 将 看 到 如 图 2.51 所 示 的 页 面 。 


:59 CST 2010, 
59 CST 2010. 


图 2.51 启用 异步 调用 的 Servlet 


当 Servlet 启用 异步 调用 的 线程 之 后 ， 该 线程 的 执行 过 程 对 开发 者 是 透明 的 。 但 在 有 些 情况 下 ， 开 
发 者 需要 了 解 该 异步 线程 的 执行 细节 , 并 针对 特定 的 执行 结果 进行 针对 性 处 理 , 这 可 借助 于 Servlet 3.0 
提供 的 异步 监听 器 来 实现 。 
异步 监听 器 需要 实现 AsyncListener 接口 ， 实 现 该 接口 的 监听 器 类 需要 实现 如 下 4 个 方法 。 
> onStartAsync(AsyncEvent event): 当 异 步调 用 开始 时 触发 该 方法 。 
> onComplete(AsyncEvent event): 当 异 步调 用 完成 时 触发 该 方法 。 
> onError(AsyncEvent event): 当 异 步调 用 出 错时 触发 该 方法 。 
> ”onTimeout(AsyncEvent event): 当 异 步调 用 超时 时 触发 该 方法 。 
接 下 来 为 上 面 的 异步 调用 定义 如 下 监听 器 类 。 
程序 清单 : codes\02W2.15\servlet3\WWEB-INF\src\lee\MyAsyncListenerjava 
public class MyAsyncListener 
implements RsyncListener 
, public void onComplete (AsyncEvent event) 
throws IOException 
System.out.println("------| -异步 调用 完成 --- 一 -”+ new Date())7 
Ri void onError (AsyncEvent event) 
throws IOException 
void onstartAsync (RsyncEvent event) 
throws IOException 
{ 
System.out .printin("------ 异 步调 用 开始 ------" + new Date()); 
放款 void onTimeout (AsyncEvent event) i > 
throws IOException 
人 
} 


上 面 实现 的 异步 监听 器 类 只 实现 了 onStartAsync、onComplete 两 个 方法 ， 表 明 该 监听 器 只 能 监听 
异步 调用 开始 、 异 步调 用 完成 两 个 事件 。 提 供 了 异步 监听 器 之 后 ， 还 需要 通过 AsyncContext 来 注册 监 
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听 器 ， 调 用 该 对 象 的 addListener( 方 法 即 可 注册 监听 器 。 例 如 在 上 面 的 Servlet 中 增加 如 下 代码 即 可 注 
册 监 听 器 : 


RsyncContext actx = request.startAsync(); 


// 为 该 异步 调用 注册 监听 器 
actx .addListener (new MyAsyncListener ()) ; 


一 旦 通过 上 面 的 粗 体 字 代码 为 异步 调用 注册 了 监听 器 之 后 ， 接 下 来 的 异步 调用 过 程 将 会 不 断 地 触 
发 该 监听 器 的 不 同方 法 。 

Aa 提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 

虽然 上 面 的 MyAsyncListener 监听 器 类 可 以 监听 异步 调用 开始 、 异 步调 用 完成 两 个 事 ， 

件 ， 但 从 实际 运行 的 结果 来 看 ， 它 并 不 能 监听 到 异步 调用 开始 事件 ， 这 可 能 是 因为 注册 该 | 

| 。 监听 器 时 异步 调用 已 经 开始 了 的 缘故 。 J 

需要 指出 的 是 , 虽然 上 面 介绍 的 例子 都 是 基于 Servlet 的 , 但 由 于 Filter 与 Servlet 具有 很 大 的 相似 

性 , 因此 Servlet 3.0 规范 完全 支持 在 Filter 中 使 用 异步 调用 。 在 Filter 中 进行 异步 调用 与 在 Servlet 中 进 
行 异步 调用 的 效果 完全 相似 ， 故 此 处 不 再 袭 述 。 


>》》>2.15.4 改进 的 Servlet API 


Servlet 3.0 还 有 一 个 改变 是 改进 了 部 分 API， 这 种 改进 很 好 地 简化 了 Java Web 开发 。 其 中 两 个 较 
大 的 改进 是 : 
> ”HttpServletRequest 增加 了 对 文件 上 传 的 支持 。 
> ”ServletContext 允许 通过 编程 的 方式 动态 注册 Servlet、Filter。 
HttpServletRequest 提供 了 如 下 两 个 方法 来 处 理 文件 上 传 。 
> ”Part getPart(String name): 根据 名 称 来 获取 文件 上 传 域 。 
> ”Collection<Part> getParts(): 获取 所 有 的 文件 上 传 域 。 
上 面 两 个 方法 的 返回 值 都 涉及 一 个 API: Part， 每 个 Part 对 象 对 应 于 一 个 文件 上 传 域 ， 该 对 象 提 
供 了 大 量 方法 来 访问 上 传 文件 的 文件 类 型 、 大 小 、 输 入 流 等 ， 并 提供 了 一 个 write(String file) 方 法 将 上 
传 文件 写 入 服务 器 磁盘 。 
为 了 向 服务 器 上 传 文件 ， 需 要 在 表单 里 使 用 <input type="file" …/> 文 件 域 ， 这 个 文件 域 会 在 HTML 
页 面 上 产生 一 个 单行 文本 框 和 一 个 “浏览 ”按钮 ， 浏 览 者 可 通过 该 按钮 选择 需要 上 传 的 文件 。 除 此 之 
外 ， 上 传 文件 一 定 要 为 表单 域 设置 enctype 属性 。 
表单 的 enctype 属性 指定 的 是 表单 数据 的 编码 方式 ， 该 属性 有 如 下 三 个 值 。 
> ”application/x-www-form-urlencoded: 这 是 默认 的 编码 方式 ， 它 只 处 理 表单 域 里 的 value 属 
性 值 ， 采 用 这 种 编码 方式 的 表单 会 将 表单 域 的 值 处 理 成 URL 编码 方式 。 
> ”multipart/form-data: 这 种 编码 方式 会 以 二 进 制 流 的 方式 来 处 理 表单 数据 ,这 种 编码 方式 会 把 
文件 域 指定 文件 的 内 容 也 封装 到 请 求 参 数 里 。 
> text/plain: 这 种 编码 方式 当 表单 的 action 属性 为 mailto:URL 的 形式 时 比较 方便 ， 这 种 方式 
主要 适用 于 直接 通过 表单 发 送 邮件 的 方式 。 
如 果 将 enctype 设置 为 application/x-www-form-urlencoded， 或 不 设置 enctype 属性 ， 提 交 表 单 时 只 
会 发 送 文件 域 的 文本 框 里 的 字符 串 ， 也 就 是 浏览 者 所 选择 文件 的 绝对 路 径 ， 对 服务 器 获取 该 文件 在 客 
户 端 上 的 绝对 路 径 没有 任何 作用 ， 因 为 服务 器 不 可 能 访问 客户 机 的 文件 系统 。 
下 面 定义 了 一 个 文件 上 传 的 页 面 。 
程序 清单 ，codes\02\2.15\servlet3wuploadjsp 
<Se page contentType="text/html; charset=GBK" language="java" errorPage="" #> 
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<1DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1:0 Transitional//EN" 
“http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 

‘<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 
<title> 文件 上 传 </title> 

</head> 

<body> 

<form method="post" action="upload" enctype="multipart/form-data"> 
文件 名 : <input type="text" id="name" name="name" /><br/> 
选择 文件 ; <input type="file" id="file" name="file" /><br/> 
<input type="submit” value=" 上 传 ”/><br/> 

</form> 

</body> 

</html> 


上 面 的 页 面 中 的 表单 需要 设置 enctype="multipart/form-data"， 这 表明 该 表单 可 用 于 上 传 文件 。 上 
面 的 表单 中 定义 了 两 个 表单 域 : 一 个 普通 的 文本 框 ， 它 将 生成 普通 请 求 参 数 ， 一 个 文件 上 传 域 ， 它 用 
于 上 传 文件 。 

对 于 传统 的 文件 上 传 需要 借助 于 common-fileupload 等 工具 , 处 理 起 来 极为 复杂 , 借助 于 Servlet 3.0 
的 API， 处 理 文件 上 传 将 变 得 十 分 简单 。 看 下 面 的 Servlet 类 代码 。 

程序 清单 : codes\02\2.15\servlet3\WWEB-INF\src\lee\UploadServlet.java 


@Webservlet (name="upload" , urlPatterns={"/upload"}) 
QMultipartConfig 
public class UploadServlet extends HttpServlet 
{ 
public void service(HttpServletRequest request , 
HttpServletResponse response) 
throws IOException , ServletException 
response. setContentType ("text/html; charset=GBK") ; 
PrintWriter out = response.getWriter(); 
// 获 取 普 通 请 求 参数 
String fileName = request.getParameter ("name") ; 
// 获 取 文 件 上 传 域 i 
Part part = request.getPart ("file"); 
// 获 取 上 传 文件 的 类 型 
out ,Println (" 上 传 文件 的 类 型 为 :” 
+ part.getContentType() + "<br/>"); 
// 获 取 上 传 文件 的 大 小 
out .println ("上 传 文件 的 的 大 小 为 :" 
+ part.getSize() + "<br/>"); 
// 获 取 该 文件 上 传 域 的 Header Name 
Collection<string> headerNames ~ part.getHeaderNames(); 
// 遍 历 文件 上 传 域 的 Header Name、Value 
for (String headerName : headerNames) 
{ 


out.println{headerName + "--->" 
+ part.getHeader (headerName) + "<br/>"); 


} 
// 将 上 传 的 文件 写 入 服务 器 


} 
上 面 Servlet 使 用 了 @MultipartConfig 修饰 ， 处 理 文件 上 传 的 Servlet 应 该 使 用 该 Annotation 修饰 。 
接 下 来 该 Servlet 中 HttpServletRequest 就 可 通过 getPart(String name) 方 法 来 获取 文件 上 传 域 一 一 就 像 获 
取 普 通 请 求 参 数 一 样 。 


二 提 
与 Servlet 3.0 所 有 Annotation 相似 的 是 ，Servlet 3.0 为 @ 提 供 了 相似 的 配置 元 素 ， 我 们 ， 
同样 可 以 通过 在 <servlet- 人 元 素 中 尖 加 cultpareonfg -人 于 元 素来 达到 相同 的 效果 | 
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获取 了 上 传 文件 对 应 的 Part 之 后 ,- 可 以 非常 简单 地 将 文件 写 入 服务 器 磁盘 ， 如 上 面 的 四 号 代码 所 
示 。 当 然 也 可 以 通过 Part 获取 所 上 传 文件 的 文件 类 型 、 文 件 大 小 等 各 种 详细 信息 。 
例如 我 们 选择 一 个 *.png 图 片 ， 然 后 单 击 上 传 将 可 看 到 如 图 2.52 所 示 页 面 。 


文件 的 的 燃 型 为 ，iateypat 
上 上 寿 文 的 的 大 小 为 ，173845 
上 
Cat os Hm rn data, nome=file”, filenmme="NH. pe” 


图 2.52 使 用 Servlet 3.0API 上 传 文件 


上 面 的 Servlet 中 将 会 把 上 传 的 文件 保存 到 Web 应 用 的 根 路 径 下 的 uploadFiles 目录 下 ， 因 此 读者 

还 应 该 在 Web 应 用 的 根 路 径 下 创建 uploadFiles 目录 。 
.和 尖 - 注 是 : 半 … 
上 面 Servlet 上 传 时 保存 的 文件 名 直接 使 用 了 na name 请 求 参数 ， 实 际 项 目 中 一 般 不 会 
这 么 做 ， 因 为 可 能 多 个 用 户 会 填写 相同 的 name 参数 ， 这 样 将 导致 后 面 用 户 上 传 的 文件 证 


覆 瘟 前 面 用 户 上 传 的 图 片 。 实际 项 目 中 可 借助 于 javautil UUID 于 并 六 件 帮 。 


ServletContext 则 提供 了 如 下 方法 来 动态 地 注册 Servet、 
化 参数 。 

> ”多 个 重 载 的 addServlet: 动态 地 注册 Serviet。 

> “多 个 重 载 的 addFitter: 动态 地 注册 Filter。 

> ”多 个 重 载 的 addListener: 动态 地 注册 Listener。 

> setlnitParameter(String name, String value): 为 Web 应 用 设置 初始 化 参数 。 


lter， 并 允许 动态 设置 Web 应 用 的 初始 


2.16 本章 小 结 


本 章 系统 介绍 了 Java Web 编程 的 相关 知识 : JSP、Servlet、Listener、Filter 等 。 本 章 炸 盖 了 JSP 所 
有 知识 点 ， 包 括 JSP 的 3 个 编译 指令 、7 个 动作 指令 、9 个 内 置 对 象 ， 详 细 介 绍 了 Java Web 编程 所 涉 
及 的 Servlet、Listener 和 Filter 的 使 用 ， 还 详细 介绍 了 JSP 2 自 定义 标签 库 开发 步骤 及 标签 库 的 用 法 ， 
包括 简单 标签 、 带 属性 标签 和 和 迭 代 器 标签 等 。 本 章 也 全 面 讲解 了 JSP 2 所 支持 的 配置 JSP 属性、 表达 
式 语言 和 Tag File 标签 支持 等 内 容 。 除 此 之 外 , 还 重点 介绍 了 Servlet 3.0 新 规范 带 来 的 巨大 改变 : Servlet、 
Listener、Filter 不 需要 通过 web.xml 进行 配置 ， 只 需 通过 Annotation 修饰 即 可 。Servlet 3.0 带 来 的 Web 
模块 支持 、 改 进 的 Servlet API 都 给 Web 开发 带 来 很 大 方便 ， 值 得 掌握 。 

本 章 内 容 是 轻 量 级 Java EE 和 经 典 Java EE 都 需要 的 表现 层 技 术 ， 因 此 非常 重要 。 
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本 章 要 点 


Model 1 和 Model 2 

基 MVC 思想 的 概念 和 优势 

好 使 用 Eclipse 开发 Struts 2 应 用 

和 Struts 2 框架 的 基本 流程 S 

入 配置 Stmts 2 常量 eR 
和 实现 逻辑 控制 器 Action 0 
节 包 和 命名 空间 的 配置 和 和 

划 深 入 掌握 Action 的 配置 

人 Stmuts 2 支持 的 视图 类 型 

苗 为 逻辑 视图 配置 物理 视图 资源 ha 
配置 Struts 2 的 异常 处 理 流程 i 
总 Struts 2 的 Convention 插件 和 “约定 ”支持 
SiStmuts 2 的 国际 化 

人 Stmuts 2 标签 库 入 门 

划 OGNL 表达 式 语言 的 功能 和 用 法 。 ‘ 

他 控 制 标签 的 用 法 

节 数 据 标签 的 用 法 

他 表单 标签 的 用 法 

节 非 表单 标签 的 用 法 
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Struts 2 由 传统 的 Struts 1、WebWork 两 个 经 典 MVC 框架 发 展 起 来 , 无 论 是 从 Struts 2 设计 的 角度 来 
看 ,还 是 从 Struts 2 在 实际 项 目 中 的 易 用 性 来 看 , Struts 2 都 是 一 个 非常 优秀 的 MVC 框架 .与 传统 的 Struts1 
相 比 ，Struts 2 允许 使 用 普通 的 、 传 统 的 Java 对 象 作为 Action; Action 的 execute() 方 法 不 再 与 Servlet API 
看 合 ， 因 而 更 易 测试 ， 支 持 更 多 的 视图 技术 ; 基于 AOP 思想 的 拦截 器 机 制 ， 提 供 了 极 好 的 可 扩展 性 ; 
更 强大 、 更 易 用 的 输入 校 验 功能 ， 整 合 的 Ajax 支持 等 ， 这 些 都 是 Struts 2 的 巨大 吸引 力 。 

时 至 今日 ，Struts 2 已 经 发 布 了 Struts 2.2.1 GA 版 本 ， 这 也 是 Struts 2 发 展 史上 的 一 次 重要 升级 。 
本 章 将 详细 介绍 Struts 2 框架 的 基本 用 法 ， 从 Struts 2 入 门 开始 介绍 ， 引 导读 者 了 解 Struts 2 框架 的 运 
行 流程 ， 然 后 详细 介绍 Struts 2 配置 文件 的 相关 细节 。 

本 章 还 会 重点 介绍 Struts 2 的 异常 处 理 机 制 、Struts 2 的 程序 国际 化 、Struts 2 标签 库 的 用 法 3 个 知 
识 点 。 本 章 的 内 容 和 《Struts 2.1 权威 指南 》 可 能 有 部 分 重合， 但 也 可 能 有 少数 内 容 互相 冲突 ， 这 是 因 
为 Struts 2 版 本 升级 的 缘故 ， 如 果 读者 使 用 Struts 2.2 则 以 本 书 为 准 。 


3.1 MVC 思想 概述 


正如 上 一 章 所 介绍 的 ， 随 着 应 用 系统 的 逐渐 增 大 ， 系 统 的 业务 逻辑 复杂 度 将 以 几何 级 数 的 方式 增 
长 。 在 这 种 情况 下 ， 如 果 我 们 依然 把 所 有 的 处 理 逻 辑 都 放 在 JSP 页 面 中 ， 那 将 成 为 一 场 吐 梦 ， 无 论 我 
们 要 进行 怎样 的 改变 ， 都 必须 打开 那些 丑陋 的 JSP 脚本 进行 修改 。 

MVC 思想 将 应 用 中 各 组 件 按 功 能 进行 分 类 ， 不 同 的 组 件 使 用 不 同 技术 充当 ， 甚 至 推荐 了 严格 分 
层 , 不 同 组 件 被 严格 限制 在 其 所 在 层 内 ， 各 层 之 间 以 松 耦 合 的 方式 组 织 在 一 起 ,从 而 提供 良好 的 封装 。 


》》3.1.1 传统 Model1 和 Model2 


Java Web 应 用 的 结构 经 历 了 Model 1 和 Model 2 两 个 时 代 ， 从 Model 1 发 展 到 Model 2 既是 技术 
发 展 的 必然 ， 也 是 无 数 程序 员 的 心血 结晶 。 

在 Model 1 模式 下 ， 整 个 Web 应 用 几乎 全 部 由 JSP 页 面 组 成 ，JSP 页 面 接收 处 理 客户 端 请 求 ， 对 
请 求 处 理 后 直接 做 出 响应 。 用 少量 的 JavaBean 来 处 理 数据 库 连 接 、 数 据 库 访 问 等 操作 。 

Model 1 模式 的 实现 比较 简单 ， 适 用 于 快速 开发 小 规模 项 目 。 但 从 工程 化 的 角度 看 ， 它 的 局 限 性 
非常 明显 ，JSP 页 面 身 兼 View 和 Controller 两 种 角色 ， 将 控制 逻辑 和 表现 逻辑 混杂 在 一 起 ， 从 而 导致 
代码 的 重用 性 非常 低 ， 增 加 了 应 用 的 扩展 性 和 维护 的 难度 。 

早期 由 大 量 JSP 页 面 所 开发 出 来 的 Web 应 用 ， 大 都 采用 了 Model 1 架构 。 实 际 上 ， 早 期 绝 大 部 分 
ASP 应 用 也 属于 这 种 Model 1 的 架构 。 

Model 2 已 经 是 基于 MVC 架构 的 设计 模式 。 在 Model 2 架构 中 ，Servlet 作为 前 端 控制 器 ， 负 责 接 
收 客户 端 发 送 的 请 求 ， 在 Servlet 中 只 包含 控制 逻辑 和 简单 的 前 端 处 理 ， 然 后 ， 调 用 后 端 JavaBean 来 
完成 实际 的 逻辑 处 理 ， 最后， 转发 到 相应 的 JSP 页 面 处 理 显示 逻辑 。 其 具体 的 实现 方式 如 图 3.1 所 示 。 


图 3.1 Model 2 的 流程 
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正如 在 图 3.1 中 看 到 的 ，Model 2 下 JSP 不 再 承担 控制 器 的 责任 ， 它 仅仅 是 表现 层 角 色 ， 仅 仅 用 于 
将 结果 呈现 给 用 户 , JSP 页 面 的 请 求 与 Servlet (控制 器 ) 交互 , 而 Servlet 负责 与 后 台 的 JavaBean 通信 。 
在 Model 2 模式 下 ,模型 (Model) 由 JavaBean 充当 ,视图 (View) 由 JSP 页面 充当 , 而 控制 器 (Controller) 
则 由 Servlet 充当 。 

由 于 引入 了 MVC 模式 ， 使 Model 2 具有 组 件 化 的 特点 ， 更 适用 于 大 规模 应 用 的 开发 ， 但 也 增加 
了 应 用 开发 的 复杂 程度 。 原 本 需要 一 个 简单 的 JSP 页 面 就 能 实现 的 应 用 ， 在 Model 2 中 被 分 解 成 多 个 
协同 工作 的 部 分 ， 需 花 更 多 时 间 才能 真正 掌握 其 设计 和 实现 过 程 。 

2 已 经 是 MVC 设计 思想 下 的 架构 ， 下 面 简要 介绍 MVC 设计 思想 的 优势 。 


天- 汪 ， 3 
对 于 非常 小 型 的 Web 站 点 ,如 果 后 期 的 更 新 、 维 护 工作 不 是 特别 大 , 可 以 使 用 Model 

1 的 模式 来 开发 应 用 ， 而 不 是 使 用 Model 2 的 模式 . 虽然 Model 2 提供 了 更 好 的 可 扩展 性 。 | 

及 可 维护 性 ， 但 增加 了 前 期 开发 成 本 。 从 某 种 程度 上 讲 ，Model 2 为 了 降低 系统 后 期 维 3 


护 的 复杂 度 ， 却 导致 前 期 开发 的 更 高 复杂 度 。 


>>3.1.2 MVC 思想 及 其 优势 


MYVC 并 不 是 Java 语言 所 特有 的 设计 思想 ， 也 并 不 是 Web 应 用 所 特有 的 思想 ， 它 是 所 有 面向 对 象 
程序 设计 语言 都 应 该 遵守 的 规范 。 

MVC 思想 将 一 个 应 用 分 成 三 个 基本 部 分 : Model (模型 )、View (视图 ) 和 Controller (控制 器 )， 
这 三 个 部 分 以 最 少 的 耦合 协同 工作 ， 从 而 提高 应 用 的 可 扩展 性 及 可 维护 性 。 

在 经 典 的 MVC 模式 中 ， 事 件 由 控制 器 处 理 ， 控 制 器 根据 事件 的 类 型 改变 模型 或 视图 ， 反 之 亦 然 。 
具体 地 说 ， 每 个 模型 对 应 一 系列 的 视图 列表 ， 这 种 对 应 关系 通常 采用 注册 来 完成 ， 即 ， 把 多 个 视图 注 
册 到 同一 个 模型 ， 当 模型 发 生 改变 时 ， 模 型 向 所 有 注册 过 的 视图 发 送 通知 ， 接 下 来 ， 视 图 从 对 应 的 模 
型 中 获得 信息 ， 然 后 完成 视图 显示 的 更 新 。 

从 设计 模式 的 角度 来 看 ，MVC 思想 非常 类 似 于 观察 者 模式 ， 但 与 观察 者 模式 存在 少许 差别 观 
察 者 模式 下 观察 者 和 被 观察 者 可 以 是 两 个 互相 对 等 的 对 象 ， 但 对 于 MVC 思想 而 言 ， 被 观察 者 往往 只 
是 单纯 的 数据 体 ， 而 观察 者 则 是 单纯 的 视图 页 面 。 

概括 起 来 ，MVC 有 如 下 特点 。 

> 多 个 视图 可 以 对 应 一 个 模型 。 按 MVC 设计 模式 ， 一 个 模型 对 应 多 个 视图 ， 可 以 减少 代码 的 

复制 及 代码 的 维护 量 ， 一 旦 模型 发 生 改变 ， 也 易于 维护 。 

> ”模型 返回 的 数据 与 显示 逻辑 分 离 。 模 型 数据 可 以 应 用 任何 的 显示 技术 , 例如 , 使 用 JSP 页 面 、 

Velocity 模板 或 者 直接 产生 Excel 文档 等 。 

> ”应 用 被 分 隔 为 三 层 ， 降 低 了 各 层 之 间 的 耦合 ， 提 供 了 应 用 的 可 扩展 性 。 

> 控制 层 的 概念 也 很 有 效 ， 由 于 它 把 不 同 的 模型 和 不 同 的 视图 组 合 在 一 起 ， 完 成 不 同 的 请 求 。 

因此 ， 控 制 层 可 以 说 是 包含 了 用 户 请 求 权限 的 概念 。 

> ”MVC 更 符合 软件 工程 化 管理 的 精神 。 不 同 的 层 各 司 其 职 , 每 一 层 的 组 件 具 有 相同 的 特征 ， 有 

利于 通过 工程 化 和 工具 化 产生 管理 程序 代码 。 

相对 于 早期 的 MVC 思想 ，Web 模式 下 的 MVC 思想 则 又 存在 一 些 变化 ， 因 为 对 于 一 个 应 用 程序 
而 言 ， 我 们 可 以 将 视图 注册 给 模型 ， 当 模型 数据 发 生 改 变 时 ， 即 时 通知 视图 页 面 发 生 改 变 ; 而 对 于 
Web 应 用 而 言 ， 即 使 将 多 个 JSP 页 面 注册 给 一 个 模型 ， 当 模型 发 生变 化 时 ， 模 型 无 法 主动 发 送 消息 给 
JSP 页 面 〈 因 为 Web 应 用 都 是 基于 请 求 /响应 模式 的 )， 只 有 当 用 户 请 求 浏览 该 页 面 时 ， 控 制 器 才 负 责 
调用 模型 数据 来 更 新 JSP 页 面 。 图 3.2 显示 了 遵循 MVC 模式 的 Java Web 的 运行 流程 。 
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调用 Modety7 


视图 页 面 
图 3.2 遵循 MVC 模式 的 Java Web 运行 流程 


MVC 思想 与 观察 者 模式 有 一 定 的 相似 之 处 ,但 并 不 完全 : 
Web 应 用 的 MVC 思想 也 存在 一 定 的 差别 ， 引 起 差别 的 主要 原因 是 因为 Web 应 用 是 一 种 


经 典 的 MVC 思想 与 


动 更 新 自己 ， 


| 
| 
| 请求 /响应 模式 下 应 用 ， 对 于 请 求 /的 应 应 用 ， 如 果 用 户 不 对 应 用 发 出 请 求 ， 视 图 无 法 主 可 
| 
| 


3.2 Struts 2 的 下 载 和 安装 


前 面 我 们 已 经 介绍 了 如 何 手动 建立 Web 应 用 ， 也 介绍 了 如 何在 Eclipse 中 建立 Web 应 用 ， 下 面 主 
要 介绍 如 何 为 Web 应 用 增加 Struts 2 支持 。 


》》3.2.1 为 Web 应 用 增加 Struts 2 支持 


本 书 成 书 之 时 ，Struts 2 的 最 新 版 是 2.2.1 GA 版 ， 本 书 所 介绍 的 Struts 2 就 是 基于 该 版 本 的 ， 建 议 
读者 也 下 载 该 版 本 的 Struts 2。 
下 载 和 安装 Struts 2 请 按 如 下 步骤 进行 。 
人 登录 http://struts.apache.org/download.cgi 站 点 ， 下 载 Struts 2 的 最 新 版 。 下 载 Struts 2 时 有 如 下 
几 个 选项 。 
> ”Full Distribution 下 载 Struts 2 的 完整 版 ， 通 常 建议 下 载 该 选项 ， 该 选项 包括 Struts 2 的 示 
例 应 用 、 空 示例 应 用 、 核 心 库 、 源 代码 和 文档 等 。 
> “Example Applications: 仅 下 载 Struts 2 的 示例 应 用 ,这些 示例 应 用 对 于 学 习 Struts 2 有 很 大 
的 帮助 ， 下 载 Struts 2 的 完整 版 时 已 经 包含 了 该 选项 下 的 全 部 应 用 。 
> ”Essential Dependencies: 仅 下 载 Struts 2 的 核心 库 ， 下 载 Struts 2 的 完整 版 时 将 包括 该 选 
项 下 的 全 部 内 容 。 
> ”Documentation: 仅 下 载 Struts 2 的 相关 文档 ， 包 含 Struts 2 的 使 用 文档 、 参 考 手册 和 API 
文档 等 。 下 载 Struts 2 的 完整 版 时 将 包括 该 选项 下 的 全 部 内 容 。 
> ”Source: 下 载 Struts 2 的 全 部 源 代 码 , 下 载 Struts 2 的 完整 版 时 将 包括 该 选项 下 的 全 部 内 容 。 
通常 建议 读者 下 载 第 一 个 选项 ， 即 下 载 Struts 2 的 完整 版 ， 将 下 载 到 的 *.zip 文件 解压 缩 ， 该 文件 
夹 包 含 如 下 文件 结构 。 
> ”apps: 该 文件 夹 下 包含 了 基于 Struts 2 的 示例 应 用 ， 这 些 示例 应 用 对 于 学 习 者 是 非常 有 用 的 
资料 。 
> docs: 该 文件 夹 下 包含 了 Struts 2 的 相关 文档 ， 包 括 Struts 2 的 快速 入 门 、Struts 2 的 文档 ， 
以 及 API 文档 等 内 容 。 
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> ”libp: 该 文件 夹 下 包含 了 Struts 2 框架 的 核心 类 库 ， 以 及 Struts 2 的 第 三 方 插件 类 库 。 

> ”src: 该 文件 夹 下 包含 了 Struts 2 框架 的 全 部 源 代码 。 

G 将 Struts 2 的 lib 文件 夹 下 的 commons-fileupload-1.2.1jar 、commons-io-1.3.2jar 、 
freemarker-2.3.16.jar、javassist-3.7.ga.jar、ognl-3.0.jar、struts2-core-2.2.1.jar 和 xwork-core-2.2.1.jar 必需 
类 库 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 。 如 果 需 要 在 Web 应 用 中 使 用 Struts 2 的 更 多 特性 ， 则 需 
要 将 相应 的 JAR 文件 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 。 如 果 需 要 在 DOS 或 者 Shell 窗口 下 手 
动 编译 Struts 2 相关 的 程序 ， 则 还 应 该 将 struts2-core-2.2.1jar 和 xwork-core-2.2.1.jar 添加 到 系统 的 
CLASSPATH 环境 变量 里 。 


大 部 分 时 候 ， 使 用 Struts 2 的 Web 应 用 并 不 需要 利用 到 Struts 2 的 全 部 特性 ,因此 没 
有 必要 一 次 将 该 ib 路径 下 JAR 文件 全 部 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 。 

还 有 一 点 ， 可 能 有 的 读者 感到 奇怪 ，Struts 2 的 lib 目录 下 并 没有 javassist-3.7.ga.jar， 
这 个 JAR 包 是 一 个 动态 编辑 、 生 成 Java 字 节 码 的 类 库 ( 类 似 于 CGLIB, 不 过 性 能 更 好 ). 
读者 既 可 登录 http://wwwjavassist.org/ 下 载 该 JAR 包 ,也 可 在 Hibernate 3.6 的 lib\bytecode\ 
javassist 路 径 下 找到 该 JAR 包 . 可 


人 @ 编辑 Web 应 用 的 web .xml 配置 文件 , 配置 Struts 2 的 核 面 是 增加 了 Struts 2 的 核心 


Filter 配置 的 web.xml 配置 文件 的 代码 片段 。 

.0" encoding="GBK"?> 

java. sun. com/xml /ns/javaee" 
http://www.w3.org/2001/XMLSchema-instance" 


chemaLocation="http://java. sun.com/xml/ns/javaee 
web-app_3_0.xsd" version="3.0"> 


<!-- 定义 Struts 2 的 核心 Filter --> 
<filter> 
<filter-name>struts2</filter-name> 
<filter-class>org. apache. struts2.dispatcher.ng 
filter. StrutsPrepareAndExecuteFilter</filter-class> 
</filter> 


<!-- 让 Struts 2 的 核心 Filter 拦截 所 有 请 求 --> 
<filter-mapping> 
‘<filter-nane>atruts2</filter-nane> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 
</web-app> 


经 过 上 面 三 个 步骤 ， 我 们 已 经 可 以 在 一 个 Web 应 用 中 使 用 Struts 2 的 基本 功能 了 。 下 面 将 带领 读 
者 进入 Struts 2 MVC 框架 的 世界 。 

上 面 步骤 仅 完成 了 为 Web 应 用 增加 Struts 2 支持 ， 但 依然 没有 使 用 Struts 2 功能 ， 使 用 Struts 2 功 
能 至 少 需要 一 个 struts.xml 配置 文件 ， 这 个 配置 文件 默认 放 在 Web 应 用 的 类 加 载 路 径 下 〈 通 常 就 是 
WEB-INF/classes 路 径 )。 


>》>>3.2.2 在 Eclipse 中 使 用 Struts 2 


为 了 让 Web 应 用 具有 Struts 2 支持 功能 ， 必 须 将 Stmuts 2 框架 的 核心 类 库 增加 到 Web 应 用 中 。 将 
Struts 2 框架 下 lib 路 径 下 的 commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar、freemarker-2.3.16.jar、 
javassist-3.7.ga.jar 、ognl-3.0.jar、struts2-core-2.2.1.jar 和 xwork-core-2.2.1.jar 等 Struts 2 的 必需 类 库 复制 
到 Web 应 用 的 lib 路 径 下 ， 也 就 是 “%workspace%Struts2Demo\WebContent\ WEB-INF\lib” 路 径 下 。 

返回 Eclipse 的 主 界面 ， 在 Eclipse 主 界面 的 左上 角 资 源 导航 中 看 到 了 Struts2Demo 节点 ， 选 中 该 


161 


http://52pdf.taobao.com 
米 野 雏 Java EE 企业 应 用 实战 (第 3 版 ) 一 


节点 ， 然 后 按 F5 键 ， 将 看 到 Eclipse 主 界面 左上 角 资 源 导 航 中 出 现 如 图 3.3 所 示 的 界面 。 

看 到 如 图 3.3 所 示 的 界面 ,表明 该 Web 应 用 已 经 加 入 了 Struts 2 的 必需 类 库 , 但 还 需要 修改 web.xml 
==5 文件 ， 让 该 文件 负责 加 载 Struts 2 框架 。 

在 如 图 3.3 所 示 的 导航 树 中 ， 单 击 “WEB-INF” 节 点 前 的 
加 号 ， 展 开 该 节点 ， 看 到 该 节点 下 包含 的 web.xml 文件 子 节点 。 

单 击 web.xml 文件 节点 ， 编 辑 该 文件 ， 同 样 是 在 web.xml 
文件 中 定义 Struts 2 的 核心 Filter, 并 定义 该 Filter 所 拦截 的 URL 
模式 ， 与 上 一 节 所 介绍 内 容 完 全 一 样 。 至 此 ， 该 Web 应 用 完全 
具备 了 Struts 2 框架 的 支持 。 


>>》3.2.3 增加 登录 处 理 


EE 


下 面 将 为 Struts2Demo 应 用 增加 一 个 简单 的 登录 处 理 流程 ， 
通过 这 个 处 理 流程 向 读者 大 致 介绍 Struts 2 应 用 的 开发 步骤 。 

使 用 第 1 章 所 介绍 的 方式 在 Eclipse 中 添加 JSP 页 面 ， 新 加 
的 JSP 页 面 名 为 loginjsp， 在 Eclipse 中 编辑 该 页 面 ， 使 得 该 页 面 内 容 如 下 。 

程序 清单 :codes\03\3.2\Struts2Demo\WebContent\login.jsp 


<%@ page language="java" contentType="text/html; charset=GBK" 
pageEncoding="GBK"%> 


图 3.3 增加 Struts 2 支持 


<%@taglib prefix="s" uri="/struts-tags"s> 

<html> 

<head> 

<title><s:text name="loginpage"/></title> 

</head> 

<body> 

<s:form action="login"> 
<s:textfield name="username" key="user"/> 
<s:textfield name="password" key="pass"/> 
<s:submit key="login"/> 

</s:form> 

</body> 

</html> 


上 面 的 页 面 中 粗 体 字 代码 使 用 Struts 2 标签 库 定义 了 一 个 表单 和 三 个 简单 表单 域 。 关 于 Struts 2 标 
签 库 的 用 法 ， 本 书后 面 会 有 更 详细 的 介绍 ， 此 处 无 须 理会 它们 。 

本 书 第 2 章 已 经 说 过 :几乎 所 有 MVC 框架 都 会 提供 丰富 的 标签 库 ， 用 以 帮助 开发 者 更 简单 、 更 
规范 地 编写 视图 组 件 〈 通 常 就 是 JSP 页 面 )，Struts 2 也 不 例外 ，Struts 2 的 标签 库 功能 非常 强大 ， 使 用 
起 来 也 非常 简单 ， 本 章 最 后 一 节 会 详细 介绍 Struts 2 标签 库 。 

除 此 之 外 ,还 需 为 该 应 用 提供 welcome.jsp 和 errorjsp 页 面 ， 分 别 作为 登录 成 功 、 登 录 失 败 后 的 提 
示 页 面 ， 这 两 个 页 面 的 代码 非常 简单 ， 此 处 不 再 给 出 ， 在 codes\03\3.2\Struts2Demo\WebContent 路 径 下 
有 这 两 个 页 面 文件 。 

为 了 让 Struts 2 应 用 运行 起 来 ， 还 必须 为 Struts 2 框架 提供 一 个 配置 文件 : struts.xml 文件 ， 通 过 单 
击 Eclipse 的 “File” 菜 单 ， 然 后 单 击 “New” 菜 单项 的 “XML” 子 菜单 项 来 创建 一 个 XML 文件 。 该 
文件 应 该 放 在 Web 应 用 的 类 加 载 路 径 下 ， 下 面 是 该 文件 的 代码 。 

程序 清单 : codes\03\3.2\Struts2Demo\src\struts xml 


<?xml version="1.0" encoding="GBK"?> 

<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 

<!-- 指定 Struts 2 配置 文件 的 根 元 素 -> 

<struts> 
<!-- 指定 全 局 国际 化 资源 文件 --> 
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<constant name="struts.custom.ilgn.resources" value="mess"/> 


<!-- 指定 国际 化 编码 所 使 用 的 字符 集 --> 


<constant name="struts.il8n.encoding" value="GBK"/> 
</struts> 


上 面 的 配置 文件 中 粗 体 字 代 码 指定 国际 化 资源 文件 的 base 名 为 mess， 所 以 我 们 还 应 该 为 该 应 用 
提供 一 个 messa_zh_CN.properties 文件 。 

可 能 有 读者 会 感到 奇怪 : 上面 的 struts.xml 文件 怎么 没有 放 在 Web 应 用 的 类 加 载 路 径 下 ? 因为 现 
在 处 于 Eclipse 工具 管理 下 ， 当 Eclipse 生成 、 部 署 Web 项 目 时 ， 会 自动 将 src 路 径 下 除 *java 外 的 所 
有 文件 都 复制 到 Web 应 用 的 WEB-INF\classes 路 径 下 。 

下 面 编写 一 份 mess.properties 文件 ， 文 件 内 容 如 下 。 

程序 清单 : codes\03\3.2\Struts2Demo\src\mess.properties 


loginpage= 登 录 页 面 
errorPage= 错 误 页 面 
succPage= 成 功 页 面 
failTip= 对 不 起 ， 您 不 能 登录 ! 
succTip= 欢 迎 ，{0} ,您 已 经 登录 ! 
user= 用 户 名 

pass"= 密 码 

login= 登 录 


这 些 国际 化 资源 提示 信息 用 于 Struts2Demo 应 用 的 各 页 面 提供 国际 化 支持 ， 还 必须 用 native2ascii 
命令 来 处 理 该 国际 化 资源 文件 。 关 于 native2ascii 工具 的 用 法 可 以 参考 疯狂 Java 体系 的 《疯狂 Java 讲 
义 》 一 书 的 第 9 章 。 

配置 了 这 些 资源 之 后 , 我 们 就 可 以 按 第 1 章 所 介绍 的 
方式 来 部 署 Struts2Demo 应 用 了 ， 部 署 成 功 后 ， 在 浏览 器 
中 访问 刚才 的 Struts2Demo 应 用 ,将 看 到 本 应 用 登录 页 面 。 
以 Tomcat 的 端口 为 8888 为 例 , 应 该 在 浏览 器 中 访问 如 下 
地 址 : http:/localhost:8888/Struts2Demo/loginjsp， 将 看 到 
如 图 3.4 了 


注 虽 4 
| 从 Stmuts 2.1 开始 ，Struts 2 默认 不 会 列 出 Web 应 用 的 文件 列表 所 以 如 果 我 们 希望 


访问 哪个 页 面 ， 必须 直接 输入 该 页 面 的 文件 名 . 如 果 直 接 输 入 http://localhost:8888/Struts2 
Demo 将 看 到 错误 页 面 。 当 然 ， 后 面 也 会 介绍 如 何 让 Struts 2.1 列 出 应 用 下 的 所 有 页 面 。 


图 3.4 登录 页 面 


前 面 定义 login.jsp 页 面 中 登录 表单 时 指定 该 表单 的 action 为 login, 因此 我 们 还 必须 定义 一 个 Sturts 
2 的 Action，Sturts 2 的 Action 通常 应 该 继承 ActionSupport 基 类 。 
在 Eclipse 工具 中 新 建 一 个 Java 类 ， 该 Java 类 的 类 名 为 “LoginAction ”， 将 该 类 文件 保存 在 
Struts2Demo 应 用 的 src 路 径 下 的 lee 目录 下 。 该 类 代码 如 下 。 
程序 清单 ， codes\03\3.2\Struts2Demo\src\org\crazyit\app\action\LoginAction.java 
public class LoginAction extends Actionsupport 


// 定 义 封装 请 求 参数 的 username 和 password 属性 
private String username; 
private String password; 
public String getUsername() 
{ 
return username; 
public void setUsername (String username) 
{ 
this.username = username; 
! 
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public String getPassword() 
{ 
return password; 


} 
public void setPassword(String password) 
{ 

this.password = password; 


} 
// 定 义 处 理 用 户 请 求 的 execute 方法 
public String execute () throws Exception 
{ 
// 当 username 为 crazyit .org，password 为 leegang 时 即 登录 成 功 
if (getUsername() .equals ("crazyit.org") 
6&6 getPassword() .equals ("leegang") ) 
{ 
ActionContext .getContext () .getSession{() 
.put ("user” , getUsername()); 
return SUCCESS; 
} 


else 
{ 
return ERROR; 
} 
} 


该 Action 处 理 登录 请 求 的 逻辑 非常 简单 : 只 要 用 户 名 为 crazyitorg， 密码 为 leegang 即 认为 登录 成 
功 ， 如 上 面 粗 体 字 代码 所 示 。 

增加 了 Struts 2 的 Action 类 后 ， 还 需要 增加 对 应 的 配置 文件 ， 也 就 是 修改 src 路 径 下 的 struts.xml 
文件 。 修 改 后 该 文件 的 代码 如 下 。 

程序 清单 : codes\03W3.2\Struts2Demo\sre\struts.xml 


<?xml version="1.0" encoding="GBK"?> 

<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 

<!-- 指定 Struts 2 配置 文件 的 根 元 素 --> 


<struts> 
<!-- 指定 全 局 国际 化 资源 文件 --> 
<constant name="struts.custom.il8n.resources" value="mess"/> 
<!-- 指定 国际 化 编码 所 使 用 的 字符 集 一 -> 
<constant name="struts.ilBn.encoding” value="GBK"/> 
<!-- 所 有 的 Action 定义 都 应 该 放 在 package 下 --> 
<package name="lee" extends="struts-default"> 
<action name="login" class="org.crazyit.app.action.LoginAction"> 
<!-- 定义 三 个 逻辑 视图 和 物理 资源 之 间 的 映射 -> 
<result name="input">/login.jsp</result> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome. jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 配置 文件 中 粗 体 字 代码 配置 了 一 个 名 为 login 的 Action, 浏览 者 可 以 向 该 Action 发 送 请 求 。 
该 Action 下 还 配置 了 三 个 result 元 素 , 用 于 指定 逻辑 视图 和 物理 资源 之 间 的 映射 , 即 当 返回 input 逻辑 
视图 名 时 ， 系 统 跳 转 到 /login.jsp 页 面 。 


ea 提示 :一 一 一 一 一 一 一 一 一 一 一 一 一 一 a 
ON 我 们 所 使 用 的 Eclipse 没有 使 用 专门 的 Struts 2 插件 ， 因 此 只 能 用 比较 原始 的 方式 来 建 : 
立 一 个 Struts 2 的 配置 文件 。 如 果 开发 者 使 用 了 专门 的 Struts 2 插件 ， 应 该 可 以 通过 “下 一 | 

| 。 步 "、“ 下 一 步 ”的 方式 来 建立 Struts 2 的 配置 文件 . j 
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至 此 ， 整 个 Struts 2 应 用 完全 建立 成 功 ， 再 次 部 署 该 应 用 ， 先 浏览 loginjsp 页 面 ， 并 在 该 页 面 内 输 
入 crazyit.org、leegang 后 单 击 “ 登 录 ” 按 钮 ， 将 看 到 如 
图 3.5 所 示 的 页 面 。 

至 此 ,我 们 已 经 完全 掌握 了 在 Eclipse 下 开发 Struts 2 
应 用 的 流程 。 sryit. ore 你 已 经 晤 村 | 


3.3 ”Struts 2 的 流程 图 3.5 登录 成 功 
下 面 将 对 上 面 的 开发 Struts 2 应 用 的 过 程 进行 总 结 ， 以 期 让 读者 对 Struts 2 有 一 个 大 致 的 了 解 。 
>>3.3.1 Struts 2 应 用 的 开发 步 又 


下 面 简单 介绍 Struts 2 应 用 的 开发 步骤 。 
人 在 web.xml 文件 中 定义 核心 Filter 来 拦截 用 户 请 求 。 
由 于 Web 应 用 是 基于 请 求 /响应 架构 的 应 用 ， 所 以 不 管 哪个 MVC Web 框架 ， 都 需要 在 web.xml 
中 配置 该 框架 的 核心 Servlet 或 Filter， 这 样 才 可 以 让 该 框架 介入 Web 应 用 中 。 
例如 ， 开 发 Struts 2 应 用 第 1 步 就 是 在 web.xml 文件 中 增加 如 下 配置 片段 : 


<!-- 定义 Struts 2 的 核心 Filter --> 
<filter> 
<filter-name>struts2</filter-name> 
<filter-class>org.apache. struts2.dispatcher.ng 
-filter. StrutsPrepareAndExecuteFilter</filter-class> 
</filter> 


<!-- 让 Struts 2 的 核心 Filter 拦截 所 有 请 求 --> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


G 如果 需要 以 POST 方式 提交 请 求 ， 则 定义 包含 表单 数据 的 JSP 页面。 如 果 仅仅 只 是 以 GET 方 
式 发 送 请 求 ， 则 无 须 经 过 这 一 步 。 

人 @ 定义 处 理 用 户 请 求 的 Action 类 。 

这 一 步 也 是 所 有 MVC 框架 中 必 不 可 少 的 ， 因 为 这 个 Action 就 是 MVC 中 的 C， 也 就 是 控制 器 
该 控制 器 负责 调用 Model 里 的 方法 来 处 理 请 求 。 由 于 本 章 只 是 介绍 Struts 2 框架 的 用 法 ， 所 以 可 能 并 
未 调用 Model 的 方法 ， 而 是 让 Action 对 用 户 请 求 进行 了 简单 处 理 。 


次 Action 并 未 接收 到 用 户 请 求 啊 ， 它 怎么 能 处 理 用 户 请 求 呢 ? 

MVC 框架 的 底层 机 制 是 : 核心 Servlet 或 Filter 接收 到 用 户 请 求 后 ， 通 常会 对 用 户 请 求 进 | 
| 。 行 简单 预 处 理 ， 例 如 解析 、 封 装 参数 等 ， 然 后 通过 反射 来 创建 Action 实例 ， 并 调用 Action : 
:的 指定 方法 ( Struts 1 通常 是 execute，Struts 2 可 以 是 任意 方法 ) 来 处 理 用 户 请 求 。 这 里 又 | 
| 产生 了 一 个 问题 当 Servlet 或 Filter 拦截 用 户 请 求 后 ， 它 如 何 知道 创建 哪个 Action 的 实例 ， 
; 。 呢 ? 有 两 种 解决 方案 | 
| 仿 利用 配置 文件 : 例如， 我 们 可 以 配置 login.action 对 应 使 用 LoginAction 类 。 这 就 可 i 

- | 以 让 MVC 框架 知道 创建 哪个 Action 的 实例 了 。 a 
5 今 利用 约定 : 这 种 用 法 可 能 是 受 Rails 框架 的 启发 ， 例 如 ， 我 们 可 以 约定 xxx.action | 
1 总 是 对 应 XxxAction 类 。 如 果 核 心 控制 器 收 到 regist.action 请 求 后 ， 将 会 调用 
: RegistAction 类 来 处 理 用 户 请 求 ， 这 一 点 在 本 书 所 介绍 的 Sturts 2 版 本 中 已 有 对 应 | 
1 的 实现 ， 就 是 它 提供 的 Convention ( 约定 ) 插件 . 
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根据 上 面 的 介绍 不 难 发 现 : 在 MVC 框架 中 ， 控 制 器 实际 上 由 2 个 部 分 共同 组 成 ， 即 拦截 所 有 用 
户 请 求 ， 处 理 请 求 的 通用 代码 都 由 核心 控制 器 完成 ， 而 实际 的 业务 控制 (诸如 调用 Model， 返 回 处 理 
结果 等 ) 则 由 Action 处 理 。 

人 @ 配置 Action。 对 于 Java 领域 的 绝 大 部 分 MVC 框架 而 言 , 都 非常 喜欢 使 用 XML 文件 来 配置 管 
理 , 这 在 以 前 是 一 种 思维 定 势 。 配置 Action 就 是 指定 哪个 请 求 对 应 用 哪个 Action 进行 处 理 ， 从 而 让 核 
心 控制 器 根据 该 配置 来 创建 合适 的 Action 实例 ， 并 调用 该 Action 的 业务 控制 方法 。 例如， 我 们 通常 需 
要 采用 如 下 代码 片段 来 配置 Action。 

<action name="login" class="org.crazyit.app.action.LoginAction"> 
</action> 

上 面 的 配置 片段 指定 如 果 用 户 请 求 URL 为 login, 则 使 用 org.crazyit.app.action.LoginAction 来 处 理 。 

现在 Struts 2 的 Convention 插件 借鉴 了 Rails 框架 的 优点 ， 开 始 支 持 “ 约 定 优 于 配置 ”的 思想 ， 也 
就 是 采用 约定 方式 来 规定 用 户 请 求 地 址 和 Action 之 间 的 对 应 关系 。 

人 配置 处 理 结果 和 物理 视图 资源 之 间 的 对 应 关系 。 

当 Action 处 理 用 户 请 求 结束 后 ， 通 常会 返回 一 个 处 理 结果 通常 使 用 简单 的 字符 串 就 可 以 了 )， 
我 们 可 以 认为 该 名 称 是 逻辑 视图 名 ， 这 个 逻辑 视图 名 需要 和 指定 物理 视图 资源 关联 才 有 价值 。 所 以 我 
们 还 需要 配置 处 理 结果 之 间 的 对 应 关系 。 

例如 ， 我 们 通过 如 下 代码 片段 来 配置 处 理 结果 和 物理 视图 的 映射 关系 。 

<action name="login" class=" org.crazyit.app.action.LoginAction "> 
<!-- 定义 3 个 逻辑 视图 和 物理 资源 之 间 的 映射 --> 
<result name="input">/login. jsp</result> 
<result name="error">/error. jsp</result> 


<result name="success">/welcome. jsp</result> 
</action> 


上 面 的 粗 体 字 代码 指定 了 三 个 处 理 结果 和 三 个 物理 视图 之 间 的 映射 关系 ， 配 置 片段 指定 当 
lee.LoginAction 返回 input 时 ， 实 际 将 进入 /login.jsp 页 面 ， 当 返回 error 时 ， 实 际 将 进入 /errorjsp 页 面 ; 
当 返 回 suecess 时 ， 实 际 将 进入 /welcomejsp 页 面 。 

人 @ 编写 视图 资源 。 如 果 Action 需要 把 一 些 数据 传 给 视图 资源 ， 则 可 以 借助 于 OGNL 表达 式 。 
经 过 上 面 6 个 步骤 ， 我 们 可 以 基本 完成 一 个 Struts 2 处 理 流程 的 开发 ， 也 就 是 可 以 执行 一 次 完整 
的 请 求 /响应 过 程 。 


》》>3.3,2 Struts 2 的 流程 


上 一 节 所 介绍 的 Struts 2 应 用 的 开发 流程 实际 上 是 按 请 求 一 响应 的 流程 来 开发 的 ， 下 面 我 们 通过 
-个 简单 的 流程 图 来 介绍 请 求 一 响应 的 完整 流程 。 图 3.6 显示 了 一 次 请 求 一 响应 的 完整 流程 。 
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图 3.6 请 求 一 响应 的 完整 流程 
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3.6 中 灰色 区 域 包括 的 StrutsPrepareAndExecuteFilter 和 XxxAction 共同 构成 了 Struts 2 的 控制 器 ， 
常常 把 StrutsPrepareAndExecuteFilter 称 为 核心 控制 器 ， 把 XxxAction 称 为 业务 控制 器 。 

从 图 3.6 中 可 以 看 出 ， 业 务 控制 器 XxxAction 通常 并 不 与 物理 视图 关联 ， 这 种 做 法 提供 了 很 好 的 
解 耦 。 业 务 控制 器 只 负责 返回 处 理 结果 ， 而 该 处 理 结果 与 怎样 的 视图 关联 ， 依 然 由 
StrutsPrepareAndExecuteFilter 来 决定 。 这 样 做 的 好 处 是 : 如 果 有 一 天 需要 将 某 个 视图 名 映射 到 不 同 视 
图 资源 ， 这 就 无 须 修改 XxxAction 的 代码 ， 而 是 只 需 修改 配置 文件 即 可 。 

从 图 3.6 中 还 可 以 看 出 ,在 Struts 2 框架 的 控制 下 ， 用 户 请 求 不 再 向 JSP 页 面 发 送 ,而 是 由 核心 控 
制 器 StrutsPrepareAndExecuteFilter 来 “调用 ”JSP 页 面 来 生成 响应 ， 此 处 的 调用 并 不 是 直接 调用 ， 而 
是 将 请 求 forward 到 指定 JSP 页 面 。 


3.4 Struts 2 的 常规 配置 


虽然 Struts 2 提供 了 Convention 插件 来 管理 Action、 结 果 映 射 ， 但 对 于 大 部 分 实际 开发 来 说 ， 通 
常 还 是 会 考虑 使 用 XML 文件 来 管理 Struts 2 的 配置 信息 。 

Struts 2 的 默认 配置 文件 名 为 struts.xml， 该 文件 应 该 放 在 Web 应 用 的 类 加 载 路 径 下 ， 通 常 就 是 放 
在 WEB-INF/classes 路 径 下 。 

struts.xml 配置 文件 最 大 的 作用 就 是 配置 Action 和 请 求 之 间 的 对 应 关系 , 并 配置 逻辑 视图 名 和 物理 
视图 资源 之 间 的 对 应 关系 。 除 此 之 外 ，struts.xml 文件 还 有 一 些 额 外 的 功能 ， 例 如 Bean 配置 、 配 置 党 
量 、 导 入 其 他 配置 文件 等 。 


>>3.4.1 常量 配置 


Struts 2 除了 可 使 用 struts.xml 文件 来 管理 配置 之 外 ， 还 可 使 用 struts.properties 文件 来 管理 常量 ， 
该 文件 定义 了 Struts 2 框架 的 大 量 常量 ， 开 发 者 可 以 通过 改变 这 些 常量 来 满足 应 用 的 需求 。 

struts.properties 文件 是 一 个 标准 的 Properties 文件 ， 该 文件 包含 了 系列 的 key-value 对 ， 每 个 key 
就 是 一 个 Struts 2 常量 ， 该 key 对 应 的 value 就 是 一 个 Struts 2 常量 值 。 


提示 : 一 一 一 一 一 一 一 一 一 = 
Struts 2 的 常量 相当 于 对 于 Struts 2 应 用 整体 起 作用 的 属性 , 因此 Struts 2 常量 常常 也 被 ， 
称 为 Struts 2 属性 。 | 
只 要 将 struts.properties 文件 放 在 Web 应 用 的 类 加 载 路 径 下 ，Stmuts 2 框架 就 可 以 加 载 该 文件 。 通 
常 我 们 将 该 文件 放 在 Web 应 用 的 WEB-INF/classes 路 径 下 。 


现在 的 问题 是 ，struts.properties 文件 的 哪些 key 是 有 效 的 ? 即 struts.properties 文件 里 包含 哪些 常 
量 是 有 效 的 Struts 2 常量 。 下 面 列 出 了 可 以 在 struts.properties 中 定义 的 Struts 2 常量 。 


- .2.1jar 压缩 文件 的 org\apache\struts2 路 径 下 有 一 个 default.properties 文 : 
件 ,该 文件 里 为 Struts 2 的 所 有 常量 都 指定 了 默认 值 ,读者 可 以 通过 查看 该 文件 来 了 解 Struts 
| 。 2 所 支持 的 常量 


> struts.configuration， 该 常量 指定 加 载 Struts 2 配置 文件 的 配置 管理 器 。 该 常量 的 默认 值 是 
org.apache.struts2.config.DefaultConfiguration， 这 是 Struts 2 默认 的 配置 文件 管理 器 。 如 
果 需 要 实现 自己 的 配置 管理 器 , 开发 者 则 可 以 实现 一 个 Configuration 接口 的 类 , 该 类 可 以 自 
己 加 载 Struts 2 配置 文件 。 
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> struts.locale: 指定 Web 应 用 的 默认 Locale。 默 认 的 Locale 是 en_US。 

> struts.i18n.encoding: 指定 Web 应 用 的 默认 编码 集 - 该 常量 对 于 处 理 中 文 请 求 参 数 非常 有 用 ， 
对 于 获取 中 文 请 求 参数 值 ， 应 该 将 该 常量 值 设置 为 GBK 或 者 GB2312。 该 常量 的 默认 值 为 
UTF-8。 


Re 提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 一 一 一 一 … = 
pa 设置 该 参数 为 GBK 时 ， 相 当 于 执行 了 HttpServletRequest 的 setCharacterEncoding | 
("GBK. 法 。 | 


> ”struts.objectFactory: 指定 Struts 2 默认 的 ObjectFactory Bean。 

> ”struts.objectFactory.spring.autoWire: 指定 Spring 框架 的 自动 装配 模式 , 该 常量 的 默认 值 是 
name， 即 默认 根据 Bean 的 name 自动 装配 。 

> struts.objectFactory.spring.useClassCache: 该 常量 指定 整合 Spring 框架 时 ， 是 否 缓存 
Bean 实例 ， 该 常量 只 允许 使 用 true 和 false 两 个 值 ， 它 的 默认 值 是 true。 通 常 不 建议 修改 该 
常量 值 。 

> struts.objectFactory.spring.autoWire.alwaysRespect 保证 总 是 使 用 自动 装配 策略 。 

> ”struts.objectTypeDeterminer: 该 常量 指定 Struts 2 的 类 型 检测 机 制 ;通常 支持 tiger 和 notiger 
两 个 常量 值 。 

> ”struts.multipart.parser: 该 常量 指定 处 理 multipart/form-data 的 MIME 类 型 (文件 上 传 ) 请 
求 的 框架 , 该 常量 支持 cos、pell 和 jakarta 等 常量 值 , 即 分 别 对 应 使 用 cos 的 文件 上 传 框架 、 
上 传 及 common-fileupload 文件 上 传 框架 。 该 常量 的 默认 值 为 jakarta 。 


如 果 需 要 使 用 cos 或 者 pell 的 文件 上 传 方式 ， 则 应 该 将 对 应 的 JAR 文件 复制 到 Web 
应 用 中 。 例如， 使 用 cos 上 传 方式 ， 则 需要 自己 下 载 cos 框架 的 JAR 文件 ， 并 将 该 文件 


放 在 WEB-INF/lib 路 径 下 


struts.multipart.saveDir: 该 常量 指定 上 传 文件 的 临时 保存 路 径 ， 该 常量 的 默认 值 是 
javax.servlet.contexttempdir。 

> struts.multipart.maxSize: 该 常量 指定 Struts 2 文件 上 传 中 整个 请 求 内 容 允 许 的 最 大 字 节 数 。 

> ”struts.custom.properties: 该 常量 指定 Struts 2 应 用 加 载 用 户 自 定义 的 常量 文件 ， 该 自 定义 
常量 文件 指定 的 常量 不 会 覆盖 struts.properties 文件 中 指定 的 常量 。 如 果 需 要 加 载 多 个 自 定 
义 常量 文件 ， 则 多 个 自 定义 常量 文件 的 文件 名 以 英文 逗号 〈,) 隔 开 。 

> ”struts.mapper.class: 指定 将 HTTP 请 求 映射 到 指定 Action 的 映射 器 ，Struts 2 提供 了 默认 
的 映射 器 : org.apache.struts2.dispatcher.mapper.DefaultActionMapper。 默认 的 映射 器 根据 
请 求 的 前 组 与 Action 的 name 常量 完成 映射 。 

> ”struts.action.extension: 该 常量 指定 需要 Struts 2 处 理 的 请 求 后 缀 , 该 常量 的 默认 值 是 action， 

即 所 有 匹配 *.action 的 请 求 都 由 Struts 2 处 理 。 如 果 用 户 需要 指定 多 个 请 求 后 缀 ， 则 多 个 后 

(,) 隔 开 。 


YA (struts 2 权 成 指南 》 一 书面 世 以 来 ,笔者 收 到 一 些 读者 来 信 询问 如 何 改变 struts 2 拦 极 
请 求 的 后 级， 他 们 认为 Struts 1 是 在 web.xml 文件 中 配置 拦截 *.do， 而 在 Struts 2 中 找 不 到 | 
| ”相应 的 配置 ， 于 是 感到 很 迷 岗 ,其实 Struts 2 更 简单 ， 只 要 修改 此 处 即 可 。 J 
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> ”struts.serve.static， 该 常量 设置 是 否 通过 JAR 文件 提供 静态 内 容 服务 ， 只 支持 true 和 false 
常量 值 。 该 常量 的 默认 常量 值 是 true。 

> struts.serve.static.browserCache: 该 常量 设置 浏览 器 是 否 缓存 静态 内 容 。 当 应 用 处 于 开发 阶 
段 时 ， 我 们 希望 每 次 请 求 都 获得 服务 器 的 最 新 响应 ， 则 可 设置 该 常量 为 false。 

> struts.enable.DynamicMethodInvocation: 该 常量 设置 Struts 2 是 否 支 持 动态 方法 调用 ， 该 
常量 的 默认 值 是 true。 如 果 需 要 关闭 动态 方法 调用 ， 则 可 设置 该 常量 为 false。 

> struts.enable.SlashesinActionNames: 该 常量 设置 Struts 2 是 否 允 许 在 Action 名 中 使 用 斜 
线 ， 默 认 值 是 false。 如 果 开发 者 希望 允许 在 Action 名 中 使 用 斜 线 ， 则 可 设置 该 常量 为 true。 

> ”struts.tag.altSyntax: 该 常量 指定 是 否 允 许 在 Struts 2 标签 中 使 用 表达 式 语 法 ， 因 为 通常 都 需 
要 在 标签 中 使 用 表达 式 语法 ， 故 此 常量 应 该 设置 为 rue。 该 常量 的 默认 值 是 true。 

> struts.devMode: 该 常量 设置 Struts 2 应 用 是 否 使 用 开发 模式 。 如 果 设 置 该 常量 为 rue， 则 
可 以 在 应 用 出 错时 显示 更 多 、 更 友好 的 出 错 提示 。 该 常量 只 接受 true 和 false 两 个 值 ， 该 党 
量 的 默认 值 是 false。 通常, 应 用 在 开发 阶段 , 将 该 常量 设置 为 true; 当 进入 产品 发 布 阶段 后 ， 
则 该 常量 设置 为 false。 


提示 
当 该 把 该 常量 设 为 true 之 后 , 相当 于 把 struts.il8n.reload、 struts.configuration.xml.reload ， 
两 个 常量 都 设 为 true | 


> struts.i18n.reload:， 该 常量 设置 是 否 每 次 HTTP 请 求 到 达 时 ， 系 统 都 重新 加 载 资源 文件 。 该 
常量 默认 值 是 false。 在 开发 阶段 将 该 常量 设置 为 true 会 更 有 利于 开发 ， 但 在 产品 发 布 阶段 
应 将 该 常量 设置 为 false。 


而 可 以 让 开发 者 看 到 实时 开发 效果 ; 产品 发 布 阶段 应 该 将 该 常量 设置 为 false， 是 为 了 提供 | 
响应 性 能 ， 每 次 请 求 都 需要 重新 加 载 资源 文件 会 大 大 降低 应 用 的 性 能 . ] 

> struts.ui.theme: 该 常量 指定 视图 标签 默认 的 视图 主题 ， 默 认 值 是 xhtml。 

> struts.uitemplateDir， 该 常量 指定 视图 主题 所 需要 模板 文件 的 位 置 ， 默 认 值 是 template， 即 
默认 加 载 template 路 径 下 的 模板 文件 。 

> struts.uitemplateSuffx: 该 常量 指定 模板 文件 的 后 级 ， 默 认 常 量 值 是 仙 。 该 常量 还 允许 使 用 
介 、vm 或 jsp， 分 别 对 应 FreeMarker、Velocity 和 JSP 模板 。 

> struts.configuration.xml.reload: 该 常量 设置 当 struts.xml 文件 改变 后 ， 系 统 是 否 自动 重新 加 
载 该 文件 。 该 常量 的 默认 值 是 false。 

> struts.velocity.configfile: 该 常量 指定 Velocity 框架 所 需 的 velocity.properties 文件 的 位 置 ， 
默认 值 为 velocity.properties。 

> ”struts.velocity.contexts: 该 常量 指定 Velocity 框架 的 Context 位 置 ， 如 果 该 框架 有 多 个 
Context， 则 多 个 Context 之 间 以 英文 逗号 〈,) 隔 开 。 

> struts.velocity.toolboxilocation: 该 常量 指定 Velocity 框架 的 toolbox 的 位 置 。 

> struts.url.http.port: 该 常量 指定 Web 应 用 所 在 的 监听 端口 。 该 常量 通常 没有 太 大 的 用 处 ， 只 
是 当 Struts 2 需要 生成 URL 时 (例如 Un 标签 ) ， 该 常量 才 提供 Web 应 用 的 默认 端口 。 

> struts.url.https.port: 该 常量 类 似 于 struts.url.http.port 常量 的 作用 ， 区 别 是 该 常量 指定 的 是 
Web 应 用 的 加 密 服 务 端口 。 

> struts.url.includeParams: 该 常量 指定 Struts 2 生成 URL 时 是 否 包含 请 求 参 数 。 该 常量 接受 
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none、get 和 all 三 个 常量 值 ， 分 别 对 应 于 不 包含 、 仅 包含 GET 类 型 请 求 参 数 和 包含 全 部 请 
求 参数 。 

struts.custom.i18n.resources: 该 常量 指定 Struts 2 应 用 所 需要 的 国际 化 资源 文件 ， 如 果 有 
多 个 国际 化 资源 文件 ， 则 多 个 资源 文件 的 文件 名 以 英文 逗号 (,) 隔 开 。 
struts.dispatcher.parametersWorkaround : 对 于 某 些 Java EE 服务 器 ， 不 支持 
HttpServletRequest 调用 getParameterMap() 方 法 ， 此 时 可 以 设置 该 常量 值 为 true 来 解决 该 
问题 。 该 常量 的 默认 值 是 false。 对 于 WebLogic、Orion 和 OC4J 服务 器 ， 通 常 应 该 设置 该 
常量 为 tue。 

struts.freemarker.manager.classname: 该 常量 指定 Struts 2 使 用 的 FreeMarker 管理 器 。 该 
常量 的 默认 值 是 org.apache.struts2.views .freemarker.FreemarkerManager， 这 是 Struts 2 
内 建 的 FreeMarker 管理 器 。 

struts.freemarker.templatesCache: 该 常量 设置 是 否 缓存 FreeMarker 模板 。 该 常量 的 默认 
值 为 false。 

struts.freemarker.beanwrapperCache: 常量 设置 是 否 缓存 FreeMarker 的 Bean 模型 。 该 常 
量 的 默认 值 为 false。 

struts.freemarker.wrapper.altMap: 该 常量 只 支持 true 和 false 两 个 常量 值 ， 默 认 值 是 true。 
通常 无 须 修改 该 常量 值 。 

struts.freemarker.mru.max.strong.size: 该 常量 的 默认 值 为 100。 

struts.xslt.nocache: 该 常量 设置 XSLT Result 是 否 使 用 样式 表 缓 存 。 当 应 用 处 于 开发 阶段 时 ， 
该 常量 通常 被 设置 为 true;， 当 应 用 处 于 产品 使 用 阶段 时 ， 该 常量 通常 被 设置 为 false。 
struts.mapper.alwaysSelectFullNamespace: 设置 是 否 总 是 使 用 命名 空间 ， 该 常量 的 默认 值 
是 false。 

struts.ognl.allowStaticMethodAccess: 该 常量 设置 是 否 允许 在 OGNL 表达 式 中 调用 静态 方 
法 。 该 常量 的 默认 值 是 false。 

struts.el.throwExceptionOnFailure: 该 常量 设置 当 表达 式 计算 失败 时 、 或 表达 式 里 某 个 常量 
不 存在 时 是 否 抛 出 一 个 RuntimeException。 该 常量 的 默认 值 是 false。 
struts.ognl.logMissingProperties: 该 常量 设置 是 否 记录 (以 Warning 日 志 级 别 ) ) 表达 式 中 
所 有 找 不 到 常量 。 该 常量 的 默认 值 是 false。 如 果 将 该 常量 设置 为 rue， 将 会 看 到 控制 台 输 出 
大 量 调试 信息 ， 看 上 去 十 分 烦琐 。 

struts.ognl.enableExpressionCache: 该 常量 设置 对 OGNL 表达 式 的 计算 结果 进行 缓存 ， 这 
种 缓存 可 能 导致 内 存 泄露 。 该 常量 的 默认 值 是 true。 


Struts 2 默认 会 加 载 类 加 载 路 径 下 的 struts.xml、struts-default.xml、struts-plugin.xml 三 类 文件 ， 其 
中 struts.xml 是 开发 者 定义 的 默认 配置 文件 ， struts-defaultxml 是 Struts 2 框架 自 带 的 配置 文件 ， 而 
struts-plugin.xml 则 是 Struts 2 插件 的 默认 配置 文件 。 

Struts 2 配置 常量 总 共有 三 种 方式 : 


> 
> 
> 


通过 struts.properties 文件 。 
通过 struts.xml 配置 文件 。 
通过 Web 应 用 的 web.xml 文件 。 


Struts 2 的 所 有 配置 文件 ,包括 stmuts-defaultxml、struts-plugin xml， 甚 至 用 户 自 定义 的 、 只 要 能 被 
Struts 2 加 载 的 配置 文件 中 都 可 使 用 常量 配置 的 方式 来 配置 Struts 2 常量 。 

如 下 struts.xml 配置 片段 在 struts.xml 文件 中 配置 了 一 个 常量 ， 该 常量 即 可 代替 struts.properties 文 
件 中 Struts 2 配置 属性 。 


<?xml version="1.0" encoding="UTF-8" ?> 
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<!-- 指定 Struts 2 的 DID 信 息 --> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<!-- 通过 constant 元 素 配 置 Struts 2 的 属性 一 > 
<constant name="struts.custom.il8n.resources" value="mess"/> 
</struts> 
上 面 的 粗 体 字 代 码 配置 了 一 个 常用 属性 : struts.custom.il8n.resources, 该 属性 指定 了 应 用 所 需 的 国 
际 化 资源 文件 的 baseName 为 mess。 
除 此 之 外 ， 当 我 们 在 web.xml 文件 中 配置 StrutsPrepareAndExecuteFilter 时 也 可 配置 Struts 2 常量 ， 
此 时 采用 为 StrutsPrepareAndExecuteFilter 配置 初始 化 参数 的 方式 来 配置 Struts 2 常量 ， 如 下 面 的 代码 
片段 所 示 。 
<?xml version="1.0" encoding="GBK"?> 
<web-app xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation="http;//java. sun.com/xml/ns/javaee 
http://java. sun. com/xml /ns/javaee/web-app_3_0.xsd" version="3.0"> 
<!-- 定义 Struts 2 的 核心 Filter --> 
<filter> 
<filter-name>struts2</filter-name> 
<filter-class>org.apache.struts2.dispatcher.ng 
.filter. StrutsPrepareAndExecuteFilter</filter-class> 
<init-param> 
<param-name>struts.custom.ilgn. resources</param-name> 
-value>mess</param-value> 
</init-param> 
</filter> 
</vebapp> 
上 面 的 配置 文件 中 粗 体 字 代码 也 配置 了 一 个 常用 属性 : struts.custom.il8n.resources， 该 属性 指定 了 
应 用 所 需 的 国际 化 资源 文件 的 baseName 为 mess。 
通常 推荐 在 struts.xml 文件 中 定义 Struts 2 属性 ， 而 不 是 在 struts.properties 文件 中 定义 Struts 2 属 
性 。 之 所 以 保留 使 用 struts.properties 文件 定义 Struts 2 属性 的 方式 ， 主 要 是 为 了 保持 与 WebWork 的 向 
后 兼容 性 。 
通常 ，Struts 2 框架 按 如 下 搜索 顺序 加 载 Struts 2 常量 。 
> struts-default.xml: 该 文件 保存 在 struts2-core-2.1.2.jar 文件 中 。 
> struts-plugin.xml: 该 文件 保存 在 struts2-Xxx-2.1.2.jar 等 Struts 2 插件 JAR 文件 中 。 
> struts.xml: 该 文件 是 Web 应 用 默认 的 Struts 2 配置 文件 。 
> ”struts.properties: 该 文件 是 Struts 2 默认 的 配置 文件 。 
> ”web.xml: 该 文件 是 Web 应 用 的 配置 文件 。 
上 面 指定 了 Struts 2 框架 搜索 常量 顺序 ， 如 果 在 多 个 文件 中 配置 了 同一 个 Struts 2 常量 ， 则 后 一 个 
文件 中 配置 的 常量 值 会 覆盖 前 面 文件 中 配置 的 常量 值 。 
在 不 同文 件 中 配置 常量 的 方式 是 不 一 样 的 ， 但 不 管 在 哪个 文件 中 ， 配 置 Struts 2 常量 都 需要 指定 
两 个 属性 : 常量 name 和 常量 value， 分 别 指定 Struts 2 属性 名 和 属性 值 
因为 struts.xml 文件 是 整个 Struts 2 框架 的 核心 ， 下 面 将 提供 一 份 完整 的 struts.xml 文件 骨架 ， 这 
个 文件 没有 实际 意义 ， 只 是 一 个 struts.xml 文件 示范 。 
<?xml version="1.0" encoding="GBK"?> 
<!-- 下 面 指定 Struts 2 配置 文件 的 DTD 信息 --> 
<!DOCTYPE struts PUBLIC 


"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
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<!-- struts 是 Struts 2 配置 文件 的 根 元 素 一 > 
<struts> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<constant name="" Value=nn /> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ,或 者 无 限 多 次 --> 和 
<bean type="" name="" class="" scope="" static="" optional="" /> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ,或 者 无 限 多 次 --> 
<include file="" /> 
<!-- package 元 素 是 Struts 配置 文件 的 核心 ， 该 元 素 可 以 出 现 0 次 或 者 无 限 多 次 -> 
<package name=" 必 填 的 包 名 "extends="" namespace="" abstract="" 
externalReferenceResolver=""> 
<!-- 该 元 素 可 以 出 现 ， 也 可 以 不 出 现 ， 最 多 出 现 一 次 --> 
<result-types> 
<!-- 该 元 素 必须 出 现 ， 可 以 出 现 无 限 多 次 --> 
<result-type name="" class="" default="true|false"> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </param> 
</result-type> 
</result-types> 
<!-~ 该 元 素 可 以 出 现 ， 也 可 以 不 出 现 ， 最 多 出 现 一 次 --> 
<interceptors> 
<!-- 该 元 素 的 interceptor 元 素 和 interceptor-stack 至 少 出 现 其 中 之 一 ， 
也 可 以 二 者 都 出 现 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<interceptor name="" class=""> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </param> 
</interceptor> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<interceptor-stack name=""> 
<!-- 该 元 素 必须 出 现 ， 可 以 出 现 无 限 多 次 -> 
<interceptor-ref name=""> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </Param> 
</interceptor-ref> 
</interceptor-stack> 
</interceptors> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 最 多 出 现 一 次 ~-> 
<default-interceptor-ref name- 
<!-~ 下 面 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </param> 
</default-interceptor-ref> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 最 多 出 现 一 次 --> 
<default-action-ref name=""> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </param> 
</default-action-ref> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 最 多 出 现 一 次 ~-> 
<default-class-ref class="">...</default- class-ref> 
<!-- 下 面 的 元 素 可 以 出 现 0 次， 最 多 出 现 一 次 -> 
<global-results> 
<!-- 该 元 素 必须 出 现 ， 可 以 出 现 无 限 多 次 --> 
<result name="" type=""> 
映射 资源 
<!- 下 面 元 素 可 以 出 现 0 次 ， 也 可 以 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </Param> 
</result> 
</global-results> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 最 多 出 现 一 次 -> 
<global-exception-mappings> 
<!-- 该 元 素 必 须 出 现 ， 可 以 出 现 无 限 多 次 --> 
<exception-mapping name="" exception="" result=""> 
异常 处 理 资源 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 也 可 以 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </param> 
</exception-mapping> 
</global-exception-mappings> 
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<!-- 定义 Action， 可 以 出 现 0 次 到 无 限 多 次 --> 

<action name="" class="" method="" converter=""> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 -> 
<param name=" 参 数 名 "> 参数 值 </param> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 -> 


<result name="" type=""> 


映射 资源 

<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </param> 
</result> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<interceptor-ref name=""> 

<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 

<param name=" 参 数 名 "> 参数 值 </param> 
</interceptor-ref> 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<exception-mapping name="" exception="" result=""> 


处 理 资源 
<!-- 下 面 的 元 素 可 以 出 现 0 次 ， 或 者 无 限 多 次 --> 
<param name=" 参 数 名 "> 参数 值 </Param> 
</exception-mapping> 
</action> 
</package> SS 
<!-- 可 以 出 现 0 次 到 1 次 一 > 
<unknown-handler-stack> 
<unknown-handler-ref name=" 处 理 器 名 ">.. .</ unknown-handler-ref name> 
</unknown-handler-stack> 
<struts> 


上 面 的 struts.xml 配置 文件 是 一 个 非常 全 面 的 配置 文件 ， 包 含 了 Struts 2 的 全 部 配置 元 素 ， 当 我 们 
使 用 Struts 2 框架 时 可 按 上 面 的 配置 规则 进行 配置 。 


》>>3.4.2 包含 其 他 配置 文件 


在 默认 情况 下 , Struts 2 只 自动 加 载 类 加 载 路 径 下 的 struts.xml、default-struts.xml 和 struts-plugin.xml 
三 类 文件 。 但 随 着 应 用 规模 的 增 大 ， 系 统 中 Action 数量 也 大 量 增加 ， 将 导致 struts.xml 配置 文件 变 得 
非常 腑 肿 。 

为 了 避免 struts.xml 文件 过 于 庞大 、 腑 肿 , 提高 struts.xml 文件 的 可 读 性 , 我 们 可 以 将 一 个 struts.xml 
配置 文件 分 解 成 多 个 配置 文件 ， 然 后 在 struts.xml 文件 中 包含 其 他 配置 文件 。 

下 面 的 struts.xml 文件 中 就 通过 include 手动 导入 了 一 个 配置 文件 :struts-partl.xml 文件 ， 通 过 这 

种 方式 ， 就 可 以 将 Struts 2 的 Action 按 模块 配置 在 多 个 配置 文件 中 。 

<?xml version="1.0" encoding="UTF-8" ?> 

<!-- 指定 Struts 2 配置 文件 的 DTD 信 息 --> 

<!DOCTYPE struts PUBLIC 和 

"-//apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 


"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<!-- 下 面 是 Struts 2 配置 文件 的 根 元 素 --> 


<struts> 
<!-- 通过 include 元 素 导 入 其 他 配置 文件 ~-> 
<include file="struts-partl.xml" /> 


</struts> 过 
上 面 的 粗 体 字 代码 使 用 include 包含 了 其 他 配置 文件 。 通 过 这 种 方式 ，Struts 2 能 以 一 种 模块 化 的 
方式 来 管理 struts.xml 配置 文件 。 
被 包含 的 struts-part1.xml 文件 是 标准 的 Struts 2 配置 文件 ,一 样 包含 了 DTD 信息 、Struts 2 配置 文 
件 的 根 元 素 等 信息 。 通 常 ， 将 Struts 2 的 所 有 配置 文件 都 放 在 Web 应 用 的 WEB-INF/classes 路 径 下 ， 
struts.xml 文件 包含 了 其 他 的 配置 文件 ，struts.xml 文件 由 Struts 2 框架 负责 加 载 ， 从 而 可 以 将 所 有 配置 
信息 都 加 载 进来 。 
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3.5 实现 Action 


对 于 Struts 2 应 用 的 开发 者 而 言 ，Action 才 是 应 用 的 核心 ， 开 发 者 需要 提供 大 量 的 Action 类 ， 并 
在 struts.xml 文件 中 配置 Action。Action 类 里 包含 了 对 用 户 请 求 的 处 理 逻 辑 ，Action 类 也 被 称 为 业务 控 
制 器 。 
相对 于 Struts 1 而 言 , Struts 2 采用 了 低 侵入 式 的 设计 , Struts 2 不 要 求 Action 类 继承 任何 的 Struts 2 
基 类 ， 或 者 实现 任何 Struts 2 接口 。 在 这 种 设计 方式 下 ，Struts 2 的 Action 类 是 一 个 普通 的 POJO ( 通 
常 应 该 包含 一 个 无 参数 的 execute 方法 )， 从 而 有 很 好 的 代码 复 用 性 。 
Struts 2 通常 直接 使 用 Action 来 封装 HTTP 请 求 参数 , 因此 , Action 类 里 还 应 该 包含 与 请 求 参数 对 
应 的 属性 ， 并 且 为 这 些 属 性 提供 对 应 的 setter 和 getter 方法 。 
例如 ， 用 户 请 求 包 含 user 和 pass 两 个 请 求 参数 ， 那 么 Action 类 应 该 提供 user 和 pass 两 个 属性 来 
封装 用 户 的 请 求 参数 , 并 且 为 user 和 pass 提供 对 应 的 setter 和 getter 方法 。 下 面 是 处 理 该 请 求 的 Action 
类 的 代码 片段 。 
// 处 理 用 户 请 求 的 Action 类 ， 只 是 一 个 PoJO， 无 须 继 承 任何 基 类 ， 无 须 实现 任何 接口 
public class LoginAction 


{ 
// 提 供 两 个 属性 来 封装 HTTP 请 求 参数 
private String user; 
private String pass; 
/Vuser 属性 的 getter 和 setter 方法 
public void setUser(String user) 
{ 


this.user = user; 
} 
public String getUser() 
{ 

return (this.user); 


} 
//pass 属性 的 getter 和 setter 方法 
public void setPass(String pass) 
{ 

this.pass = Pass 


} 
public String getPass() 
{ 

return (this.pass); 


} 

//Action 类 默认 处 理 用 户 请 求 的 方法 ，execute 方法 
public String execute() 

{ 


/7 返回 处 理 结果 字符 囊 
return resultStr; 


} 
} 


上 面 的 Action 类 只 是 一 个 普通 Java 类 ， 这 个 Java 类 提供 了 两 个 属性 : user 和 pass (如 程序 中 粗 
体 字 代码 所 示 )， 并 为 这 两 个 属性 提供 了 setter 和 getter 方法 ， 这 两 个 属性 分 别 对 应 两 个 HTTP 请 求 参 
数 。 上 面 LoginAction 中 的 execute0 方 法 就 是 处 理 用 户 请 求 的 逻辑 控制 方法 。 


即使 Action 需要 处 理 的 请 求 包含 user 和 pass 两 个 HTTP 请 求 参数 ，Action 类 也 可 以 ， 

不 包含 user 和 pass Field。 因 为 系统 是 通过 对 应 的 getter 和 setter 方法 来 处 理 请 求 参数 的 ， | 

| 而 不 是 通过 Field 名 来 处 理 请 求 参数 的 .也 就 是 说 , 如果 包含 user 的 HTTP 请 求 参数 ,Action : 
; ”类 里 是 否 包 含 user Field 不 重要 ， 重 要 的 是 需要 包含 void setUser(String user) 和 String 

| 。 getUser0 两 个 方法 . 全 
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Action 类 里 的 属性 ， 不 仅 可 用 于 封装 请 求 参数 ， 还 可 用 于 封装 处 理 结果 。 例 如 我 们 希望 将 服务 器 
提示 的 “登录 成 功 ” 或 其 他 信息 在 下 一 个 页 面 输出 ， 那 么 可 以 在 Action 类 中 增加 一 个 tip 属性 ， 并 为 
该 属性 提供 对 应 的 setter 和 getter 方法 ， 即 为 Action 类 增加 如 下 代码 片段 。 


// 封 装 服务 器 提示 的 tip 属性 
private String tip; 
//tip 属性 对 应 的 getter 和 setter 方法 
public String getTip() 
{ 
return tip; 


上 
public void setTip(String tip) 
{ 


this.tip = tip; 
} 


- 旦 在 Action 中 设置 了 tip 属性 的 值 ,就 可 以 在 下 一 个 页 面 中 使 用 Struts 2 标签 来 输出 该 属性 的 值 。 
在 JSP 页 面 中 输出 tip 属性 值 的 代码 片段 如 下 : 
<!-- 使 用 Struts 2 标签 来 输出 tip 属性 值 =-> 
<s:property value="tip"/> 

系统 不 会 严格 区 分 Action 里 哪个 属性 是 用 于 封装 请 求 参 数 的 属性 , 哪个 属性 是 封装 处 理 结果 的 属 
性 。 对 系统 而 言 ， 封 装 请 求 参 数 的 属性 和 封装 处 理 结果 的 属性 是 完全 平等 的 。 如 果 用 户 的 HTTP 请 求 
里 包含 了 名 为 tip 的 请 求 参 数 ， 则 系统 会 调用 Action 类 的 void setTip(String tip) 方 法 ， 通 过 这 种 方式 ， 
名 为 tip 的 请 求 参数 就 可 以 传 给 Action 实例 ， 如 果 Action 类 里 没有 包含 对 应 的 方法 ， 则 名 为 tip 的 请 
求 参 数 无 法 传 入 该 Action。 

同样 ， 在 JSP 页 面 中 输出 Action 属性 时 ， 它 也 不 会 区 分 该 属性 是 用 于 封装 请 求 参 数 的 属性 ， 还 是 
用 于 封装 处 理 结果 的 属性 ,因此 ,使 用 Struts 2 的 标签 既 可 以 输出 Action 的 处 理 结果 ,也 可 以 输出 HTTP 
请 求 参 数值 。 

从 上 面 的 代码 可 以 看 到 ， 需 要 在 JSP 页 面 输出 的 处 理 结果 是 一 个 简单 的 字符 串 ， 可 以 使 用 
<s:property.… 户 标签 来 控制 输出 。 实 际 上 ，Action 类 里 可 以 封装 非常 复杂 的 属性 ， 包 括 其 他 用 户 自 定义 
的 类 、 数 组 、 集 合 对 象 和 Map 对 象 等 。 对 于 这 些 复杂 类 型 的 输出 ， 一 样 可 通过 Struts 2 的 标签 来 完成 。 
关于 如 何 输出 复杂 类 型 的 结果 ， 请 参看 本 章 后 面 关 于 标签 库 的 介绍 。 


》>>3.5.1 Action 接口 和 ActionSupport 基 类 


为 了 让 用 户 开发 的 Action 类 更 规范 ，Struts 2 提供 了 一 个 Action 接口 ， 这 个 接口 定义 了 Struts 2 的 
Action 处 理 类 应 该 实现 的 规范 。 下 面 是 标准 Action 接口 的 代码 。 
public interface Action 
{ 
// 定 义 Action 接口 里 包含 的 一 些 结果 字符 串 
public static final String ERROR = "error"; 
public static finalc String INPUT = "input"; 
Public static final String LOGIN = "login™"; 
Public static final String NONE = "none"; 
public static final String SUCCESS = "success"; 
// 定 义 处 理 用 户 请 求 的 execute 方法 
Public String execute() throws Exception; 
} 


上 面 的 Action 接口 里 只 定义 了 一 个 execute 方法 ， 该 接口 的 规范 规定 了 Action 类 应 该 包含 一 个 
execute 方法 ， 该 方法 返回 一 个 字符 串 。 除 此 之 外 ， 该 接口 还 定义 了 5 个 字符 串 常量 ,它们 的 作用 是 统 
一 execute 方法 的 返回 值 。 

例如 ， 当 Action 类 处 理 用 户 请 求 成 功 后 ， 有 人 喜欢 返回 welcome 字符 串 ， 有 人 喜欢 返回 success 
字符 串 …… 这 样 不 利于 项 目的 统一 管理 。 Struts 2 的 Action 接口 定义 了 如 上 5 个 字符 串 常量 : ERROR、 
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NONE、INPUT、LOGIN 和 SUCCESS， 分别 代表 了 特定 的 含义 。 当 然 ， 如 果 开 发 者 依然 希望 使 用 特 
定 的 字符 串 作 为 逻辑 视图 名 ， 开 发 者 依然 可 以 返回 自己 的 视图 名 。 

另外 ，Struts 2 为 Action 接口 提供 了 一 个 实现 类 : ActionSuport， 下 面 是 该 ActionSupport 实现 类 的 
代码 片段 。 

// 系 统 提 供 的 ActionSupport 类 


public class RctionSupport implements Action, Validateable, 
ValidationAware, TextProvider, LocaleProvider, Serializable 


{ 

// 收 集 校 验 错误 的 方法 

public void setActionErrors(Collection errorMessages) { 
validationAware. setActionErrors (errorMessages) ; 


} 
// 返 回 校 验 错误 的 方法 
public Collection getActionErrors() { 
return validationAware.getActionErrors(); 


) 

public void setActionMessages (Collection messages) { 
validationAware. setActionMessages (messages); 

} 

public Collection getActionMessages() { 
return validationAware.getActionMessages(); 


上 


// 设 置 表单 域 校 验 错误 信息 
public void setFieldErrors(Map errorMap) { 
validationAware. setFieldErrors (errorMap) ; 


} 
// 返 回 表单 域 校 验 错 误 信息 
public Map getFieldErrors() { 
return validationAware.getFieldErrors(); 


} 
// 控 制 Locale 的 相关 信息 
public Locale getLocale() { 
return ActionContext,.getContext () .getLocale(); 


) 
public String getText(String aTextName) { 
return textProvider.getText (aTextName); 


} 
// 返 回国 际 化 信息 的 方法 
public String getText (String aTextName, String defaultValue) ( 
return textProvider.getText (arextName, defaultValuej 7 
} 
public String getText (String aTextName 
/String defaultValue, string obj) { 
return textProvider.getText (aTextName, defaultValue, obj); 
} 


// 用 于 访问 国际 化 资源 包 的 方法 
public ResourceBundle getTexts() { 
return textProvider.getTexts(); 


} 
Public ResourceBundle getTexts(String aBundleName) { 
return textProvider.getTexts (aBundleName); 


} 

// 添 加 错误 信息 

public void addActionError (string anErrorMessage) { 
validationAware.addActionError (anErrorMessage); 


上 
public void addActionMessage (String aMessage) { 
validationAware.addActionMessage (aMessage); 


/ /添加 字段 校 验 失败 的 错误 信息 


public void addFieldError(String fieldName, String errorMessage) { 
validationAware.addFieldError (fieldName, errorMessage); 
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} 

// 默 认 的 input 方法 ， 直 接 返回 INPUT 字符 囊 

public String input() throws Exception { 
return INPUT; 

} 

public String doDefault() throws Exception { 
return SUCCESS; 


/ /默认 的 处 理 用 户 请 求 的 方法 ， 直 接 返 回 SOCCESS 字符 串 

public String execute() throws Exception { 
return SUCCESS; 

} 


// 清 除 所 有 错误 信息 的 方法 
public void clearErrorsAndMessages() { 
validationAware.clearErrorsAndMessages (); 


} 
// 包 含 空 的 输入 校 验 方法 
public void validate() { 


} 
public Object clone() throws CloneNotSupportedException { 
return super.clone(); 


上 面 的 代码 中 见 到 的 ，ActionSupport 是 一 个 默认 的 Action 实现 类 ， 该 类 里 已 经 提供 了 许多 
这 些 默 认 方 法 包括 获取 国际 化 信息 的 方法 、 数 据 校 验 的 方法 、 默 认 的 处 理 用 户 请 求 的 方法 
，ActionSupport 类 是 Struts 2 默认 的 Action 处 理 类 ， 如 果 让 开发 者 的 Action 类 继承 该 
ActionSupport 类 ， 攻关 全 化 Action 放下 


提示 : 
Fs 因为 Rt 完全 符合 一 个 Action 的 要 求 ,所 以 我 们 可 以 直接 使 用 ActionSupport : 
”作为 业务 控制 器 .实际 上 ,如 果 我 们 配置 Action 没有 指定 class 属性 ( 即 没有 用 户 提供 Action | 
| ”类 )， 系 统 自动 使 用 ActionSupport 类 作为 Action 处 理 类 。 ] 


》>》》>3.5.2 Action 访问 Servlet API 


Struts 2 的 Action 没有 与 任何 Servlet AP1 耦合 , 这 是 Struts 2 的 一 个 改良 之 处 , 由 于 Action 类 不 再 
与 ServletAPI 耦合 ， 从 而 能 更 轻松 地 测试 该 Action。 

但 对 于 Web 应 用 的 控制 器 而 言 ， 不 访问 Servlet API 几乎 是 不 可 能 的 ， 例 如 跟踪 HTTP Session 状 
态 等 ,Struts 2 框架 提供 了 一 种 更 轻松 的 方式 来 访问 Servlet API。 Web 应 用 中 通常 需要 访问 的 Servlet API 
就 是 HttpServietRequest、HttpSession 和 ServletContext, 这 3 个 接口 分 别 代表 JSP 内 置 对 象 中 的 request、 
session 和 appliaction 。 

Struts 2 提供 了 一 个 ActionContext 类 ，Struts 2 的 Action 可 以 通过 该 类 来 访问 Servlet API。 下 面 是 
ActionContext 类 中 包含 的 几 个 常用 方法 。 

> Object get(Object key): 该 方法 类 似 于 调用 HttpServletRequest 的 getAttribute(String name) 

方法 。 

> ”Map getApplication(): 返回 一 个 Map 对 象 ， 该 对 象 模拟 了 该 应 用 的 ServiletContext 实例 。 

> static ActionContext getContext(): 静态 方法 ， 获 取 系统 的 ActionContext 实例 。 

> Map getParameters(): 获取 所 有 的 请 求 参数 。 类 似 于 调用 HttpServletRequest 对 象 的 

getParameterMap() 方 法 。 

> ”Map getSession(): 返回 一 个 Map 对 象 ， 该 Map 对 象 模拟 了 HttpSession 实例 。 
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> void setApplication(Map application): 直接 传 入 一 个 Map 实例 ,将 该 Map 实例 里 的 key-value 
对 转换 成 application 的 属性 名 、 属 性 值 。 
> void setSession(Map session): 直接 传 入 一 个 Map 实例 ， 将 该 Map 实例 里 的 key-value 对 
转换 成 session 的 属性 名 、 属 性 值 。 
位 于 codes\03\3.5\ 路 径 下 的 ActionContext 应 用 将 在 Action 类 中 通过 ActionContext 访 问 ServletAPL, 
该 Action 中 示范 了 向 request、session 和 application 范围 设置 属性 值 。 
程序 清单 ，codes\03\3.5\WActionContext\WEB-INFAsrcvorgverazyituappvaction\LoginAction java 


public class LoginAction implements Action 
{ 
private String username; 
private String password; 
省 略 username、Password 的 setter 和 getter 方法 


public String execute() throws Exception 
{ 
ActionContext ctx = ActionContext.getContext(); 
// 通 过 ActionContext 访问 application 范围 的 属性 值 
Integer counter = (Integer)ctx.getApplication() 
get ("counter") ; 
if (counter == null) 


counter = 17 
else 
counter = counter + 1; 


} 
// 通 过 ActionContext 设置 application 范围 的 属性 
ctx.getApplication() .put ("counter" , counter); 
// 通 过 ActionContext 设置 session 范围 的 属性 
ctx.getSession() .put ("user" , getUsername()); 
if (getUsername().equals ("crazyit.org") 

66 getPassword().equals("leegang") ) 


// 通 过 ActionContext 设置 request 范围 的 属性 
ctx.put ("tip”，" 服 务 器 提示 : 您 已 经 成 功 的 登录 ") ; 
return SUCCESS; 


// 通 过 ActionContext 设置 request 范围 的 属性 
ctx.put ("tip"” ，" 服 务 器 提示 : 登录 失败 ") ; 
return ERROR; 


} 
} 


上 面 的 程序 中 粗 体 字 代码 是 Action 操作 request、session 和 application 范围 内 属性 的 关键 代码 。 从 
上 面 代码 中 可 以 看 出 ， 该 Action 试图 从 application 范围 内 读 取 counter 属性 值 ， 如 果 该 属性 不 存在 ， 
则 设 竹 counter 为 1， 然 后 将 该 属性 放 入 application 范围 中 ， 如 果 该 counter 属性 存在 ， 则 将 该 counter 
属性 值 加 1 一 一 也 就 是 实现 了 一 个 简单 的 计数 器 功能 。 

上 面 Action 包含 了 username 和 password 两 个 属性 ， 则 意味 着 提交 到 该 Action 的 表单 里 应 包含 
username 和 password 两 个 属性 。 该 表单 页 代码 非常 简单 ， 位 于 codes\03\3.5ActionContext 路 径 下 的 
loginjsp 页 面 就 是 提交 请 求 的 表单 页 。 

在 struts.xml 文件 中 配置 上 面 的 LoginAction， 配 置 文件 代码 如 下 。 

程序 清单 : codes\033.5\ActionContext\WEB-INF\sre\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 


178 


http://52pdf.taobao.com 


3 


"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="conststruts.devMode"” value="true"/> 
<!-- Struts2 的 所 有 Action 都 需 位 于 package 下 --> 
<package name="lee" extends="struts-default"> 
<!-- 定义 名 为 login 的 Action， 其 实现 类 为 LoginAction 类 --> 
<action name="login" class="org.crazyit.app.action.LoginAction"> 
<!-- 如 果 处 理 结果 返回 error， 对 应 /error.jsp 视图 资源 --> 
<result name="error">/error.jsp</result> 
4 如 时 处 理 结果 返回 success， 对 应 /welcome. sp 视图 妆 源 > 
<result name="success">/welcome. jsp</resul 
</action> 
</package> 
</struts> 
上 面 的 配置 文件 中 粗 体 字 代码 标 出 : 当 LoginAction 返回 success 的 逻辑 视图 名 后 ， 系 统 将 会 使 用 
/welcomejsp 页 面 作为 实际 视图 资源 。/welcome.jsp 页 面 代码 如 下 。 
程序 清单 : codes\03\W3.5\ActionContext\welcome.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" $%> 
<1DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmil-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 成 功 页 面 </title> 
</head> 
<body> 
本 站 访问 次 数 为 ，$ {applicationScope.counter}<br/> 
${sessionScope.user}， 您 已 经 登录 ! <br/> 
S${requestScope.tip} 
</body> 
</html> 


上 面 页 面 的 粗 体 字 代码 使 用 了 表达 式 语言 来 输出 application、session 和 request 范围 内 的 指定 属性 
一 一 前 提 当 然 是 这 些 属性 存在 并 且 有 值 ， 这 些 值 当然 只 能 在 前 面 的 Action 中 设置 。 当 我 们 在 loginjsp 
页 面 的 表单 中 输入 crazyit.org 和 leegang 后 ， 提 交 表 单 将 看 到 如 图 3.7 所 示 的 结果 。 


Ls Ss 


图 3.7 Action 成 功 操作 request、session 和 application 范围 的 属性 


从 图 3.7 的 结果 来 看 ，Struts 2 的 Action 设计 非常 优秀 , 它 既 可 以 彻底 与 ServletAPI 分 离 ， 从 而 可 
以 允许 该 Action 脱离 Web 容器 运行 ， 也 就 可 以 脱离 Web 容器 来 测试 Action; 又 允许 用 简单 的 方式 来 
操作 request、session 和 application 范围 的 属性 。 


> >3.5.3 Action 直接 访问 Servlet API 


虽然 Struts 2 提供 了 ActionContext 来 访问 Servlet API， 但 这 种 访问 毕竟 不 是 直接 获得 Servlet API 
的 实例 。 为 了 在 Action 中 直接 访问 Servlet API，Struts 2 还 提供 了 如 下 几 个 接口 。 
> ”ServletContextAware: 实现 该 接口 的 Action 可 以 直接 访问 Web 应 用 的 ServletContext 实例 。 
> ”ServletRequestAware: 实现 该 接口 的 Action 可 以 直接 访问 用 户 请 求 的 HtpServletRequest 
实例 。 
> ServletResponseAware : 实现 该 接口 的 Action 可 以 直接 访问 服务 器 响应 的 
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HttpServletResponse 实例 - 
下 面 以 ServletResponseAware 为 例 ， 介 绍 如 何在 Action 中 访问 HttpServletResponse 对 象 。 本 应 用 
将 通过 HttpServletResponse 为 系统 添加 Cookie 对 象 , 本 应 用 将 继续 使 用 前 一 个 应 用 的 登录 页 面 ， 该 页 
面 提交 给 如 下 的 Action 处 理 。 
程序 清单 : codes\03\3.5\access-servlet-api\WEB-INF\src\org\crazyit\app\action\LoginAction.java 


public class LoginAction 

implements Action,ServletResponseAware 
{ 

private String username; 

private String password; 


Public void setServletResponse 人 苇 光 机 response) 
> this.response = response; 

六 凡 usernano DabovoLd 风 福 的 setter Nyettec 胃 法 

public String execute() throws Exception 


ActionContext ctx = ActionContext.getContext ();} 

// 通 过 ActionContext 访问 application 范围 的 属性 值 

Integer counter = (Integer)ctx.getApplication() 
.get ("counter"); 

if (counter == null) 


counter = 1; 
else 
counter = counter + 17 


} 
// 通 过 ActionContext 设置 application 范围 的 属性 
ctx.getApplication() .put ("counter" , counter); 
// 通 过 ActionContext 设置 session 范围 的 属性 
ctx.getSession() .put ("user" , getUsername()); 
if (getUsername() .equals("crazyit.org") 
&& getPassword() .equals("leegang") ) 
t 
// 通 过 response 添加 Cookie 
Cookie c = new Cookie("user" , getUsername()); 
c.setMaxAge(60 * 60); 
response.addCookie (c) ; 
// 通 过 ActionContext 设置 request 范围 的 属性 
ctx.put ("tip”，" 服 务 器 提示 ， 您 已 经 成 功 地 登录 ") ; 
return SUCCESS; 


else 


// 通 过 ActionContext 设置 request 范围 的 属性 
ctx.put ("tip”，" 服 务 器 提示 : 登录 失败 ") 7 
return ERROR; 


# 
} 
通过 查看 Struts 2 的 API 文档 ， 发 现实 现 ServletResponseAware 接口 ， 仅 要 求实 现 如 下 方法 : 
> public void setServletResponse(HttpServletResponse response) 
实现 上 面 的 方法 时 ， 该 方法 内 有 一 个 HttpServletResponse 参数 ， 该 参数 就 代表 了 Web 应 用 对 客户 
端的 响应 。 我 们 在 setServletResponse(HttpServletResponse response) 方 法 内 访问 到 Web 应 用 的 响应 对 象 ， 
并 将 该 对 象 设置 成 Action 的 成 员 属性 ， 从 而 允许 在 execute 方法 中 访问 该 HttpServletResponse 对 象 。 
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和 了 


与 此 类 似 的 是 ， 如 果 一 个 Action 实现 了 ServletRequestAware 接口 ， 则 必须 实现 如 下 方法 。 
> public void setServletRequest(HttpServletRequest request): 通过 该 方法 即 可 访问 代表 用 户 
请 求 的 HttpServletRequest 对 和 象 。 
如 果 Action 实现 了 ServletContextAware 接口 ， 则 必须 实现 如 下 方法 : 
> ”public void setServletContext(ServletContext context): 通过 该 方法 即 可 访问 到 代表 Web 应 
用 的 ServietContext 对 象 。 
当 上 面 的 LoginAction 处 理 完 用 户 请 求 后 ，Action 通过 HttpServletResponse 向 客户 端 中 添加 了 一 
个 Cookie 对 象 。 下 面 的 JSP 页 面 通过 表达 式 语言 来 访问 Cookie 值 , 其 中 访问 Cookie 的 代码 片段 如 下 。 
程序 清单 :codes\03\3.5\access-servlet-api\welcome.jsp 
从 系统 读 取 Cookie 值 : ${cookie.user.value}) 
上 面 的 页 面 中 粗 体 字 代码 使 用 表达 式 语 言 来 读 取 user Cookie 的 值 ， 在 表单 页 中 输入 crazyit.org、 
leegang 后 提交 请 求 ， 将 看 到 如 图 3.8 所 示 的 效果 。 


tie 
onergy 多 二 经 条 | 
顾 和 名 条 ， 纪 己 经 大功 的 如 录 
从 系统 读 职 Cookie 值 ，crazyit. or 


图 3.8 ”Action 通过 HttpServletResponse 添加 Cookie 成 功 


必须 指出 的 是 ， 虽 然 可 以 在 Action 类 中 获取 HttpServletResponse ， 但 如 果 希 望 通过 
HttpServletResponse 来 生成 服务 器 响应 是 不 可 能 的 ， 因 为 Action 只 是 业务 控制 器 。 即 如 果 在 Action 中 
书写 如 下 代码 : 


// 用 于 在 Servlet 中 直接 生成 响应 的 代码 
response, getWriter().printin("Hello World"); 


六 >3.5.4 使 用 ServletActionContext 访问 Servlet API 


除 此 之 外 ,为 了 能 直接 访问 ServletAPI，Struts 2 还 提供 了 一 个 ServletActionContext 工具 类 ， 这 个 
类 包含 了 如 下 儿 个 静态 方法 。 

> static PageContext getPageContext(): 取得 Web 应 用 的 PageContext 对 象 。 

> static HttpServletRequest getRequest(): 取得 Web 应 用 的 HttpServletRequest 对 象 。 

> _ static HttpServletResponse getResponse(): 取得 Web 应 用 的 HttpServletResponse 对 象 。 

> static ServletContext getServletContext(): 取得 Web 应 用 的 ServletContext 对 象 。 

借助 于 ServletActionContext 类 的 帮助 ,开发 者 也 可 以 在 Action 中 访问 Servlet API, 并 可 避免 Action 
类 需要 实现 XxxAware 接口 一 一 虽然 如 此 ， 但 该 Action 依然 与 Servlet API 直接 耦合 ， 一 样 不 利于 高 层 
次 的 解 辜 。 

借助 于 ServletActionContext 工具 类 的 帮助 ，Action 能 以 更 简单 的 方式 来 访问 Servlet API。 

将 前 一 个 示例 程序 稍 作 修改 ， 将 其 中 Action 类 改 为 使 用 ServletActionContext 来 访问 Servlet API， 
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修改 后 的 Action 代码 如 下 。 
程序 清单 : codes\03\3.5\ServletActionContext\WWEB-INF\src\org\crazyit\app\action\LoginAction.java 


public class LoginAction 
implements Action 
{ 
Private String username; 
Private String password; 
// 省 略 username 属性 的 setter 和 getter 方法 


public String execute() throws Exception 
{ 


ctx.getApplication() .put ("counter" , counter); 
// 通 过 ActionContext 设置 session 范围 的 属性 
ctx.getSession() .put ("user" , getUsername()); 
if (getUsername().equals("crazyit.org") 

66 getPassword() .equals("leegang") ) 


// 通 过 response 添加 cookie 
Cookie c = new Cookie("user" , getUsername()); 
c.setMaxAge(60 * 60); 
ServletActionContext.getResponse () .addCookie (c) ; 
// 通 过 ActionContext 设置 request 范围 的 属性 

ctx.put ("tip”，" 服 务 器 提示 : 您 已 经 成 功 的 登录 ") ; 
return SUCCESS; 


{ 


else 


// 通 过 ActionContext 设置 request 范围 的 属性 
ctx.put ("tip”， "服务器 提示 ， 登 录 失 败 ") ; 
return ERROR; 


) 


3.6 配置 Action 


实现 了 Action 处 理 类 之 后 , 就 可 以 在 stmuts.xml 文件 中 配置 该 Action 了 。 配置 Action 就 是 让 Struts 
2 知道 哪个 Action 处 理 哪个 请 求 ,也 就 是 完成 用 户 请 求 和 Action 之 间 的 对 应 关系 ,我 们 可 以 认为 , Action 
是 Struts 2 的 基本 “程序 单位 ”。 


》》3.6.1 包 和 命名 空间 


Struts 2 使 用 包 来 组 织 Action， 因 此 ， 将 Action 定义 放 在 包 定 义 下 完成 ， 定 义 Action 通过 使 用 
<package.… 记 下 的 <action... 人 > 子 元 素来 完成 ， 而 每 个 package 元 素 配置 一 个 包 。 

Struts 2 框架 中 核心 组 件 就 是 Action、 拦 截 器 等 ，Struts 2 框架 使 用 包 来 管理 Action 和 拦截 器 等 。 
每 个 包 就 是 多 个 Action、 多 个 拦截 器 、 多 个 拦截 器 引用 的 集合 。 

配置 <package.… 人 > 元 素 时 必须 指定 name 属性 ， 这 个 属性 是 引用 该 包 的 唯一 标识 。 除 此 之 外 ， 还 可 
以 指定 一 个 可 选 的 extends 属性 ，extends 属性 值 必须 是 另 一 个 包 的 name 属性 。 指 定 extends 属性 表示 
让 该 包 继承 另 一 个 包 ， 子 包 可 以 从 一 个 或 多 个 父 包 中 继承 到 拦截 器 、 拦 截 器 栈 、action 等 配置 。 

除 此 之 外 ，Struts 2 还 提供 了 一 种 所 谓 的 抽象 包 ， 抽 象 包 意味 着 该 包 不 能 包含 Action 定义 。 为 了 
显 式 指定 一 个 包 是 抽象 包 ， 可 以 为 该 <package... 人 元素 增加 abstract="true" 属 性 。 

在 struts.xml 文件 中 , <package... 信 元素 用 于 定义 包 配置 , 每 个 <package.../> 元 素 定义 了 一 个 包 配置 。 
定义 <package.… 人 > 元 素 时 可 以 指定 如 下 几 个 属性 。 
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> name: 这 是 一 个 必需 属性 ， 该 属性 指定 该 包 的 名 字 ， 该 名 字 是 该 包 被 其 他 包 引 用 的 key。 

> ”extends: 该 属性 是 一 个 可 选 属性 ， 该 属性 指定 该 包 继承 其 他 包 。 继 承 其 他 包 ， 可 以 继承 其 他 
包 中 的 Action 定义 、 拦 截 器 定义 等 。 

> namespace: 该 属性 是 一 个 可 选 属性 ， 该 属性 定义 该 包 的 命名 空间 。 

> ”abstract: 该 属性 是 一 个 可 选 属性 , 它 指定 该 包 是 否 是 一 个 抽象 包 。 抽象 包 中 不 能 包含 Action 
La 


六 类 训 
因为 Struts2 的 配置 文件 是 从 上 到 下 处 理 的 ， 所 以 父 包 应 该 在 于 包 前 面 定义 


下 面 是 一 个 简单 的 struts.xml 配置 文件 范例 。 在 下 面 的 struts.xml 文件 中 配置 了 两 个 包 ， 其 中 名 为 
default 的 包 继承 了 Struts 2 框架 的 默认 包 struts-default。 


<struts> 
<!-- 配置 第 一 个 包 ， 该 包 名 为 default， 继承 struts-default --> 
<package name="default" extends="struts-default"> 
<!- 下 面 定义 了 拦截 器 部 分 --> 
<interceptors> 
<!-- 定义 拦截 器 栈 --> 
<interceptor-stack name="crudStack"> 
<interceptor-ref name="params" /> 
<interceptor-ref name="defaultSstack" /> 
</interceptor-stack> 
</interceptors> 
<default-action-ref name="myAction"/> 
<!-- 定义 一 个 Action， 该 Action 直接 映射 到 show.jsp 页 面 --> 
<action name="show"> 
<result>show. jsp</result> 
</action> 
<!-- 定义 了 一 个 Action, 该 Action 类 为 DateAction --> 
<action name="Date" class="org.crazyit.app.action.DateAction"> 
<result name="success">/date.jsp</result> 
</action> 
</package> 
<!-- 定义 名 为 skill 的 包 ， 该 包 继承 default 的 包 --> 
<package name="skill" extends="default" namespace="/skill"> 
<!-- 定义 默认 的 拦截 器 引用 -> 
<default-interceptor-ref name="crudStackn/> 
<!-- 定义 名 为 Edit 的 Action， 该 Action 对 应 的 处 理 类 为 SkillAction --> 
<action name="Edit" class="lee.SkillAction"> 
<result>/empmanager/editSkil1.jsp</result> 
<interceptor-ref name="params" /> 
<interceptor-ref name="basicstack"/> 
</action> 
<1-- 定义 名 为 Save 的 Actiony 
该 Action 对 应 的 处 理 类 为 lee. SkillAction, 
使 用 save 方法 作为 处 理 方法 --> 
<action name="Save" class="lee.SkillAction" method="save"> 
<result name="input">/empmanager/editSkill.jsp</result> 
<result type="redirect">edit.action?skillName 
=${currentSkill.name}</result> 
</action> 
<!-- 定义 名 为 Delete 的 Action, 
该 Action 对 应 的 处 理 类 为 lee .SkillAction, 
使 用 delete 方法 作为 处 理 方法 -> 
<action name="Delete" class="lee.SkillAction" method="delete"> 
<result name="error">/empmanager/editskill.jsp</result> 
<result type="redirect">edit.action?skillName 
=${currentSkill.name}</result> 
</action> 
</package> 
</struts> 
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上 面 的 配置 文件 中 粗 体 字 代码 配置 了 两 个 包 ， 其 中 定义 名 为 skill 的 包 时 ,还 指定 了 该 包 的 命名 空 
间 为 /skill。 

可 能 有 读者 对 上 面 的 配置 文件 中 第 一 个 package 定义 感到 奇怪 ， 这 个 package 定义 继承 了 一 个 
struts-default 父 包 ， 那 这 个 父 包 从 何 而 来 呢 ? 如 果 我 们 用 WinRAR 打开 struts2-core-2.2.1jar 文件 ， 将 
在 该 压缩 文件 中 看 到 一 个 stmuts-defaultxml 文件 ， 该 文件 内 包含 如 下 片段 : 

<!-- struts-default.xml 文件 中 定义 的 默认 包 --> 

<package name="struts-default" abstract="true"> 
</package> 

从 上 面 的 配置 片段 可 以 看 出 ,struts2-core-2.2.1.jar 里 已 经 定义 了 struts-default 抽象 包 , 该 包 下 包含 
了 大 量 结果 类 型 定义 、 拦 截 器 定义 、 拦 截 器 引用 定义 等 ， 这 些 定义 是 配置 普通 Action 的 基础 ， 所 以 开 
发 者 定义 的 package 通常 应 该 继承 struts-default 包 。 


| 实际 上 所 有 Struts 2 插件 文件 者 人 提供 一 个 struts-pluginxml 文件 ， 而 不 同 插件 的 
! struts-plugin.xml 文件 会 定义 另 一 个 抽象 包 ， 用 于 被 需要 使 用 该 插件 的 开发 者 继承 。 如果 
| 我 们 需要 使 用 Struts 2 的 某 个 插件 ， 可 能 需要 Struts 2 插件 文件 中 定义 的 包 。 可 


从 前 面 的 内 容 可 以 看 出 ， 每 次 定义 一 个 package 元 素 时 ， 都 可 以 指定 一 个 namespace 属 
指定 该 包 对 应 的 命名 空间 。 

Struts 2 之 所 以 提供 命名 空间 的 功能 , 主要 是 为 了 处 理 同一 个 Web 应 用 中 包含 同名 Action 的 情形 。 
Struts 2 以 命名 空间 的 方式 来 管理 Action， 同 一 个 命名 空间 里 不 能 有 同名 的 Action， 不 同 的 命名 空间 里 
可 以 有 同名 的 Action。 

Struts 2 不 支持 为 单独 的 Action 设置 命名 空间 , 而 是 通过 为 包 指定 namespace 属性 来 为 包 下 面 的 所 
有 Action 指定 共同 的 命名 空间 。 如 果 配 置 <package.…/> 时 没有 指定 namespace 属性 ， 则 该 包 下 的 所 有 
Action 处 于 默认 的 包 空间 下 。 

下 面 以 一 个 示例 应 用 来 说 明 Struts 2 命名 空间 的 用 法 。 看 下 面 的 struts.xml 配置 文件 代码 ， 这 份 配 
置 文件 中 配置 了 两 个 package， 并 为 后 一 个 package 指定 命名 空间 为 /book。 

程序 清单 ，codes\03\3.6mamespace\WEB-INF\srcstruts.xml 

<?xml version="1.0" encoding="GBK"?> 
<!1DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.devMode" value="true"/> 
<!-- 下 面 配置 名 为 lee 的 包 ， 该 包 继承 了 Struts 2 的 默认 包 
没有 指定 命名 空间 ， 将 使 用 默认 命名 空间 --> 
<package name="lee" extends="struts-default"> 
<!-- 配置 一 个 名 为 login 的 Action --> 
<action name="login" class="org.crazyit.app.action. LoginAction"> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
<!-- 下 面 配置 名 为 get 的 包 ， 该 包 继承 了 Struts 2 的 默认 包 。 指 定 该 包 的 命名 空间 为 /book--> 
<package name="get" extends="struts-default" namespace="/book"> 
<!-- 配置 一 个 名 为 getBooks 的 Action --> 
<action name="getBooks" class="org.crazyit.app.action.GetBooksAction"> 
<result name="login">/login.jsp</result> 
<result name="success">/showBook.jsp</result> 
</action> 
</package> 
</struts> 
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在 上 面 的 struts.xml 配置 文件 中 ， 配 置 了 两 个 包 : lee 和 get， 配 置 get 包 时 ， 粗 体 字 代码 配置 了 该 
包 的 命名 空间 为 /book。 

对 于 名 为 lee 的 包 而 言 , 没有 指定 namespace 属性 。 如 果 某 个 包 没有 指定 namespace 属性 ， 即 该 包 
使 用 默认 的 命名 空间 。 

当 某 个 包 指定 了 命名 空间 后 ， 该 包 下 所 有 的 Action 处 理 的 URL 应 该 是 命名 空间 +Action 名 。 以 上 
面 名 为 get 的 包 为 例 ， 该 包 下 包含 了 名 为 getBooks 的 Action， 则 该 Action 处 理 的 URL 为 : 

nin GetBooks 的 URL。 其 中 8888 是 笔者 的 Tomcat 服务 端口 ，namespace 是 应 用 名 

由 是 该 Action 所 在 包 对 应 的 命名 空间 ， 而 getBooks 是 Action 名 

A //1localhost:8888/namespace/book/getBooks .action 


从 上 面 的 内 容 可 以 看 出 ，Struts 2 命名 空间 的 作用 类 似 于 Strutsl 里 模块 的 作用 。 


提示 : 
Fea Struts 2 的 命名 空间 的 作用 等 同 于 Struts 1 里 模块 的 作用 ， 它 允许 以 模块 化 的 方式 来 组 
织 Action。 


除 此 之 外 ，Struts 2 还 可 以 显示 指定 根 命名 空间 ， 通 过 设置 某 个 包 的 namespace="/" 来 指定 根 命名 
空间 。 

如 果 请 求 为 /barspace/bar.action， 系 统 首先 查找 /barspace 命名 空间 里 名 为 bar 的 Action， 如 果 在 该 
命名 空间 里 找到 对 应 的 Action， 则 使 用 该 Action 处 理 用 户 请 求 : 否则 ， 系 统 将 到 默认 命名 空间 中 查找 
名 为 bar 的 Action， 如 果 找 到 对 应 的 Action， 则 使 用 该 Action 处 理 用 户 请 求 ， 如 果 两 个 命名 空间 里 都 
投 不 到 名 为 bar 的 Action， 则 系统 出 现 错误 。 


默认 命名 空间 里 的 Action 可 以 处 理 任何 命名 空间 下 的 Action 请 求 . 意思 是 说 ， 如 果 
存在 URL 为 /barspace/bar.action 的 请 求 ， 并 且 /barspace 的 命名 空间 下 没有 名 为 bar 的 
Action， 则 默认 命名 空间 下 名 为 bar 的 Action 也 会 处 理 用 户 请 求 。 但 根 命名 空间 下 的 
Action 只 处 理 根 命 名 纸 间 下 的 Action 请 求 ， 这 是 根 命名 空间 大 于 从 布 有 空间 的 区 别 。 


ction, 系统 会 在 根 命名 空间 (“/”) 中 查找 名 为 login 的 Action， 如 果 在 根 命名 
空间 中 找到 了 名 为 login 的 Action， 则 由 该 Action 处 理 用 户 请 求 ， 否则 ， 系 统 将 转 入 默认 空间 中 查找 
名 为 login 的 Action， 如 果 默 认 的 命名 空间 里 有 名 为 login 的 Action， 则 由 该 Action 处 理 用 户 请 求 ， 如 
果 两 个 命名 空间 里 都 找 不 到 名 为 login 的 Action， 则 系统 出 现 错误 。 

ie 注意 :YY 
| 命名 空间 只 有 一 个 级 别 。 如 果 请 求 的 URL 是 /bookservice/search/get.action， 系 统 将 

| 先 在 /bookservice/search 的 命名 空间 下 查找 名 为 get 的 Action， 如 果 在 该 命名 空间 内 找到 
i 名 为 get 的 Action, 则 由 该 Action 处 理 用 户 请 求 ; 如 果 在 该 命名 空间 内 没有 找到 名 为 get 
i 的 Action， 系 统 将 直接 进入 默认 的 命名 空间 查找 名 为 get 的 Action， 而 不 会 在 by 


人 
| 
i 


/bookservice 的 命名 空间 下 查找 名 为 Bet 


》>》》>3.6.2 Action 的 基本 配置 


定义 Action 时 ， 至 少 需要 指定 该 Action 的 name 属性 ， 该 name 属性 既是 该 Action 的 名 字 ， 也 指 
定 了 该 Action 所 处 理 的 请 求 的 URL。 
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着 a aa 
Struts 2 的 Action 名 字 就 是 它 所 处 理 的 URL ( 如 果 请 求 URL 包含 .action 0 后 级 ， 则 应 


该 去 掉 .action 后 缓 再 匹配 ) 与 Struts 1 不 同 ，Struts 1 的 Action 配置 中 的 name 属性 指定 
的 是 该 Action 关联 的 ActionForm， 而 path 属性 才 是 该 Action 处 理 的 URL。 可 以 理解 ， 证 


Struts 2 中 Action 的 name 属性 的 作用 类 似 于 Struts 1 中 Action 的 path 属性 。 


除 此 之 外 常 还 需要 为 action 元 素 指定 一 个 class 属性 , 其 中 class 属性 指定 了 该 Action 的 实现 类 。 


本 
-和 三 -注意 :站 

class 属性 并 不 是 必需 的 ， 如果 我 们 不 为 <action .../> 元 素 指定 class 属性 ， 系 统 则 默认 
使 用 系统 的 ActionSupport 类 . 


因此 ， 一 个 Action 的 配置 片段 通常 有 如 下 类 似 结构 : 


<package> 
<!-- 配置 处 理 login,action 请 求 的 Action， 其 实现 类 为 lee.LoginRction --> 
<action name="login" class="lee.LoginAction"/> 
<package> 
Action 只 是 一 个 逻辑 控制 器 ， 它 并 不 直接 对 浏览 者 生成 任何 响应 。 因 此 ，Action 处 理 完 用 户 请 求 
后 ，Action 需要 将 指定 的 视图 资源 呈现 给 用 户 。 因 此 ， 配 和 Action 时 应 该 配置 逻辑 视图 和 物理 视图 资 
源 之 间 的 对 应 关系 。 
配置 逻辑 视图 和 物理 视图 之 间 的 映射 关系 是 通过 <result .… > 元 素来 定义 的 , 每 个 <result .人 > 元 素 定 
义 迎 辑 视图 和 物理 视图 之 间 的 一 次 映射 。 
完整 的 Action 配置 片段 如 下 : 


<package> 
<!-- 配置 处 理 login.action 请 求 的 Action， 其 实现 类 为 lee.LoginAction --> 
in" class="lee,.LoginAction"> 


1t 元 素 定 义 一 个 逻辑 视图 名 和 物理 视图 的 映射 关系 -> 


<result 
<result 
</action> 
<package> 
关于 <action... 人 > 的 子 元 素 <result... 人 > 的 配置 在 下 一 节 中 会 有 更 详细 的 讲解 。 
定义 <action... 人 > 元 素 时 ， 需 要 指定 name 属性 ， 通 常 name 属性 通常 由 字母 和 数字 组 成 ， 如 果 需 要 
在 name 属性 中 使 用 斜 线 (/), 则 需要 指定 Struts 2 允许 Action name 中 出 现 斜 线 。 设置 允许 Action name 
中 出 现 斜 线 通过 struts.enable.SlashesInActionNames 常量 指定 ， 设 置 该 常量 的 值 为 tue， 即 允许 Action 
名 中 使 用 和 斜 线 。 
虽然 Action 的 name 命名 可 以 非常 灵活 , 但 如 果 为 name 属性 分 配 一 个 带 点 (.) 或 者 带 中 画 线 (-) 
的 值 ， 例 如 my.user 或 者 my-action 等 ， 则 可 能 引发 一 些 未 知 异常 。 因 此 ， 不 推荐 在 Action 的 name 属 
性 值 中 使 用 点 〈.) 和 中 画 线 〈(-)。 


和 3.6.3 使 用 Action 的 动态 方法 调用 


Strutsl 提供 了 DispatchAction， 从 而 允许 一 个 Action 内 包含 多 个 控制 处 理 逻 辑 。 例 如 对 于 同一 个 
表单 ， 当 用 户 通过 不 同 的 提交 按钮 来 提交 同一 个 表单 时 ， 系 统 需要 使 用 Action 的 不 同方 法 来 处 理 用 户 
请 求 ， 这 就 需要 让 同一 个 Action 里 包含 多 个 控制 处 理 逻 辑 。 


186 


http://52pdf.taobao.com 


3 


Struts 2 同样 提供 了 这 种 包含 处 理 多 个 处 理 逻 辑 的 Action， 看 如 图 3.9 所 示 的 JSP 页 面 。 


图 3.9 包含 两 个 提交 按钮 的 JSP 页 面 


上 面 的 JSP 页 面包 含 两 个 提交 按钮 ， 但 分 别提 交 给 Action 的 不 同方 法 处 理 ， 其 中 “登录 ”按钮 希 
望 使 用 登录 逻辑 来 处 理 请 求 ， 而 “注册 ”按钮 则 希望 使 用 注册 逻辑 来 处 理 请 求 。 

此 时 ， 可 以 采用 DMI (Dynamic Method Invocation， 动 态 方法 调用 ) 来 处 理 这 种 请 求 。 动 态 方法 
调用 是 指 表 单元 素 的 action 并 不 是 直接 等 于 某 个 Action 的 名 字 ， 而 是 以 如 下 形式 来 指定 表单 的 action 
-~ action 属性 为 actionName !methodName 的 形式 

其 中 ActionName 指定 提交 到 哪个 Action， 而 methodName 指定 提交 到 指定 方法 --> 


action="ActionName methodName " 


上 面 的 JSP 页 面 的 “注册 ”按钮 的 代码 如 下 : 


<!-- “注册 ”按钮 是 一 个 没有 任何 动作 的 按钮 ， 但 单 击 该 按钮 时 触发 regist 函数 -> 
<input type="submit" value=" 注 册 ”onclick="regist() ;"/> 


上 面 的 代码 中 粗 体 字 代 码 指定 单 击 “ 注 册 ” 按 钮 时 将 触发 regist 函数 ， 该 函数 的 代码 如 下 : 


function regist() 


{ 
// 获 取 页 面 的 第 一 个 表单 
targetForm = document.forms[0]; 
// 动 态 修改 表单 的 action 属性 
targetForm. action = "login!regist"; 
} 


上 面 的 JavaScript 代码 中 粗 体 字 代码 改变 了 表单 元 素 的 action 属性 ， 修 改 后 action 属性 为 : 
logintregist， 其 实质 就 是 将 该 表单 提交 给 login Action 的 regist 方法 处 理 。 
LoginRegistAction 类 的 代码 如 下 。 
程序 清单 ，codes\03W3.6\dmi\WEB-INF\src\org\crazyit\app\action\LoginRegistAction.java 


public class LoginRegistAction 
extends ActionSupport 


// 对 装 用 户 请 求 参数 的 两 个 属性 

private String username; 

private String password; 

// 封 装 处 理 结果 的 tip 属性 

private String tip; 

// 省 略 三 个 属性 对 应 的 setter 和 getter 方法 

/7Action 包含 的 注册 控制 逻辑 

public String regist() throws Exception 

{ 
ActionContext .getContext () .getsession() 

-put("user" , getUsername()); 

setTip(" 若 喜 您 ,”+ getUsername () +“", 和 化 已 经 注册 成 功 ! ") ; 
return SUCCESS; 


} 

//Action 默认 包含 的 控制 远 辑 

public String execute() throws Exception 
{ 


{ 


if (getUsername().equals("crazyit.org") 


187 


http://52pdf.taobao.com 
米 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


65 getPassword() .equals("leegang") ) 


ActionContext .getContext () .getSession() 

-Put ("user" , getUsername()); 
setTip ("欢迎 ,”+ getUsername () + "您 已 经 登录 成 功 ! ") ; 
return SUCCESS; 


return ERROR; 


上 面 的 Action 代码 中 粗 体 字 代码 定义 了 该 Action 里 包含 的 regist 控制 逻辑 ， 在 默认 情况 下 ， 用 户 
请 求 不 会 提交 给 该 方法 。 例 如 ， 如 图 3.9 所 示 的 JSP 页 面 中 的 “登录 ”按钮 只 是 一 个 普通 按钮 ， 当 浏 
览 者 单 击 “ 登 录 ” 按 钮 时 ， 系 统 将 提交 给 LoginRegistAction 的 默认 方法 处 理 。 

Er 当 浏 览 者 单 击 “ 注 册 ” 按 钮 时 , 该 表单 的 action 被 修改 为 : 
login!regist， 系 统 将 提交 给 login Action ( 即 LoginRegistAction 
处 理 类 ) 的 regist 方法 处 理 。 因 此 ， 如 果 单 击 “ 注 册 ” 按 钮 ， 
将 看 到 如 图 3.10 所 示 的 页 面 。 

通过 这 种 方式 ,我 们 可 以 在 一 个 Action 中 包含 多 个 处 理 罗 
图 3.10 动态 方法 调用 辑 ， 并 通过 为 表单 元 素 指定 不 同 action 属性 来 提交 给 Action 
的 不 同方 法 。 
对 于 使 用 动态 方法 调用 的 方法 , 例如 regist 方法 ， 该 方法 的 方法 声明 与 系统 默认 的 execute 方法 的 
方法 只 有 方法 名 不 同 ， 其 他 部 分 如 形 参 列 表 、 返 回 值 类 型 都 应 该 完全 相同 。 


家 
和 
| 使 用 动态 方法 调用 颂 设 置 Struts 2 允许 动态 方法 调用 。 开启 系统 的 动态 方法 调 i 
| 用 是 通过 设置 struts.enable.DynamicMethodInvocation 常量 完成 的 ， 设 置 该 常量 的 值 为 。 < 
| 


> 3.6.4 指定 method 属性 及 使 用 通配符 


对 于 如 图 3.9 所 示 的 JSP 页 面 情 形 ， 即 一 个 表单 里 包含 多 个 提交 按钮 ， 需 要 分 别提 交 给 不 同 的 控 
制 逻辑 ，Struts 2 还 提供 了 一 种 处 理 方法 ,即将 一 个 Action 处 理 类 定义 成 多 个 逻辑 Action。 这 种 做 法 非 
常 类 似 于 Strutsl 提供 的 MappingDispatchAction 类 ， 它 可 以 将 一 个 Action 类 配置 成 多 个 逻辑 Action。 

如 果 在 配置 <action … 亿 元素 时 ， 可 以 为 它 指定 method 属性 ， 则 可 以 让 Action 调用 指定 方法 、 而 
不 是 execute 方法 来 处 理 用 户 请 求 。 

例如 ， 我 们 可 以 有 如 下 的 配置 片段 : 


<!-- 定义 名 为 login 的 Action， 该 Action 的 实现 类 为 LoginAction, 
处 理 用 户 请 求 的 方法 为 login --> 
<action name="login" class="org.crazyit.app.action.LoginAction" method="login" /> 


</action> 
通过 这 种 方式 可 以 将 一 个 Action 类 定义 成 多 个 逻辑 Action, 即 Action 类 的 每 个 处 理 方法 都 映射 成 
-个 逻辑 Action， 前 提 是 这 些 方法 具有 相似 的 方法 签名 : 方法 形 参 列表 为 空 ， 方 法 返回 值 为 String。 
下 面 是 本 示例 的 struts.xml 文件 代码 。 
程序 清单 :codes\03\3.6\method\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
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"-//Apache Software Foundation//DTD struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!-- 配置 login Action， 处 理 类 为 LoginRegistAction 
默认 使 用 execute 方法 处 理 请 求 一 > 
<action name="login" class="org.crazyit.app.action.LoginRegistAction"> 
<!-- 定义 逻辑 视图 和 物理 视图 之 间 的 映射 关系 --> 
<result name="input">/login.jsp</result> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
<!-- 配置 regist Action， 处 理 类 为 LoginRegistAction 
指定 使 用 regist 方法 处 理 请 求 --> 
<action name="regist" class="org.crazyit.app.action.LoginRegistAction" 
method="regist"> 
<!-- 定义 逻辑 视图 和 物理 视图 之 间 的 映射 关系 --> 
<result name="input">/login.jsp</result> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
</struts> 


上 面 定义 了 login 和 regist 两 个 逻辑 Action， 它 们 对 应 的 处 理 类 都 是 LoginRegistAction， 该 Action 
类 代码 前 面 已 经 给 出 ， 此 处 不 再 鳌 述 。login 和 regist 两 个 Action 虽然 有 相同 的 处 理 类 ， 但 处 理 逻 辑 不 
同一 一 处 理 逻 辑 通 过 method 方法 指定 ， 其 中 名 为 login 的 Action 对 应 的 处 理 逻 辑 为 默认 的 execute 方 
法 ， 而 名 为 regist 的 Action 对 应 的 处 理 逻 辑 为 指定 的 regist 方法 ， 如 程序 中 粗 体 字 代码 所 示 。 

通过 上 面 的 介绍 不 难看 出 ， 当 我 们 配置 Action 时 ， 实 际 上 可 认为 需要 配置 三 个 属性 ，name 指定 
该 Action 处 理 怎样 的 请 求 ， 该 属性 不 可 省 略 ，class 属性 指定 该 Action 的 处 理 类 ， 该 属性 被 省 略 ， 默 
认 使 用 ActionSupport 作为 处 理 类 ; method 属性 指定 使 用 哪个 方法 处 理 请 求 , 如 果 省 略 该 method 属性 ， 
则 默认 使 用 execute 方法 处 理 请 求 。 

将 一 个 Action 处 理 类 定义 成 两 个 逻辑 Action 后 , 可 以 再 修改 JSP 页 面 的 JavaScript 代码 。 修 改 regist 
函数 的 代码 为 如 下 形式 : 

function regist() 

; // 获 取 页 面 的 第 一 个 表单 
targetForm = document .Forms[0]7 
// 动 态 修改 表单 的 action 属性 

targetForm .action = "regist"; 

通过 这 种 方式 ， 一 样 可 以 实现 上 面 的 效果 。 当 浏览 者 单 击 “ 登 录 ” 按 钮 时 ， 将 提交 给 Action 类 的 
登录 逻辑 处 理 ， 当 浏览 者 单 击 “ 注 册 ” 按 钮 时 ， 将 提交 给 Action 类 的 注册 逻辑 处 理 。 在 这 种 方式 下 ， 
用 户 通 过 “注册 ”按钮 和 “登录 ”按钮 将 提交 到 两 个 不 同 的 逻辑 Action， 虽 然 这 两 个 逻辑 Action 依然 
使 用 相同 的 Action 处 理 类 。 

再 次 查看 上 面 的 struts.xml 文件 中 两 个 <action .… 人 > 元 素 定义 , 我 们 发 现 两 个 action 定义 的 绝 大 部 分 
相同 ， 可 见 这 种 定义 相当 元 余 。 为 了 解决 这 个 问题 ，Struts 2 还 有 另 一 种 形式 的 动态 方法 调用 使 用 通 
配 符 的 方式 。 

在 配置 <action .… 人 > 元 素 时 ， 人 允许 在 指定 name 属性 时 使 用 模式 字符 串 〈 即 用 “* ”代表 一 个 或 多 个 
任意 字符 )， 接 下 来 就 可 以 在 class、method 属性 及 <result.. 人 > 子 元 素 中 使 用 {N} 的 形式 来 代表 前 面 第 N 
个 星 号 (*) 所 匹配 的 子 串 。 

当 我 们 在 Action 的 name 属性 中 使 用 通配符 后 ， 可 用 一 个 <action .…. 人 > 元 素 代替 多 个 逻辑 Action。 

看 下 面 的 struts.xml 配置 文件 代码 。 

程序 清单 : codes\03\3.6Wwildcard1\WEB-INF\src\struts.xml 
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<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!-- 使 用 模式 字符 串 定义 Action 的 name， 指 定 所 有 以 Action 结尾 的 请 求 ， 
都 可 用 LoginRegistAction 来 处 理 ，method 属性 使 用 {1}， 
这 个 {1} 代 表 进行 模式 匹配 时 第 一 个 * 所 代替 的 字符 串 -> 
<action name="*Action" class="org.crazyit.app.action.LoginRegistAction" 
method=" {1}"> 
<!-- 定义 逻辑 视图 和 物理 视图 之 间 的 映射 关系 --> 
<result name="input">/login.jsp</result> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 <action name="*Action”.… 信 元素 不 是 定义 了 一 个 普通 Action， 而 是 定义 了 一 系列 的 逻辑 
Action 一 一 只 要 用 户 请 求 的 URL 是 *Action.action 的 模式 ， 都 可 使 用 该 Action 来 处 理 。 配 置 该 action 
元 素 时 ， 还 指定 method 属性 (method 属性 用 于 指定 处 理 用 户 请 求 的 方法 )， 但 该 method 属性 使 用 了 

-个 表达 式 {1}， 该 表达 式 的 值 就 是 name 属性 值 中 第 一 个 * 的 值 。 例 如 ， 如 果 用 户 请 求 的 URL 为 
loginAction.action, 则 调用 lee.LoginRegistAction 类 的 login 方法 ; 如 果 请 求 URL 为 registAction.action， 
则 调用 lee.LoginRegistAction 类 的 regist 方法 。 

下 面 是 本 应 用 所 使 用 的 LoginRegistAction 类 的 代码 。 

程序 清单 :codes\03W3.6Wwildcard1\WEB-INF\src\org\crazyit\app\action\LoginRegistAction 

public class LoginRegistAction 
extends RctionSupport 

: // 封 装 用 户 请 求 参数 的 两 个 属性 
private String username; 
private String password; 


// 封 装 处 理 结果 的 tip 属性 
private String tip; 
// 省 略 三 个 属性 对 应 的 setter 和 getter 方法 


//Action 包 人 的 注册 控制 逻辑 
Public String regist() throws Exception 
{ 


ActionContext .getContext () .getSession() 

.put ("user" , getUsername()); 
setTip(" 茵 喜 您 , ”+ getUsername() + "， 您 已 经 注册 成 功 ! ") 7 
return SUCCESS; 


} 

//Action 包含 的 登录 控制 逻辑 

public String login() throws Exception 
{ 


if (getUsername().equals("crazyit.org") 
66 getPassword() .equals ("leegang") ) 


ActionContext .getContext () .getSession() 

:put ("user" , getUsername()); 
setTip (" 欢 迎 , ”+ getUsername () + ", 您 已 经 登录 成 功 ! "); 
return SUCCESS; 


return ERROR; 


从 上 面 程序 的 粗 体 字 代 码 中 可 以 看 出 :该 Action 类 不 再 包含 默认 的 execute 方法 ,而 是 包含 了 regist 
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和 login 两 个 方法 ， 这 两 个 方法 与 execute 方法 签名 非常 相似 ， 只 是 方法 名 不 同 。 
同样 对 于 如 图 3.9 所 示 的 页 面 ， 我 们 修改 JavaScript 中 regist0 函 数 为 如 下 形式 : 
function regist() 


{ 

// 获 取 页 面 中 第 一 个 表单 

targetForm = document .forms{0]; 

// 动 态 修改 表单 的 action 属性 

targetForm. action = "registAction "; 
} 


从 上 面 的 方法 中 可 以 看 到 ， 当 浏览 者 单 击 “ 注 册 ” 按 钮 时 ， 动 态 修改 表单 的 action 属性 为 
registAction， 该 请 求 匹 配 了 *Action 的 模式 ， 将 交 给 该 Action 处 理 ; registAction 匹配 *Action 模式 时 ， 
* 的 值 为 regist， 则 调用 regist 方法 来 处 理 用 户 请 求 。 

除 此 之 外 ， 当 <action... 人 > 元 素 的 name 属性 使 用 了 * 之 后 ，<action … 信 元素 的 class 属性 也 可 以 使 用 
{N} 表 达 式 ， 即 Struts 2 允许 将 一 系列 的 Action 类 配置 成 一 个 <action .…/> 元 素 ， 相 当 于 一 个 <action .…/> 
元 素 配置 了 多 个 逻辑 Action 。 

看 下 面 的 struts.xml 配置 文件 。 

程序 清单 :codes\03\3.6\wildcard2\WEB-INF\src\struts.xml 


<?xml version="l.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!-- 使 用 模式 字符 串 定义 Action 的 name， 指 定 所 有 以 Action 结尾 的 请 求 ， 
都 可 用 {1}Action 来 处 理 ， 
这 个 11} 代表 进行 模式 匹配 时 第 一 个 * 所 代替 的 字符 串 一 
<action name="*Action" class="org.crazyit.app.action.{1)Action"> 
<!-- 定义 逻辑 视图 和 物理 视图 之 间 的 映射 关系 -> 
<result name="input">/login.jsp</result> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 <action .…> 定 义 片段 定义 了 一 系列 的 Action， 这 系列 的 Action 名 字 应 该 匹配 *Action 的 模 
式 ， 没 有 指定 method 属性 ， 即 默认 使 用 execute 方法 来 处 理 用 户 请 求 。 但 class 属性 值 使 用 了 {N} 形 式 
的 表达 式 ， 上 面 配置 片段 的 含义 是 ， 如 果 有 URL 为 RegistAction.action 的 请 求 ， 将 可 以 匹配 *Action 
模式 ， 交 给 该 Action 处 理 ， 其 第 一 个 “*” 的 值 为 Regist， 即 该 Action 的 处 理 类 为 RegistAction; 类 似 
的 ， 如 果 有 URL 为 LoginAction.action 的 请 求 ， 则 处 理 类 为 LoginAction。 为 此 ， 如 果 我 们 需要 系统 地 
处 理 RegistAction 和 LoginAction 两 个 请 求 ， 则 必须 提供 LoginAction 和 RegistAction 两 个 处 理 类 ， 这 
两 个 文件 可 以 在 codes\03\3.6\wildcard2\WWEB-INF\src\org\crazyitapp\action 路 径 下 找到 。 
当然 ， 我 们 应 该 将 如 图 3.9 所 示 页 面 的 regist 函数 改 为 如 下 形式 : 
function regist{) 
// 获 取 页 面 中 第 一 个 表单 
targetForm = document.forms[0]7 


// 动 态 修改 表单 的 action 属性 
targetForm.action = "RegistAction "; 


} 
如 果 有 需要 ，Struts 2 完全 可 以 在 class 属性 和 method 属性 中 同时 使 用 {N} 表 达 式 。 看 如 下 配置 片段 : 


<!-- 定义 了 一 个 action， 同 时 在 class 属性 和 method 属性 中 使 用 表达 式 --> 
<action name="*_*" method="{2}" class="actions. {1}"> 


上 面 的 定义 片段 定义 了 一 个 模式 为 * * 的 Action， 即 只 要 匹配 该 模式 的 请 求 ， 都 可 以 被 该 Action 
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处 理 。 如 果 有 URL 为 Book_save.action 的 请 求 ， 因 为 匹配 了 * * 的 模式 ， 且 第 一 个 “*” 的 值 为 Book， 
第 二 个 “* ”的 值 为 save， 则 意味 着 调用 actions.Book 处 理 类 的 save 方法 来 处 理 用 户 请 求 。 

后 面 将 会 介绍 针对 Action 的 输入 校 验 ， 在 对 Action 进行 输入 校 验 时 ， 必 须 为 该 Action 指定 对 应 
的 校 验 文件 。 那 么 对 于 模式 为 * * 的 Action， 应 该 定义 怎样 的 校 验 文件 呢 ? 

因为 Struts 2 默认 的 校 验 文件 命名 遵守 如 下 规则 :ActionName-validation.xml， 即 如 果 有 类 名 为 
MyAction 的 Action 类 ， 则 应 该 提供 名 为 MyAction-validation .xml 的 文件 。 

但 对 于 上 面 的 <action .…. 人 配置 元 素 , class 属性 值 是 一 个 表达 式 , 这 个 表达 式 的 值 来 自 于 前 面 action 
的 name 属性 。 例如， 如 果 有 URL 为 Book_save.action 的 请 求 ， 则 该 Action 对 应 的 处 理 类 为 Book， 对 
应 的 数据 校 验 文件 名 为 Book-validation. xml。 实际 上 Struts 2 允许 指定 校 验 文件 时 精确 到 处 理 方法 ， 即 
指定 如 下 形式 的 校 验 文件 ，ActionName-methodName-validation.xml， 所 以 对 于 Book_save.action 的 请 
求 ， 系 统 将 优先 使 用 Book-save-validation.xml 校 验 文件 。 

即使 对 于 eclass 属性 值 固定 的 Action, 同样 可 以 为 一 个 Action 类 指定 多 个 校 验 文件 ,看 如 下 的 Action 
人 Action， 指 定 了 固定 的 class 属性 ， 而 method 属性 使 用 表达 式 --> 

<action name="Crud *" class="lee.Crud" method="{1}"> 

在 上 面 的 配置 片段 中 ， 指 定 了 该 Action 的 实现 类 为 lee.Crud。 该 Action 的 name 是 一 个 模式 字符 
串 ， 则 该 Action 将 可 以 处 理 所 有 匹配 Crud_* 的 请 求 。 

假设 有 URL 为 Crud_input 的 请 求 ， 该 请 求 匹配 了 Crud_* 的 模式 ， 故 该 Action 可 以 处 理 该 请 求 。 
对 于 该 请 求 ，Struts 2 将 采用 Crud_input-validation.xml 校 验 文件 来 进行 数据 校 验 。 
关于 数据 校 验 的 详细 介绍 ， 请 参阅 本 书 下 一 章 的 内 容 。 
实际 上 ，Struts 2 不 仅 允许 在 class 属性 、name 属性 中 使 用 表达 式 ， 还 可 以 在 <result .…/> 子 元 素 中 
使 用 {N} 表 达 式 。 下 面 提供 了 一 个 通用 Action， 该 Action 可 以 配置 成 如 下 形式 : 

<!-- 定义 一 个 通用 Action --> 


<action name="*" > 
<!-~ 使 用 表达 式 定义 Result 一 > 
<result>/{1} .jsp</result> 
</action> 


在 上 面 的 Action 定义 中 ，Action 的 名 字 是 一 个 “*”， 即 它 可 以 匹配 任意 的 Action， 所 有 的 用 户 请 
求 都 可 通过 该 Action 来 处 理 。 因 为 没有 为 该 Action 指定 class 属性 ， 即 该 Action 使 用 ActionSupport 
来 作为 处 理 类 ， 而 且 因为 该 ActionSupport 类 的 execute 方法 返回 success 字符 串 ， 即 该 Action 总 是 直 
接 返 回 result 中 指定 的 JSP 资源 ，JSP 资源 使 用 了 表达 式 来 生成 资源 名 。 上 面 Action 定义 的 含义 是 : 
如 果 请 求 aaction， 则 进入 ajsp 页 面 ， 如 果 请 求 baction， 则 进入 bjsp 页 面 ……* 

通过 这 种 方式 ， 可 以 避免 让 浏览 者 直接 访问 系统 的 JSP 页 面 ， 而 是 让 Struts 2 框架 来 管理 所 有 用 
户 请 求 。 

对 于 使 用 Struts 2 框架 的 应 用 而 言 ， 尽 量 不 要 让 超级 链接 直接 链接 到 某 个 视图 资源 ， 因 为 这 种 方 
式 增 加 了 额外 的 风险 。 推 荐 将 所 有 请 求 都 发 送 给 Struts 2 框架 ， 让 该 框架 来 处 理 用 户 请 求 ， 即 使 只 是 
简单 的 超级 链接 。 

对 于 只 是 简单 的 超级 链接 的 请 求 ， 可 以 通过 定义 name 为 “*” 的 Action〈 该 Action 应 该 放 在 最 后 
定义 ) 实现 。 除 此 之 外 ，Struts 2 还 允许 在 容器 中 定义 一 个 默认 的 Action， 当 用 户 请 求 的 URL 在 容器 
中 找 不 到 对 应 的 Action 时 ， 系 统 将 使 用 默认 Action 来 处 理 用 户 请 求 。 

现在 的 问题 是 ， 当 用 户 请 求 的 URL 同时 匹配 多 个 Action 时 ， 究 竟 由 哪个 Action 来 处 理 用 户 请 求 
呢 ? 

假设 有 URL 为 abcAction.action 的 请 求 ,在 struts.xml 文件 中 配置 了 如 下 三 个 Action, 它们 的 Action 
name 的 值 分 别 为 : abcAction、*Action 和 *， 则 这 个 请 求 将 被 名 为 abcAction 的 Action 处 理 。 

如 果 有 URL 为 defAction.action 的 请 求 , struts.xml 文件 中 同样 配置 了 abcAction、*Action 和 * 三 个 
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Action ，defAction.action 的 请 求 显然 不 会 被 name 为 abcAction 的 Action 处 理 ， 但 到 底 是 被 
name="*Action" 的 Action 处 理 ， 还 是 被 name="*" 的 Action 处 理 呢 ? 

为 了 得 到 这 个 结果 ， 我 们 做 了 一 个 matchSequence 应 用 ， 该 应 用 的 struts.xml 配置 文件 如 下 。 

程序 清单 :codes\03W3.6\matchSequence\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!-- 配置 name="*" 的 第 一 个 Action --> 
<action name="*" class="org.crazyit.app.action.FirstAction"> 
<result name="success">/welcome.jsp</result> 
</action> 
<!-- 配置 name="*Action" 的 第 二 个 Action --> 
<action name="*Action" class="org.crazyit.app.action.TwoAction"> 
<result name="success">/welcome.jsp</result> 
</action> 
<!-- 配置 name 为 LoginAction 的 第 三 个 Action --> 
<action name="LoginAction" class="org.crazyit.app.action.LoginAction"> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 配置 文件 中 粗 体 字 代码 包含 了 两 个 支持 模式 匹配 的 Action， 如 果 浏 览 器 发 出 URL 为 
RegistAction.action 的 请 求 ， 该 请 求 不 是 由 第 二 个 Action 来 处 理 ， 而 是 被 第 一 个 Action( 即 FirstAction 
类 ) 处 理 。 

将 上 面 的 struts.xml 文件 修改 成 如 下 形式 : 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!-- 配置 name="*Action" 的 第 二 个 Action --> 
<action name="*Action" class="org.crazyit.app.action.TwoAction"> 
<result name="success">/welcome.jsp</result> 
</action> 
<!-- 配置 name="*" 的 第 一 个 Action --> 
<action name="*" class="org.crazyit.app.action.FirstAction"> 
<result name="success">/welcome.jsp</result> 
</action> 
<!-- 配置 name 为 LoginAction 的 第 三 个 Action --> 
<action name="LoginAction" class="org.crazyit.app.action.LoginAction"> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
</package> 
</struts> 


同样 如 果 有 RegistAction.action 请 求 ， 此 时 将 变 为 由 TwoAction 来 处 理 。 

通过 上 面 配置 文件 的 对 比 ， 可 以 得 出 如 下 的 规律 : 如 果 有 URL 为 abcAction.action 的 请 求 ， 如 果 
struts.xml 文件 中 有 名 为 abcAction 的 Action, 则 一 定 由 该 Action 来 处 理 用 户 请 求 ; 如 果 struts.xml 文件 
中 没有 名 为 abcAction 的 Action, 则 搜寻 name 属性 值 能 匹配 abcAction 的 Action, 例如 name 为 *Action 
或 *，*Action 并 不 会 比 * 更 优先 匹配 abcAction 的 请 求 ， 而 是 先 找到 哪个 Action， 就 会 由 哪个 Action 来 
处 理 用 户 请 求 。 
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“因为 除非 请 来 本 URL 与 Action 的 name 属性 绝对 相 否则 将 按 先 后 顺序 来 决定 由 
哪个 Action 来 处 理 用 户 请 求 。 因此， 我 们 应 该 将 name="*" 的 Action 配置 在 最 后 ， 否 则 
Struts 2 将 使 用 该 Action 米 处 理 所 有 需 望 使 用 模式 下 配 的 请 及 。 ey 


>》3.6.5 配置 默认 Action 


为 了 让 Struts 2 的 Action 可 以 接管 用 户 请 求 ,我 们 可 以 配置 name="*" 的 Action。 除 此 之 外 ，Struts 
2 还 支持 配置 默认 Action。 

当 用 户 请 求 找 不 到 对 应 的 Action 时 ， 系 统 默 认 的 Action 即将 处 理 用 户 请 求 。 

配置 默认 Action 通过 <default-action-ref .…. 户 元 素 完成 , 下 面 的 struts.xml 配置 片段 配置 了 一 个 默认 
Action。 


// 配 置 一 个 package 元 素 
<package name="lee" extends="action-default"> 


<!-- 配置 一 个 默认 Action，, 默认 Action 为 simpleViewResultAction --> 
<default-action-ref name="simpleViewResultAction"/> 


<!-- 通过 action 元 素 配置 默认 的 Action --> 
<action name="simpleViewResultAction" class="lee.SimpleViewResultAction"> 
<result .../> 4 
</action> 
Patra 
从 上 面 的 配置 片段 中 可 以 看 出 ， 配 置 默认 Action 使 用 <default-action-ref .…/> 元 素 即 可 ， 配 置 该 元 
素 时 需要 指定 一 个 name 属性 ， 该 name 属性 指向 容器 中 另 一 个 有 效 的 Action， 该 Action 将 成 为 该 容 
器 中 默认 的 Action。 
提 条 :一 … 一 … 一 … 一 一 …… 一 一 一 光一 一 汪 一 瑟 一 六 一 二 
将 默认 Action 配置 在 默认 命名 空间 里 就 可 以 让 该 Action 处 理 所 有 用 户 请 求 ， 因为 默认 : 
命名 空间 的 Action 可 以 处 理 任何 命名 空 | 


》>》>3.6.6 配置 Action 的 默认 处 理 类 


前 面 已 经 提 到 ， 配 置 <action... 人 > 元 素 时 可 以 不 指定 class 属性 ， 如 果 没 有 指定 class 属性 ， 则 系统 默 
认 使 用 ActionSupport 作为 Action 处 理 类 。 
实际 上 ，Struts 2 允许 定义 开发 者 自己 配置 Action 的 默认 处 理 类 ， 配 置 Action 的 默认 处 理 类 使 用 
<default-class-ref … 伺 元素， 配置 该 元 素 时 只 需 指定 一 个 class 属性 ， 该 class 属性 指定 的 类 就 是 Action 
的 默认 处 理 类 。 
在 struts2-core-2.2.1.jar 压缩 包 的 struts-defaultxml 文件 中 有 如 下 配置 片段 : 
<package name="struts-default" abstract="true"> 
<!-- 配 略 Action 的 默认 处 理 类 一 
<default-class-ref class="com.opensymphony .xwork2.ActionSupport"/> 
</package> 


因为 我 们 在 开发 Struts 2 应 用 时 ， 配 置 Action 时 所 在 的 package 要 么 直接 继承 了 struts-default 包 ， 


194 


http://52pdf.taobao.com 


和 3 


要 么 间接 继承 了 struts-default 包 ， 因 此 我 们 配置 的 Action 的 默认 处 理 类 就 是 ActionSupport。 
如 果 有 需要 ， 我 们 完全 可 以 在 自己 struts.xml 文件 中 使 用 <default-class-ref .… 人 > 元素 改变 Action 的 
默认 处 理 类 。 


3.7 配置 处 理 结果 


Action 只 是 Struts 2 控制 器 的 一 部 分 , 所 以 它 不 能 直接 生成 对 浏览 者 的 响应 。Action 只 负责 处 理 请 
求 , 负责 生成 响应 的 视图 组 件 , 通常 就 是 JSP 页 面 , 而 Action 会 为 JSP 页 面 提供 显示 的 数据 。 当 Action 
处 理 用 户 请 求 结束 后 ， 控 制 器 应 该 使 用 哪个 视图 资源 生成 响应 呢 ? 这 就 必须 使 用 <result .…/> 元 素 进行 
配置 ， 该 元 素 定义 逻辑 视图 名 和 物理 视图 资源 之 间 的 映射 关系 。 


》》>3.7.1 理解 处 理 结果 


Action 处 理 完 用 户 请 求 后 ， 将 返回 一 个 普通 字符 串 ， 整 个 普通 字符 串 就 是 一 个 逻辑 视图 名 。Struts 
2 通过 配置 迎 辑 视图 名 和 物理 视图 之 间 的 映射 关系 ， 一 旦 系统 收 到 Action 返回 的 某 个 逻辑 视图 名 ， 系 
统 就 会 把 对 应 的 物理 视图 呈现 给 浏览 者 

图 3.11 显示 了 浏览 者 、 控 制 器 和 视图 资源 之 间 的 顺序 图 。 


全 “有 


不 不 


显示 


图 3.11 浏览 者 、 控 制 器 和 视图 资源 之 间 的 顺序 图 


如 图 3.11 所 示 ，Action 处 理 完 用 户 请 求 后 ， 并 未 直接 将 请 求 转发 给 任何 具体 的 视图 资源 ， 而 是 返 
回 一 个 逻辑 视图 〈 这 个 逻辑 视图 只 是 一 个 普通 字符 串 )，Stmuts 2 框架 收 到 这 个 逻辑 视图 后 ， 把 请 求 转 
发 到 对 应 的 视图 资源 ， 视 图 资源 将 处 理 结果 呈现 给 用 户 。 

相对 于 Strutsl 框架 而 言 ，Struts 2 的 逻辑 视图 不 再 是 ActionForward 对 象 ， 而 是 一 个 普通 字符 串 ， 
这 样 的 设计 更 有 利于 将 Action 类 与 Struts 2 框架 分 离 ， 提 供 了 更 好 的 代码 复 用 性 。 

除 此 之 外 ，Struts 2 还 支持 多 种 结果 映射 :Struts 2 框架 将 处 理 结果 转向 实际 资源 时 ， 实 际 资源 不 
仅 可 以 是 JSP 视图 资源 ， 也 可 以 是 FreeMarker 视图 资源 ， 甚 至 可 以 将 请 求 转 给 下 一 个 Action 处 理 , 形 
成 Action 的 链 式 处 理 。 


>>3.7.2 配置 结果 


Struts 2 的 Action 处 理 用 户 请 求 结 束 后 ， 返 回 一 个 普通 字符 串 一 一 逻辑 视图 名 ， 必 须 在 struts.xml 
文件 中 完成 逻辑 视图 和 物理 视图 资源 的 映射 ， 才 可 让 系统 转 到 实际 的 视图 资源 。 
简单 地 说 ， 结 果 配置 是 告诉 Struts 2 框架 : 当 Action 处 理 结束 时 ， 系 统 下 一 步 做 什么 ， 系 统 下 一 
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步 应 该 调用 哪个 物理 视图 资源 来 显示 处 理 结果 。 

Struts 2 在 struts.xml 文件 中 使 用 <result .… 亿 元 素来 配置 结果 ,根据 <result .… 人 > 元 素 所 在 位 置 的 不 同 ， 
Struts 2 提供 了 两 种 结果 。 

> ”局 部 结果 : 将 <result .…/> 作 为 <action .…/> 元 素 的 子 元 素 配置 。 

> ”全 局 结果 : 将 <result .…/> 作 为 <global-results .…/> 元 素 的 子 元 素 配 置 。 

关于 全 局 结果 的 讲解 ， 将 在 后 面 介绍 。 此 时 介绍 的 都 是 局 部 结果 ， 局 部 结果 是 通过 在 <action .…/> 
元 素 中 定义 <result .… 户 子 元 素 进行 配置 的 ， 一 个 <action .…/> 元 素 可 以 有 多 个 <result .…> 子 元 素 ， 这 表示 
-个 Action 可 以 对 应 多 个 结果 。 

配置 <result .人 > 元 素 时 通常 需要 指定 如 下 两 个 属性 : 

> name: 该 属性 指定 所 配置 的 逻辑 视图 名 。 

> ”type: 该 属性 指定 结果 类 型 。 

最 典型 的 <result … 和 配置 片段 如 下 : 


<action name="Login" class="lee.LoginAction"> 
<!-- 为 success 的 逻辑 视图 配置 Result，type 属性 指定 结果 类 型 --: 
<result name="success" type="dispatcher"> 
<!-- 指定 该 迎 辑 视图 对 应 的 实际 视图 资源 --> 
name="location">/thank_you. jsp</param> 
</result> 
</action> 


上 面 的 <result.. 人 > 元 素 使 用 了 最 烦琐 的 形式 ， 既 指定 了 需要 映射 的 逻辑 视图 名 (success)， 也 指定 
了 结果 类 型 (dispateher), 并 使 用 子 元 素 的 形式 来 指定 实际 视图 资源 。 上 面 的 粗 体 字 代 码 指定 : 当 Action 
返回 名 为 “success” 的 逻辑 视图 名 时 ， 系 统 将 转发 到 thank_you.jsp 页 面 。 
对 于 上 面 使 用 <param … 信 子 元 素 配置 结果 的 形式 ， 其 中 <param .… 人 > 元 素 用 于 配置 一 个 参数 ， 与 所 
有 配置 参数 的 地 方 相 似 ， 配 置 参数 需要 指定 参数 名 和 参数 值 。<param .…/> 元 素 配置 的 参数 名 由 name 
属性 指定 ， 此 处 的 name 属性 可 以 为 如 下 两 个 值 。 
> ”location， 该 参数 指定 了 该 逻辑 视图 对 应 的 实际 视图 资源 。 
> ”parse: 该 参数 指定 是 否 允 许 在 实际 视图 名 字 中 使 用 OGNL 表达 式 ， 该 参数 值 默认 为 true。 
如 果 设 置 该 参数 值 为 false， 则 不 允许 在 实际 视图 名 中 使 用 表达 式 。 通 常 无 须 修改 该 属性 值 。 
Fr 笔者 在 教学 过 程 中 有 学 生 问 : <result. 人 元 素 里 的 <param.. .> 于 元 素 到 底 可 以 指定 哪些 
参数 呢 ? 也 就 是 <param.../> 子 元 素 的 name 属性 可 以 接受 哪些 合法 的 值 ? 其 实 这 个 问题 是 | 
| 不 确定 的 。 因 为 此 处 指定 的 参数 将 由 结果 解析 器 负责 处 理 ， 不 同类 型 的 结果 解析 器 所 需要 : 
的 参数 是 不 同 的 。 对 于 常见 的 “dispatcher” 类 型 的 结果 类 型 ， 可 以 指定 location、parse 两 | 


因为 通常 无 须 指定 parse 参数 的 值 ， 所 以 常常 采用 如 下 简化 形式 来 配置 实际 视图 资源 。 
<action name=-"LoginmicIassScnrTee LoginAction"> 
<!-- 为 success 的 逻辑 视图 配置 Result，type 属性 指定 结果 类 型 --> 
<result name="success" type="dispatcher">/thank you.jsp</result> 
</action> 
显然 ， 这 种 直接 给 出 视图 资源 的 形式 比 前 面 使 用 子 元 素 的 形式 要 简洁 多 了 。 
除 此 之 外 ，Struts 2 还 允许 省 略 指定 结果 类 型 ， 即 可 改写 成 如 下 形式 : 
<action name="Login" class="lee.LoginAction"> 
<!-- 为 success 的 逻辑 视图 配置 Result， 省 略 type 属性 --> 


<result ee jsp</result> 
</action> 


在 这 个 时 候 ， 系统 将 使 用 默认 的 结果 类 型， Struts 2 默认 的 结果 类 型 就 是 dispatcher (用 于 与 JSP 
了 96 


http://52pdf.taobao.com 


3 


整合 的 结果 类 型 )。 
Struts 2 默认 的 结果 类 型 是 dispatcher， 但 我 们 可 以 通过 修改 配置 文件 来 改变 默认 的 结果 类 型 。 一 
旦 改变 了 默认 的 结果 类 型 ， 如果 配 置 <result .… 亿 元 素 时 省 略 type 元 素 , 则 意味 着 使 用 默认 的 结果 类 型 。 
不 仅 如 此 ，Struts 2 还 可 省 略 逻 辑 视 图 名 ， 即 还 可 改写 成 如 下 形式 : 
<action name="Login" class="lee.LoginAction"> 
<!-- 配置 默认 结果 ， 省 略 type 属性 --> 


<result>/thank_you.jsP</result> 
</action> 


如 果 我 们 省 略 了 <result .… 户 元 素 的 name 属性 ， 系 统 将 采用 默认 的 name 属性 值 ， 默 认 的 name 属性 
值 为 success。 因 此 ， 即 使 我 们 不 给 出 逻辑 视图 名 : success， 系 统 也 一 样 为 success 逻辑 视图 配置 结果 。 

如 果 配 置 <result .… 户 元素 时 没有 指定 location 参数 , 系统 将 会 把 <result .….>…</result> 中 间 的 字符 串 
当成 实际 视图 资源 ， 如 果 没 有 指定 name 属性 ， 则 name 属性 采用 默认 值 ，success; 如 果 没有 指定 type 
属性 ， 则 采用 Struts 2 的 默认 结果 类 型 。 


>>3.7.3 Struts 2 支持 的 结果 类 型 


Struts 2 支持 使 用 多 种 视图 技术 ， 例 如 JSP、Velocity 和 FreeMarker 等 。 当 一 个 Action 处 理 用 户 请 
求 结束 后 ， 仅 仅 返回 一 个 字符 串 ， 这 个 字符 串 是 逻辑 视图 名 ， 但 该 逻辑 视图 并 未 与 任何 的 视图 技术 及 
任何 的 视图 资源 关联 一 一 直到 我 们 在 struts.xml 文件 中 配置 物理 逻辑 视图 资源 。 

结果 类 型 决定 了 Action 处 理 结束 后 ， 下 一 步 将 调用 哪 种 视图 资源 来 呈现 处 理 结果 。 

Struts 2 的 结果 类 型 要 求实 现 com.opensymphony.xwork2.Result， 这 个 结果 是 所 有 结果 类 型 的 通用 
接口 。 如 果 我 们 需要 自己 的 结果 类 型 ， 我 们 应 该 提供 一 个 实现 该 接口 的 类 ,并 且 在 struts.xml 文件 中 配 
置 该 结果 类 型 。 

Struts 2 默认 提供 了 一 系列 的 结果 类 型 ， 下 面 是 struts-defaultxml 配置 文件 的 配置 片段 。 
struts-default.xml 文件 保存 在 struts2-core-2.2.1.jar 文件 的 根 路 径 下 ,使 用 解压 缩 工具 打开 该 文件 即 可 看 
到 struts-default.xml 配置 文件 。 


<!-- 配置 系统 支持 的 结果 类 型 --> 
<result-types> 
<!-- Action 链 式 处 理 的 结果 类 型 -~-> 
<result-type name="chain" 
class="com. opensymphony .xwork2. ActionChainResult"/> 
<!-- 用 于 与 JSP 整合 的 结果 类 型 一 > 
<result-type name="dispatcher" 
class="org.apache. struts2.dispatcher. ServletDispatcherResult" 
default="true"/> 
<!-- 用 于 与 FreeMarker 整合 的 结果 类 型 --> 
<result-type name="freemarker" 
class="org.apache. struts2.views. freemarker. FreemarkerResult"/> 
<!-- 用 于 控制 特殊 的 HTTP 行为 的 结果 类 型 --> 
<result-type name="httpheader" 
class="org.apache.struts2.dispatcher.HttpHeaderResult"/> 
<!~~ 用 于 直接 跳 转 到 其 他 URL 的 结果 类 型 --> 
<result-type name="redirect" 
class="org.apache. struts2.dispatcher. ServletRedirectResult"/> 
<!-- 用 于 直接 跳 转 到 其 他 Action 的 结果 类 型 --> 
<result-type name="redirectAction" 
class="org.apache.struts 2.dispatcher.ServletActionRedirectResult"/> 
<!-- 用 于 向 浏览 器 ; 个 Inputstream 的 结果 类 型 -> 
<result-type name="stream" 
class="org.apache. struts2.dispatcher.StreamResult"/> 
<!-~ 用 于 整合 Velocity 的 结果 类 型 -> 


<result-type name="velocity" 


class="org.apache. struts2.dispatcher.VelocityResult"/> 
<!-~ 用 于 整合 XML/XSLT 的 结果 类 型 --> 


197 


http://52pdf.taobao.com 
米 量 纹 Java EE 企业 应 用 实战 (第 3 版 ) 一 


<result-type name="xslt" 
class="org.apache.struts2.views.xslt. XSLTResult"/> 
<!-- 用 于 显示 某 个 页 面 原始 代码 的 结果 类 型 一 > 
<result-type name="plainText" 
class="org.apache. struts2.dispatcher .PlainTextResult" /> 
</result-types> 
上 面 的 粗 体 字 代码 标 出 的 结果 类 型 就 是 Struts 2 默认 支持 的 结果 类 型 。 从 上 面 配置 文件 可 以 看 出 : 
每 个 <result-type .广元 素 定义 一 个 结果 类 型 , <result .人 > 元 素 中 的 name 属性 指定 了 该 结果 类 型 的 名 字 ， 
class 属性 指定 了 该 结果 类 型 的 实现 类 。 
除 此 之 外 ,还 可 以 在 struts 2-jfreechart-plugin-2.2.1.jar 的 struts-plugin.xml 文 件 中 看 到 如 下 配置 片段 : 
<result-types> 
<result-type name="chart" class="org.apache.struts2.dispatcher.ChartResult"> 
<param name="height">150</param> 
<param name="width">200</param> 
</result-type> 
</result-types> 


从 上 面 的 配置 片段 可 以 看 出 , 增加 struts 2-jfreechart-plugin-2.2.1jar 插件 后 ，Struts 2 又 可 额外 增加 
新 的 结果 类 型 。 事 实 是 : Stmuts 2 提供 了 极 好 的 可 扩展 性 ， 它 允许 自 定义 结果 类 型 ， 所 以 ， 如 果 业 务 有 
需要 ， 我 们 完全 可 以 自 定义 结果 类 型 。 幸 运 的 是 ， 这 种 情况 很 少见 ， 因 为 Struts 2 以 及 相关 插件 考虑 
得 非常 全 面 。 
提示 ;… 一 … 一 … 一 … 一 … 一 … 一 … 一 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 
正如 前 面 提 到 的 , 不同 的 结果 类 型 支持 不 同 的 参数 ,例如 此 处 介绍 的 chart 类 型 的 结果 ， 
FN 类 型 ， 它 就 可 以 支持 height、width 两 个 参数 。 | 
除 此 之 外 ， 我 们 看 到 配置 dispatcher 结果 类 型 时 ， 指 定 了 default="true" 属 性 ， 该 属性 表明 该 结果 
类 型 是 默认 的 结果 类 型 一 一 这 也 是 为 什么 当 定义 <result .… 人 > 元 素 时 ， 如 果 省 略 了 type 属性 ， 默 认 type 
属性 为 dispatcher 的 原因 。 
如 果 不 算 Struts 2 插件 所 支持 的 结果 类 型 ，Struts 2 内 建 的 支持 结果 类 型 如 下 。 
> chain 结果 类 型 ，Action 链 式 处 理 的 结果 类 型 。 
dispatcher 结果 类 型 ， 用 于 指定 使 用 JSP 作为 视图 的 结果 类 型 。 
freemarker 结果 类 型 ， 用 于 指定 使 用 FreeMarker 模板 作为 视图 的 结果 类 型 。 
httpheader 结果 类 型 ， 用 于 控制 特殊 的 HTTP 行为 的 结果 类 型 。 
redirect 结果 类 型 ， 用 于 直接 跳 转 到 其 他 URL 的 结果 类 型 。 
redirectAction 结果 类 型 : 用 于 直接 跳 转 到 其 他 Action 的 结果 类 型 。 
stream 结果 类 型 ， 用 于 向 浏览 器 返回 一 个 InputStream (一 般 用 于 文件 下 载 〉。 
velocity 结果 类 型 ， 用 于 指定 使 用 Velocity 模板 作为 视图 的 结果 类 型 。 
xslt 结果 类 型 用 于 与 XML/XSLT 整合 的 结果 类 型 。 
plainText 结果 类 型 ， 用 于 显示 某 个 页 面 的 原始 代码 的 结果 类 型 。 
上 面 的 结果 类 型 中 dispatcher 结果 类 型 是 默认 的 类 型 ， 主 要 用 于 与 JSP 页 面 整 合 。 而 其 他 大 部 分 
结果 类 型 将 会 在 后 面 有 更 详细 的 介绍 ， 例 如 stream 结果 类 型 ， 将 在 Struts 2 的 文件 下 载 中 有 更 详细 的 
介绍 。 下 面 将 简要 介绍 plainText、redirect 和 redirectAction 三 种 结果 类 型 。 


vy TY 


和 


》>》3.7.4 plainText 结果 类 型 
这 个 结果 类 型 并 不 常用 ， 因 为 它 的 作用 太 过 局 限 : 它 主要 用 于 显示 实际 视图 资源 的 源 代码 。 看 如 
下 简单 的 Action 类 。 
程序 清单 : codes\03\3.7\plainText\WEB-INF\src\org\crazyit\app\action\LoginAction.java 
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public class LoginAction 
extends Actionsupport 


// 用 于 封装 请 求 参数 的 username 属性 
Private String username; 
//username 属性 的 setter 和 getter 方法 
public String getUsername() 

{ 


{ 


return username; 
} 
public void setUsername (String username) 
{ 
this.username = username; 
} 
上 


上 面 的 Action 类 继承 了 ActionSupport 类 ， 因 此 它 也 包含 了 一 个 从 父 类 继承 得 到 的 execute() 方 法 ， 
不 过 这 个 方法 并 未 真正 处 理 用 户 请 求 ， 它 只 是 简单 地 返回 了 一 个 success 的 逻辑 视图 。 在 struts.xml 文 
件 中 配置 该 Action， 如 果 采 用 如 下 配置 片段 : 

程序 清单 :codes\033.7\plainText\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"~//Apache Software Foundation//DTD Struts Configuration 2.1,7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.devMode" value="true"/> 
<package name="lee" extends="struts-default"> 
<action name="login" class="org.crazyit.app.action.LoginAction"> 
<!-- 指定 Result 的 类 型 为 PlainText 类 型 --> 
<result type=" > 
<!-- 指定 实际 的 视图 资源 --> 
<param name="location">/welcome. jsp</param> 
<!-- 指定 使 用 指定 的 字符 集 来 处 理 页 面 代码 -> 
<param name="charSet">GBK</Param> 
</result> 
</action> 
<action name=""> 
<result>.</result> 
</action> 
</package> 
</struts> 


在 上 面 的 配置 片段 中 ,配置 <result .… 人 > 元 素 时 , 并 未 指定 <result ... 人 > 元 素 的 name 属性 ,意味 着 name 
属性 值 为 success; 上面 的 粗 体 字 代码 显 式 指定 了 type 属性 值 为 plainText 类 型 ，plainText 结果 类 型 指 
定 将 视图 资源 当成 普通 文本 处 理 ， 所 以 该 结果 类 型 会 导致 输出 页 面 源 代码 。 该 结果 指定 的 视图 资源 : 
welcome.jsp 页 面 的 代码 如 下 。 

程序 清单 :codes\03\3.7\plainText\welcome.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" 人 > 
<%@ taglib prefix="s" uri="/struts-tags"®> 
<!1DOCTYPE html PUBLIC "~//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional,dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 欢 迎 </title> 
</head> 
<body> 
<s:property value="username"/> 
</body> 
</html> 


这 个 页 面 非常 简单 ， 仅 仅 在 页 面 中 输出 Action 实例 的 usemame 属性 值 。 如 果 用 户 输入 任意 的 
usemame 请 求 参数 ， 然 后 单 击 “ 提 交 ” 按 钮 ， 将 看 到 如 图 3.12 所 示 的 页 面 。 
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但 如 果 我 们 修改 上 面 struts.xml 文件 中 的 <result … 亿 元素， 修改 成 如 下 简单 形式 : 


<!-- 下 面 配置 片段 指定 使 用 dispatcher 结果 类 型 ， 
当 返 回 success 结果 时 使 用 welcome .jsp 页 面 作为 视图 资源 -> 
<result>/welcome.jsp</result > 


在 服务 器 端 重新 加 载 Web 应 用 ， 在 页 面 中 输入 任意 的 usemame 属性 值 ， 然 后 单 击 “ 提 交 ” 按 钮 ， 
将 看 到 如 图 3.13 所 示 的 页 面 。 
正如 图 3.12 所 显示 的 ， 如 果 我 们 使 用 plainText 结果 类 型 ， 系 统 将 把 视图 资源 的 源 代 码 呈 现 给 


图 3.12 直接 输出 页 面 源 代码 的 结果 类 型 图 3.13 正常 显示 的 结果 类 型 


如 果 在 welcomejsp 页 面 的 代码 中 包含 了 中 文字 符 ,使 用 plainText 结果 类 型 必须 指定 charSet 参数 ， 
该 参数 指定 输出 页 面 所 用 的 字符 集 。 

使 用 plainText 结果 类 型 时 可 指定 如 下 两 个 参数 。 

> “location: 指定 实际 的 视图 资源 。 

> ”charSet， 指定 输出 页 面 时 所 用 的 字符 集 。 


> >3.7.5 redirect 结果 类 型 


这 种 结果 类 型 与 dispatcher 结果 类 型 相对 ，dispatcher 结果 类 型 是 将 请 求 forward (转发 ) 到 指定 的 
JSP 资源 ， 而 redirect 结果 类 型 ， 则 意味 着 将 请 求 redirect 〈 重 定向 ) 到 指定 的 视图 资源 。 

dispatcher 结果 类 型 与 redirect 结果 类 型 的 差别 主要 就 是 转发 和 重 定向 的 差别 ， 重 定向 会 丢失 所 有 
的 请 求 参数 、 请 求 属性 一 一 当然 也 丢失 了 Action 的 处 理 结果 。 

使 用 redirect 结果 类 型 的 效果 是 ， 系 统 将 调用 HttpServletResponse 的 sendRedirect(String) 方法 来 
重 定向 指定 视图 资源 ， 这 种 重 定向 的 效果 就 是 重新 产生 一 个 请 求 ， 因 此 所 有 的 请 求 参 数 、 请 求 属性 、 
Action 实例 和 Action 中 封装 的 属性 全 部 丢失 。 

对 于 上 面 的 应 用 ， 如 果 将 struts.xml 文件 修改 成 如 下 形式 : 

程序 清单 : codes\03\3.7\redirect\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
” ”<constant name="struts.devMode" value="true"/> 
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<package name="lee" extends="struts-default"> 
<action name="login" class="org.crazyit.app-action.LoginAction"> 、 
<!-- 指定 结果 的 类 型 为 redirect， 
这 意味 着 系统 该 Action 将 重 定向 到 welcome .jsp 页 面 --> 
<result type="redirect">/welcome.jsp</result> 
</action> J 
<action name=""> 
<result>.</result> = 
</action> 
</package> 
</struts> 


上 面 的 粗 体 字 代 码 指定 了 redirect 结果 类 型 ， 意 思 是 : 当 Action 处 理 用 户 请 求 结束 后 ， 系 统 将 重 
新 生成 一 个 请 求 ， 重 定向 到 welcomejsp 页 面 。 

当 浏 览 者 向 该 Action 发 送 请 求 ， 该 Action 处 理 完 用 户 请 求 后 ， 转 入 /welcomejsp 页 面 〈 该 页 面 使 
用 Struts 2 标签 输出 username 属性 )， 将 看 到 如 图 3.14 所 示 的 效果 。 


图 3.14 ”使 用 redirect 结果 类 型 结果 


在 如 图 3.14 所 示 页 面 的 地 址 栏 看 到 ， 地 址 栏 里 请 求 的 URL 已 经 不 再 是 login.action， 而 是 
welcom,jsp。 可 见 使 用 redirect 结果 类 型 时 ， 当 Action 处 理 完 用 户 请 求 后 ， 再 次 向 视图 资源 发 送 一 次 新 
的 请 求 。 

配置 一 个 redirect 类 型 的 结果 ， 可 以 指定 如 下 两 个 参数 。 

和 location， 该 参数 指定 Action 处 理 完 用 户 请 求 后 跳 转 的 地 址 。 

> parse: 该 参数 指定 是 否 允 许 在 location 参数 值 中 使 用 表达 式 ， 该 参数 值 默认 为 true。 

与 前 面 类 似 的 是 ， 通 常 无 须 指定 parse 属性 值 ， 因 此 可 以 简化 成 上 面 的 情形 。 


>》>3.7.6 redirectAction 结果 类 型 


这 种 结果 类 型 与 redirect 类 型 非常 相似 ， 一 样 是 重新 生成 一 个 全 新 的 请 求 。 但 与 redirect 结果 类 型 
区 别 在 于 :redirectAction 使 用 ActionMapperFactory 提供 的 ActionMapper 来 重 定向 请 求 。 
当 需 要 让 一 个 Action 处 理 结束 后 ， 直 接 将 请 求 重 定 向 〈 是 重 定向 ， 不 是 转发 ) 到 另 一 个 Action 
时 ， 我 们 应 该 使 用 这 种 结果 类 型 。 
配置 redirectAction 结果 类 型 时 ， 可 以 指定 如 下 两 个 参数 。 
> ”actionName: 该 参数 指定 重 定向 的 Action 名 。 
> ”namespace: 该 参数 指定 需要 重 定向 的 Action 所 在 的 命名 空间 。 
下 面 是 一 个 使 用 redirectAction 结果 类 型 的 配置 实例 。 
<package name="public" extends="struts-default"> 
<action name="login" class="lee.LoginAction"> > 
<!-- 配置 一 个 redirectAction 结果 类 型 的 Result 人 ' 
， 重 定向 另 一 个 命名 空间 的 Action ,一 > 
<result type="redirectAction"> 
<!-- 指定 重 定向 的 actionName --> 
<param name="actionName">dashboard</param> 
<!-- 指定 重 定向 的 Action 所 在 的 命名 空间 --> 
<param name="namespace">/secure</param> 


</result> 
</action> . 
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</package> 
<package name="secure" extends="struts-default" namespace="/secure"> 
<!-- 定义 被 转 入 的 Rction 一 -> 
<action name="dashboard" class="lee.Dashboard"> 
<result>dashboard. jsp</result> 
<!-- 配置 一 个 redirectAction 结果 类 型 的 Result 
， 重 定向 同一 个 命名 空间 的 Action 一 -> 
<result name="error" type="redirectAction>error</result> 
</action> 
<action name="error"> 
<result>error.jsp</result> 
</action> 
</package> 


使 用 redirectAction 结果 类 型 时 ， 系 统 将 重新 生成 一 个 新 请 求 ， 只 是 该 请 求 的 URL 不 是 一 个 具体 
的 视图 资源 ， 而 是 另 一 个 Action。 因 此 前 一 个 Action 处 理 结果 、 请 求 参 数 、 请 求 属性 都 会 丢失 。 

对 于 redirect 和 redirectAction 两 种 结果 类 型 ， 都 是 重新 生成 一 个 新 请 求 ， 区 别 是 前 者 通常 用 于 生 
成 一 个 对 具体 资源 的 请 求 ， 而 后 者 通常 用 于 生成 对 另 一 个 Action 的 请 求 。 两 个 结果 类 型 都 会 丢失 请 求 
参数 、 请 求 属性 和 前 一 个 Action 的 处 理 结果 。 


》》3.7.7 动态 结果 


动态 结果 的 含义 是 指 在 指定 实际 视图 资源 时 使 用 了 表达 式 语法 , 通过 这 种 语法 可 以 允许 Action 处 
理 完 用 户 请 求 后 ， 动 态 转 入 实际 的 视图 资源 。 

前 面 介绍 Action 配置 时 ， 可 以 通过 在 Action 的 name 属性 中 使 用 通配符 ， 在 class 或 method 属性 
中 使 用 {N} 表 达 式 。 通过 这 种 方式 ， 允 许 Struts 2 根据 请 求 来 动态 决定 Action 的 处 理 类 ， 以 及 动态 决定 
处 理 方法 。 除 此 之 外 ， 我 们 也 可 以 在 配置 <result .… 记 元素 时 使 用 表达 式 语法 ， 从 而 允许 根据 请 求 动态 
决定 实际 资源 。 

看 下 面 的 配置 片段 ， 

<action name="crud_*" class="lee.CrudAction" method="{1}"> 

<result name="input">/input.jsp</result> 


<result>/{1} .jsp</result> 
</action> 


上 面 的 配置 片段 有 一 个 name="crud_*" 的 Action， 这 个 Action 可 以 处 理 所 有 匹配 crud_*.action 模 
式 的 请 求 。 例如 有 一 个 crud_create.action 的 请 求 ， 系统 将 调用 lee.CrudAction 类 的 create 方法 来 处 理 用 
户 请 求 。 当 Action 处 理 用 户 请 求 结束 后 ， 配 置 了 两 个 结果 : 当 处 理 结果 为 input 字符 串 时 ， 系 统 将 转 
到 /inputjsp 页 面 ， 当 处 理 结果 为 success 字符 串 时 ， 系 统 将 转 入 create.jsp 页 面 一 一 这 个 视图 资源 是 动 
态 生 成 的 ， 因 为 crud_create 匹配 crud_* 模 式 时 ， 第 一 个 星 号 (*) 的 值 是 create， 因 此 /{1}.jsp 的 表达 
式 返 回 值 为 create， 即 对 应 /createjsp 资源 。 

与 配置 class 属性 和 method 属性 相 比 ， 配 置 <result …> 元 素 时 ， 还 允许 使 用 OGNL 表达 式 ， 这 种 
用 法 允许 根据 Action 属性 值 来 定位 物理 视图 资源 。 


>>3.7.8 Action 属性 值 决定 物理 视图 资源 


配置 <result … 户 元 素 时 ， 不 仅 可 以 使 用 ${0} 表 达 式 形式 来 指定 视图 资源 ， 还 可 以 使 用 ${ 属 性 名 } 
的 方式 来 指定 视图 资源 。 在 后 面 这 种 配置 方式 下 ，${ 属 性 名 } 里 的 属性 名 就 是 对 应 Action 实例 里 的 属 
性 。 而且， 不 仅 允许 使 用 这 种 简单 表达 式 形式 ， 还 可 以 使 用 完全 的 OGNL 表达 式 ， 即 使 用 如 下 形式 : 
${ 属性 名 .属性 名 .属性 名 } 。 

看 如 下 的 配置 片段 : 

<package name="skill" extendg="default" namespace="/skill"> 
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<!-- 配置 了 一 个 名 为 save 的 Action, 
该 Action 的 处 理 类 为 SkillRction， 处 理 方法 为 save --> 
<action name="save" class="org.crazyit.app.action.SkillAction" 
method="save"> 
<result name="input">/empmanager/editSkill.jsp</result> 
<!-- 使 用 OGNL 表达 式 来 指定 结果 资源 -> 
<result type="redirect">edit.action? 
SkillName=$ {currentSkill .name}</result> 
</action> 
<!-- 配置 了 一 个 名 为 delete 的 Action， 
该 Action 的 处 理 类 为 SkillAction， 处 理 方法 为 delete --> 
<action name="delete" class="org.crazyit.app.action. SkillAction" 
method="delete"> 
<result name="error">/empmanager/editSkill.jsp</result> 
<!-- 使 用 OGNL 表达 式 来 指定 结果 资源 --> 
<result type="redirect">edit.action? 
skillName=${currentSkill.name}</result> 
</action> 


</package> 
在 上 面 的 配置 片段 中 ， 使 用 了 $f{currentSkill.name} 表 达 式 来 指定 结果 视图 资源 。 对 于 上 面 的 表达 
式 语法 ， 要 求 在 对 应 的 Action 实例 里 应 该 包含 currentSkill 属性 ， 且 currentSkill 属性 必须 包含 name 属 


下 面 示范 一 个 简单 的 应 用 ， 这 个 应 用 可 以 让 用 户 在 文本 框 内 输入 请 求 的 资源 ， 系 统 将 自动 跳 转 到 
对 应 的 资源 。 
该 应 用 的 输入 页 面 如 图 3.15 所 示 。 


转 入 的 目标 页 基 


福生， 
您 该 输 和 weleome， 系 统 只 提供 welccae. jap 页 而 
区 


图 3.15 转向 的 输入 页 面 


处 理 该 请 求 的 Action 非常 简单 ， 它 仅仅 提供 了 一 个 属性 来 封装 请 求 参数 ， 并 提供 了 一 个 参数 来 封 
装 处 理 后 的 提示 。 下 面 是 该 Action 类 的 代码 。 
程序 清单 :codes\03\3.7\parameterResult\WEB-INF\src\org\crazyit\app\action\MyAction.java 
public class MyAction extends ActionSupport 
{ 
// 封 装 请 求 参数 的 target 属性 
private String target; 
// 封 装 处 理 结果 的 tip 属性 
private String tip; 
// 此 处 省 略 了 target 和 tip 属性 的 setter 和 getter 方法 


public String execute() throws Exception 


{ 
setTip ("恭喜 您 ,您 已 经 成 功 转向 ") ; 
return SUCCESS; 
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上 面 的 execute 方法 总 是 返回 一 个 SUCCESS 常量 ， 即 总 是 返回 success 字符 串 。 然 后 在 struts.xml 


文件 中 配置 该 Action， 配 置 文件 如 下 。 
程序 清单 : codes\03\3.7\parameterResult\WEB-INF\src\struts.xml 
<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-defahlt"> 
<!-- 配置 处 理 用 户 请 求 的 Action --> 
<action name="MyAction" class="org.crazyit.app.action.MyAction"> 
<!-- 配置 Result， 使 用 OGNL 表达 式 来 指定 视图 资源 --> 
<result name="success">/${target} .jsp</result> 
</action> 
<action name=""> 
<result>.</result> 
</action> 
</package> 
</struts> 


上 面 的 粗 体 字 代 码 指定 实际 物理 资源 时 ， 使 用 了 /${target}.jsp 表达 式 来 指定 视图 资源 一 一 这 要 求 
在 对 应 的 Action 类 里 应 该 包含 target 属性 一 一 该 属性 值 将 决定 实际 的 视图 资源 。 

当 浏 览 者 在 如 图 3.15 所 示 页 面 的 输入 框 中 输入 welcome 字符 串 时 ， 单 击 “ 转 入 ”按钮 系统 将 可 
以 跳 转 到 /welcome.jsp 页 面 ， 即 看 到 如 图 3.16 所 示 的 页 面 。 


全 要 多 簿 已 经 成功 赎 问 


图 3.16 根据 参数 决定 视图 页 面 


当然 , 我 们 可 以 在 如 图 3.15 所 示 的 页 面 中 输入 任意 字符 串 , 然后 执行 跳 转 。 例 如 输入 abe 字符 串 ， 
系统 将 转 入 /abc.jsp 页 面 。 系 统 没有 提供 abcjsp 的 视图 资源 ， 因 此 将 看 到 如 图 3.17 所 示 的 页 面 。 

正如 图 3.17 中 用 椭圆 形 框 标示 的 地 方 ， 我 们 看 到 系统 已 经 转 入 了 abcjsp 资源 ， 但 因为 该 资源 不 
存在 ， 所 以 看 到 如 图 3.17 所 示 的 页 面 。 


图 3.17 找 不 到 视图 资源 的 页 面 


>>3.7.9 全 局 结果 


前 面 已 经 提 到 了 ，Struts 2 的 <result .…. 信 元素 配 置 ， 也 可 放 在 <global-results .…. 人 > 元 素 中 配置 ， 当 在 
<global-results .… 人 元素 中 配置 <result .… 人 元素 时 ， 该 <result .… 信 元素 配置 了 一 个 全 局 结果 ， 全 局 结果 将 
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对 所 有 的 Action 都 有 效 。 
将 前 一 个 应 用 的 struts.xml 配置 文件 改 为 如 下 形式 。 
程序 清单 : codes\03\3.7\globalResult\WWEB-INF\src\struts.xm] 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!-- 定义 全 局 结果 --> 
<global-results> 
<!-- 配置 Result， 使 用 OGNL 表达 式 来 指定 视图 资源 --> 
<result name="success">/${target}.jsp</result> 
</global-results> 
<!-- 配置 处 理 用 户 请 求 的 Actio! 
<action name="MyAction" class="org.crazyit.app.action.MyAction"/> 
<action name=""> 
<result>.</result> 
</action> 
</package> 
</struts> 


上 面 的 配置 片段 配置 了 一 个 Action, 但 在 该 Action 内 没有 配置 任何 的 结果 一 一 但 这 不 会 影响 系统 的 
运转 ， 因 为 提供 了 一 个 名 为 success 的 全 局 结果 ， 而 这 个 全 局 结果 的 作用 范围 对 所 有 的 Action 都 有 效 。 

如 果 一 个 Action 里 包含 了 与 全 局 结果 里 同名 的 结果 , 则 Action 里 的 局 部 Result 会 禾 盖 全 局 Result。 
也 就 是 说 , 当 Action 处 理 用 户 请 求 结束 后 , 会 首先 在 本 Action 里 的 局 部 结果 里 搜索 逻辑 视图 对 应 的 结 
果 ， 只 有 在 Action 里 的 局 部 结果 里 找 不 到 逻辑 视图 对 应 的 结果 ， 才 会 到 全 局 结果 里 搜索 。 


Fes 由 于 全 局 结果 的 影响 范围 是 对 所 有 的 Action 都 有 效 ， 因 此 如 果 不 是 需要 对 所 有 Action : 
都 有 效 的 结果 ， 就 不 应 该 放 在 <global-result .元素 里 定义 ， 而 是 应 该 放 在 <action .人 > 元 


> 3.7.10 使 用 PreResultListener 


PreResultListener 是 一 个 监听 器 接口 ， 它 可 以 在 Action 完成 控制 处 理 之 后 ， 系 统 转 入 实际 的 物理 
视图 之 间 被 回调 。 
Struts 2 应 用 可 由 Action、 拦 截 器 添加 PreResultListener 监听 器 ， 添 加 PreResultListener 监听 器 通 
过 ActionInvocation 的 addPreResultListener() 方 法 完成 .一 旦 为 Action 添加 了 PreResultListener 监听 器 ， 
该 监听 器 就 可 以 在 应 用 转 入 实际 物理 视图 之 前 回调 该 监听 器 的 beforeResult0 方 法 ， 一旦 为 拦截 器 添加 
了 PreResultListener 监听 器 ， 该 监听 器 会 对 该 拦截 器 所 拦截 的 所 有 Action 都 起 作用 。 
下 面 程序 示范 为 LoginRegistAction 添加 一 个 PreResultListener, 该 PreResultListener 监听 器 可 以 在 
Action 转 入 物理 视图 之 前 被 回调 。 
程序 清单 : codes\03\3.7\PreResultListener \WEB-INF\src\org\crazyit\app\action\ LoginRegistActionjava 
public class LoginRegistAction 
extends ActionSupport 


// 封 装 用 户 请 求 参数 的 两 个 属性 

Private String username; 

private String password; 

// 封 装 处 理 结果 的 tip 属性 

private String tip; 

// 省 略 三 个 属性 对 应 的 setter 和 getter 方法 


{ 
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//Action 包含 的 注册 控制 逻辑 
public String regist() throws Exception 
{ 
ActionContext .getContext {) .getSession() 
.Put ("user" , getUsername()); 
setTip (" 蕉 喜 您 , ”+ getUsername() + ", 您 已 经 注册 成 功 ! "); 
return SUCCESS; 


} 
//Action 默认 包含 的 控制 逻辑 
public String execute() throws Exception 
{ 
ActionInvocation invocation = ActionContext 
“getContext () .getActionInvocation(); 
invocation.addPreResultListener (new PreResultListener() 
{ 
Public void beforeResult (ActionInvocation invocation, 
String resultCode) 


System.out.println ("返回 的 逻辑 视图 名 字 为 " 
= + resultCode); 
// 在 返回 Result 之 前 加 入 一 个 额外 的 数据 
invocation.getInvocationContext () .put ("extra" 
1 new java.util,Date() + "由 " 
+ resultCode + "逻辑 视图 名 转 入 ") ; 
// 也 可 加 入 日 志 等 


{ 


} 

Ds» 

if (getUsername().equals("crazyit.org") 
5&5 getPassword() .equals ("leegang") ) 


ActionContext .getContext () .getSession() 
:put ("user" , getUsername()); 

setTip(" 欢 迎 ,”+ getUsername() + ", 您 已 经 登录 成 功 !"); 

return SUCCESS; 


return ERROR; 


中 
} 


上 面 的 粗 体 字 代 码 就 示范 了 为 Action 添加 PreResultListener， 这 样 该 监听 器 就 可 以 在 转 入 物理 视 
图 之 前 激发 该 监听 器 。 
例如 我 们 在 登录 页 面 输入 crazyit.org、leegang 登录 系统 ， 将 可 以 看 到 如 图 3.18 所 示 页 面 。 


葡 迎 , crazyi rorg 您 已 经 几 录 记功 | 
ehee 各 这 和 的 妆 入 ，Twe Nov 16 2 
success 刘 畏 视 用 名 转 


图 3.18 使 用 PreResultListener 


正如 上 面 的 代码 注释 中 看 到 的 ， 通 过 使 用 PreResultListener 监听 指定 Action 转 入 不 同 Result 的 细 
节 ， 因 此 也 可 以 作为 日 志 的 实现 方式 。 


3.8 配置 Struts 2 的 异常 处 理 
任何 成 熟 的 MYC 框架 都 应 该 提供 成 熟 的 异常 处 理 机 制 , 当然 可 以 在 execute 方 法 中 手动 捕捉 异常 ， 
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当 捕捉 到 特定 异常 时 , 返回 特定 逻辑 视图 名 一 一 但 这 种 处 理 方式 非常 烦琐 ,需要 在 execute 方法 中 书写 
大 量 的 catch 块 。 最 大 的 缺点 还 在 于 异常 处 理 与 代码 耦合 ， 一 旦 需要 改变 异常 处 理 方式 ， 必 须 修改 代 
码 ! 这 不 是 我 们 希望 看 到 的 结果 。 最 好 的 方式 是 可 以 通过 声明 式 的 方式 管理 异常 处 理 。 


> 3.8.1 Struts 2 的 异常 处 理 机 制 
对 于 MVC 框架 而 言 ， 我 们 希望 有 如 图 3.19 所 示 的 处 理 流程 。 


全 出现 异 并 1 


放风 看 


图 3.19 MVC 框架 的 异常 处 理 流程 的 协作 图 


图 3.19 所 显示 的 处 理 流程 是 ， 当 Action 处 理 用 户 请 求 时 ， 如 果 出 现 了 异常 1， 则 系统 转 入 视图 资 
源 1， 在 该 视图 资源 上 输出 服务 器 提示 ; 如 果 出 现 异 常 2， 则 系统 转 入 视图 资源 2， 并 在 该 资源 上 输出 
服务 器 提示 。 

为 了 满足 如 图 3.19 所 示 的 处 理 流程 ， 我 们 可 以 采用 如 下 的 处 理 方法 : 

public class XxxAction 

{ 


public String execute() 
{ 

try 

{ 


) 
catch (异常 1 e) 
{ 
return 结果 1 


} 
catch (异常 2 e) 
{ 
return 结果 2 
} 


} 
上 


我 们 在 Action 的 execute 方法 中 使 用 try.…catch 块 来 捕捉 异常 ， 当 捕捉 到 指定 异常 时 ， 系 统 返 回 对 
应 逻辑 视图 名 一 一 这 种 处 理 方式 完全 是 手动 处 理 异常 ， 非 常 烦 琐 ， 而 且 可 维护 性 不 好 : 如 果 我 们 需要 
改变 异常 处 理 为 则 必须 修改 Action 代码 


提示 : 
通过 上 面 代码 中 的 碍 体 字 代码 可 以 看 出 ， 如 果 我 们 手动 catch 异常 ， 然 后 return 一 个 字 : 
符 串 作为 到 辑 视图 名 ,其 实质 就 是 完成 异常 类 型 和 远 辑 视图 名 之 间 的 对 应 关系 .既然 如 此 ， | 
| 我们 完全 可 以 把 这 种 对 应 关系 推迟 到 struts.xml 文件 中 进行 管理 。 


类 似 于 Stmutsl 提供 的 声明 式 异 常 管理 ，Struts 2 允许 通过 struts.xml 文件 来 配置 异常 的 处 理 。 关 于 
Struts 2 的 处 理 哲学 ， 我 们 可 以 查看 Action 接口 里 的 execute 方法 签名 : 
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// 处 理 用 户 请 求 的 execute 方法 ， 该 方法 抛 出 所 有 异常 
public String execute() throws Exception 


上 面 的 execute 方法 可 以 抛 出 全 部 异常 ， 这 意味 着 我 们 重 写 该 方法 时 ， 完 全 无 须 进 行 任何 异常 处 
理 ， 而 是 把 异常 直接 抛 给 Struts 2 框架 处 理 ，Struts 2 框架 接收 到 Action 抛 出 的 异常 之 后 ， 将 根据 
stmtsxml 文件 配置 的 异常 映射 ， 转 入 指定 的 视图 资源 。 

通过 Struts 2 的 异常 处 理 机 制 ,我 们 可 以 无 须 在 execute 方法 中 进行 任何 异常 捕捉 , 仅 需 在 struts.xml 
文件 中 配置 异常 处 理 ， 就 可 以 实现 如 图 3.19 所 示 的 异常 处 理 流程 。 

为 了 使 用 Struts 2 的 异常 处 理 机 制 ,我 们 必须 打开 Struts 2 的 异常 映射 功能 ,开启 异常 映射 功能 需要 

-个 拦截 器 。 下 面 的 代码 片段 来 自 stuts-defaultxml， 在 该 配置 文件 中 已 经 开启 了 Struts2 的 异常 映射。 
<interceptors> 
二 执行 异常 处 理 的 拦 夫 回 -> 


<interceptor name="exception" 
Class="com.opensymphony .xwork .interceptor .ExceptionMapping.Interceptor"/> 


<!-- Struts 2 默认 的 拦截 器 栈 --> 
<interceptor-stack name="defaultStack"> 


<!-- 引用 异常 吴 射 拦截 器 -> 
<interceptor-ref name="exception"/> 


</interceptor-stack> 
</interceptors> 


正 是 通过 上 面 配置 的 拦截 器 ， 实 现 了 Struts 2 的 异常 机 制 。 
>>3.8.2 声明 式 异 常 捕 提 


Struts 2 的 异常 处 理 机 制 是 通过 在 struts.xml 文件 中 配置 <exception-mapping .…/> 元 素 完成 的 ， 配 置 
该 元 素 时 ， 需 要 指定 如 下 两 个 属性 。 
> ”exception: 此 属性 指定 该 异常 映射 所 设置 的 异常 类 型 。 
> result， 此 属性 指定 Action 出 现 该 异常 时 ， 系 统 返回 result 属性 值 对 应 的 逻辑 视图 名 。 
根据 <exception-mapping .… 人 > 元 素 出 现 位 置 的 不 同 ， 异 常 映 射 又 可 分 为 如 下 两 种 。 
> ”局 部 异常 映射 : 将 <exception-mapping …/> 元 素 作为 <action .…/> 元 素 的 子 元 素 配置 。 
> 全 局 异常 映射 : 将 <exception-mapping .…/> 元 素 作 为 <global-exception-mappings> 元 素 的 子 
元 素 配 置 。 
与 前 面 的 <result .… 户 元 素 配置 结果 类 似 ， 全 局 异常 映射 对 所 有 的 Action 都 有 效 ， 但 局 部 异常 映射 
仅 对 该 异常 映射 所 在 的 Action 内 有 效 。 如 果 局 部 异常 映射 和 全 局 异常 映射 配置 了 同一 个 异常 类 型 ,在 
该 Action 内 局 部 异常 映射 会 覆盖 全 局 异常 映射 。 
下 面 的 应 用 同样 是 一 个 简单 的 登录 应 用 ， 在 登录 页 面 输入 用 户 名 和 密码 两 个 参数 后 ， 用 户 提交 请 
求 ， 请 求 将 被 如 下 的 Action 类 处 理 。 
程序 清单 : codes\03\3.8\exceptionHandler\WEB-INF\src\org\crazyit\app\action\LoginActin.java 
public class LoginAction implements Action 
: // 封 装 请 求 参 数 的 username 和 password 属性 
Private String username; 
private String password; 
// 封 装 提示 的 tip 属性 


Private String tip; 
// 省 略 了 三 个 属性 的 setter 和 getter 方法 


public String execute() throws Exception 
{ 
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if (getUsername() .equalsIgnoreCase("user")) 
{ 

throw new MyException (" 自 定义 异常 ") ; 
了 


if (getUsername () -equalsIgnoreCase ("sql")) 
{ 
throw new java.sql.SQLException ("用 户 名 不 能 为 SQL") ; 
} 
if (getUsername().equals("crazyit.org") 
5&6 getPassword() .equals("leegang") ) 
{ 
setTip ("了 哈哈， 服务 器 提示 ! ") 7 
return SUCCESS; 


return ERROR; 


} 


由 于 该 示例 应 用 没有 调用 业务 逻辑 组 件 ， 因 此 系统 不 会 抛 出 异常 。 为 了 验证 Struts 2 的 异常 处 理 
框架 ， 我 们 采用 手动 方式 抛 出 两 个 异常 : MyException 和 SQLException， 其 中 MyException 异常 是 一 
个 自 定义 异常 ， 如 程序 中 粗 体 字 代码 所 示 。 

下 面 通过 stmuts.xml 文件 来 配置 Struts 2 的 异常 处 理 机 制 ， 本 系统 的 struts.xml 文件 如 下 。 

程序 清单 :codes\03\3.8\exceptionHandler\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2,1,7//EN" 
"http://struts,apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<package name="lee" extends="struts-default"> 
<!- 定义 全 局 结果 映射 -> 
<global-results> 
<!-- 定义 当 sql、root 两 个 逻辑 异常 都 对 应 exception.jsp 页 --> 
<result name="sql">/exception.jsp</result> 
<result name="root">/exception.jsp</result> 
</global-results> 
<!--~ 定义 全 局 异常 映射 -> 
<global-exception-mappings> 
<!-- 当 Action 中 迪 到 SQLException 异常 时 ， 
系统 将 转 入 name 为 sql 的 结果 中 --> 
<exception-mapping exception="java.sql.SQLException" result="sql"/> 
<!-- 当 Action 中 过 到 Exception 异常 时 ， 
系统 将 转 入 name 为 root 的 结果 中 -> 
<exception-mapping exception="java.lang.Exception" result="root"/> 
</global-exception-mappings> 
<action name="login" class="org.crazyit.app.action,LoginAction"> 
<!-- 定义 局 部 异常 映射 ， 当 Action 中 遇 到 MyException 异常 时 ， 
系统 将 转 入 name 为 my 的 结果 中 -> 
<exception-mapping exception="org.crazyit. app.exception.MyException" 
result="my"/> 
<!- 定义 三 个 结果 映射 -> 
<result name="my">/exception.jsp<JresUlt> 
<result name="error">/error.jsp</result> 
<result name="success">/welcome.jsp</result> 
</action> 
<action name=""> 
<result>.</result> 
</action> 
</package> 
</struts> 


上 面 的 配置 文件 中 粗 体 字 代 码 定义 了 三 个 异常 映射 ,指定 Action 中 出 现 如 下 三 个 异常 的 处 理 策略 。 
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> ”org\crazyit\app\exception\IMyException: 该 异常 映射 使 用 局 部 异常 映射 完成 ， 当 Action 的 
execute 方法 抛 出 该 异常 时 ， 系 统 返回 名 为 my 的 逻辑 视图 。 
> java.sql.SQLException: 该 异常 映射 使 用 全 局 异常 映射 完成 ， 当 Action 的 execute 方法 抛 出 
该 异常 时 ， 系 统 返回 名 为 sql 的 逻辑 视图 。 
> javalang.Exception: 该 异常 映射 使 用 全 局 异常 映射 完成 ， 当 Action 的 execute 方法 抛 出 该 
异常 时 ， 系 统 返 回 名 为 root 的 逻辑 视图 。 
当然 ， 系 统 中 也 通过 局 部 结果 定义 、 全 局 结果 定义 的 方式 定义 了 my、sql 和 root 三 个 结果 。 当 定 
义 异 常 映射 时 ， 通 常 需要 注意 : 全 局 异常 映射 的 result 属性 值 通常 不 要 使 用 局 部 结果 ， 局 部 异常 映射 
的 result 属性 值 既 可 以 使 用 全 局 结果 ， 也 可 以 使 用 局 部 结果 。 


>>3.8.3 输出 异常 信息 


当 Struts 2 框架 控制 系统 进入 异常 处 理 页 面 后 ， 我 们 必须 在 对 应 页 面 中 输出 指定 异常 信息 。 

为 了 在 异常 处 理 页 面 中 显示 异常 信息 ， 我 们 可 以 使 用 Struts 2 的 如 下 标签 来 输出 异常 信息 。 

> ”<s:property value="exception"/>: 输出 异常 对 象 本 身 。 

> ”<s:property value="exceptionStack"/>: 输出 异常 堆栈 信息 。 

对 于 第 一 种 直接 输出 异常 对 象 本 身 的 方式 ， 完 全 可 以 使 用 表达 式 ， 因 为 exception 提供 了 
getMessage() 方 法 ， 所 以 我 们 可 以 采用 <s:property value="exception.message"> 代 码 来 输出 异常 的 
message 信息 。 

本 应 用 的 exceptionjsp 页 面 代码 如 下 。 

程序 清单 :codes\03\3.8\exceptionHandler\exception.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorpage="" 4> 
<$@taglib prefix="s" uri="/struts-tags"s> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 异 常 处 理 页 面 </title> 
</head> 
<body> 
异常 信息 : <s:property value="exception.message"/> 
</body> 
</html> 
如 果 我 们 在 登录 页 面 的 用 户 名 输入 框 中 输入 user， 然 后 提交 请 求 ， 系 统 将 抛 出 org.crazyit.app. 


exception.MyException 异常 ， 出 现 如 图 3.20 所 示 的 页 面 。 


异常 信息 ， 自 定义 异常 


E23 
图 3.20 输出 自 定义 异常 的 message 信息 


如 果 我 们 希望 输出 异常 跟踪 栈 信息 ， 则 可 将 输出 异常 信息 的 代码 改 为 : 


<!-- 使 用 Struts 2 标签 输出 异常 跟踪 栈 信息 --> 
<s:property value="exceptionstack"/> 


如 果 在 登录 页 面 的 用 户 名 输入 框 中 输入 sql， 然 后 提交 请 求 ， 系 统 将 抛 出 java.sql.SQLException 异 
常 ， 转 到 如 图 3.21 所 示 的 页 面 。 
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图 3.21 直接 显示 异常 跟踪 栈 信息 


相对 于 Strutsl 只 能 输出 异常 对 象 的 message 属性 值 ， 而 无 法 输出 异常 的 跟踪 栈 信 息 ，Struts 2 能 
输出 异常 对 象 完整 的 跟踪 栈 信息 ， 因 此 更 加 有 利于 项 目 调试 。 


3.9 Convention 插件 与 “约定 ”支持 


从 Struts 2.1 开始 ，Struts 2 引入 了 Convention 插件 来 支持 零 配置 。 插 件 完全 可 以 抛弃 配置 信息 ， 
不 仅 不 需要 使 用 struts.xml 文件 进行 配置 ， 甚 至 不 需要 使 用 Annotation 进行 配置 。 而 是 由 Struts 2 根据 
约定 来 自动 配置 。 


Convention 这 个 单词 翻译 过 来 就 是 “约定 ”的 意思 ,有 Ruby On Rails 开发 经 验 的 读者 ， 
知道 Rails 有 一 条 重要 原则 : 约定 优 于 配置 。Rails 开发 者 只 需要 按 约定 开发 ActiveRecord、| 

| ”ActiveController 即 可 ， 无 须 进行 配置 。 很 明显 ，Struts 2 的 Convention 插件 借鉴 了 Rails 的 
创意 ， 甚 至 连 插件 的 名 称 都 借鉴 了 “约定 优 于 配置 ”原则 . | 


由 于 Struts 2 的 Convention 插件 的 主要 特点 是 “约定 优 于 配置 ”， 当 读者 已 经 掌握 了 Struts 2 的 基 
本 开发 之 后 ， 学 习 Convention 插件 其 实 非常 简单 ， 关 键 就 是 记 住 Convention 插件 的 这 些 约定 就 行 了 ， 
开发 时 遵守 这 些 约定 即 可 。 


》>》》3.9.1 Action 的 搜索 和 映射 约定 


为 了 使 用 Convention 插件 ， 必 须 在 Struts 2 应 用 中 安装 Convention 插件 ， 安 装 Convention 插件 非 
常 简单 ， 开 发 者 只 需要 将 Struts 2 项 目下 的 stmts2-convention-plugin-2.2.1jar 文件 复制 到 Struts 2 应 用 
的 WEB-INF\ib 路 径 下 即 可 。 

对 于 Convention 插件 而 言 ， 它 会 自动 搜索 位 于 action、actions、struts、struts2 包 下 的 所 有 Java 类 ， 
Convention 插件 会 把 如 下 两 种 Java 类 当成 Action 处 理 : 

> 所 有 实现 了 com.opensymphony.xwork2.Action 的 Java 类 。 

> ”所 有 类 名 以 Action 结尾 的 Java 类 。 

下 面 这 些 类 都 是 符合 Convention 插件 的 Action 类 : 


org.crazyit .app.actions. 
// 下 面 类 实现 了 com.opensymphony.xwork2.Action 接口 
org.crazyit.app. actions.books.getBooks 
org.crazyit.app. action.LoginAction 
org.crazyit.app. struts.auction.bid.BidAction 
org.crazyit.app. struts2.wage.hr.AddEmployeeAction 


Struts 2 的 Convention 插件 还 允许 设置 如 下 三 个 常量 。 
> “struts.convention.exclude.packages: 指定 不 扫描 哪些 包 下 的 Java 类 , 位 于 这 些 包 结构 下 的 
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Java 类 将 不 会 被 自动 映射 成 Action。 

> struts.convention.package.locators: Convention 插件 使 用 该 常量 指定 的 包 作为 搜寻 Action 
的 根 包 。 对 于 actions lee.LoginAction 类 ， 按 约定 原本 应 映射 到 /lee/login; 如 果 将 该 常量 设 
为 lee， 则 该 Action 将 会 映射 到 /login。 

> struts.convention.action.packages: Convention 插件 以 该 常量 指定 包 作为 根 包 来 搜索 Action 
类 。Convention 插件 除了 扫描 action、actions、struts、struts2 四 个 包 的 类 之 外 ， 还 会 扫描 
六 江 基 种 的 -个 或 多 个 包 ，Convention 会 试图 从 中 发 现 Action 类 。 


三 入 总 疾 
struts.convention.package.locators 和 struts.convention.action.packages 两 个 常量 的 作 要 


用 比较 微妙 ， 开 发 者 在 利用 这 两 个 常量 时 务必 小 


找到 合适 的 Action 类 之 后 ，Convention 插件 会 按 约定 部 署 这 些 Action， 部 署 Action 时 ，actions、 
action、struts、struts2 包 会 映射 成 根 命名 空间 ， 而 这 些 包 下 的 子 包 则 被 映射 成 对 应 的 命名 空间 。 
例如 如 下 Action 所 在 包 被 映射 的 命名 空间 如 下 : 
org.crazyit .actions.LoginAction 映射 到 / 
// 下 面 类 实现 了 com.opensymphony.xwork2 .Action 接口 
org.crazyit .actions.books.GetBooks 映射 到 /books 
org.crazyit.action.LoginAction 映射 到 / 
org.crazyit.struts.auction.bid.Bidhction 映射 到 /auction/bid 
org.crazyit.struts2.wage.hr.AddEmployeeAction 映射 到 /wage/hr 
除 此 之 外 ,我 们 知道 Struts 2 的 Action 都 是 以 package 的 形式 来 组 织 的 ,而 package 还 有 父 package。 
对 于 采用 Convention 插件 开发 的 Struts 2 应 用 而 言 ， 每 个 Action 所 处 的 package 与 其 Action 类 所 在 包 
相似 (除去 actions、action、struts、struts2 这 些 包 及 父 包 部 分 ).Convention 插件 里 所 有 Action 所 在 package 
的 父 package 默认 是 conventionDefault。 
而 Action 的 name 属性 (也 就 是 该 Action 所 要 处 理 的 URL》 则 根据 该 Action 的 类 名 映射 ， 映 射 
Action 的 name 时 ， 遵 循 如 下 两 步 规则 : 
(1) 如 果 该 Action 类 名 包含 Action 后 缀 ， 将 该 Action 类 名 的 Action 后 组 去 掉 。 否 则 不 做 任何 
处 理 。 
(2) 将 Action 类 名 的 驼峰 写法 (每 个 单词 首 字母 大 写 、 其 他 字母 小 写 的 写法 ) 转 成 中 划 线 写法 (所 
有 字母 小 写 ， 单 词 与 单词 之 间 以 中 划 线 隔 开 )。 
例如 LoginAction 映射 的 Action 的 name 属性 为 login，GetBooks 映射 的 Action 的 name 属性 为 
get-books，AddEmployeeAction 映射 的 Action 的 name 属性 为 add-employee。 
对 于 如 下 Action 将 被 映射 成 的 完整 URL 如 下 : 
org.crazyit ,actions .LoginAction 映射 到 /login.action 
// 下 面 类 实现 了 com.opensymphony.xwork2 .Action 接口 
org.crazyit .actions.books.GetBooks 映射 到 /books/get-books.action 
org.crazyit ,action.LoginAction 映射 到 /login.action 
org.crazyit.struts.auction.bid.BidAction 映射 到 /auction/bid/bid.action 
org.crazyit.struts2.wage.hr.AddEmployeeAction 映射 到 /wage/hr/add-employee.action 
采用 Convention 插件 之 后 ，Action 类 的 代码 依然 不 需要 任何 额外 的 变化 。 下 面 是 我 们 的 示例 应 用 
的 Action 代码 。 
程序 清单 : codes\03\3.9\Convention\WEB-INF\src\org\crazyit\app\action\user\LoginAction.java 
Package org.crazyit.app.action.user; 
// 省 略 了 import 语句 
public class LoginAction extends Actionsupport 
// 封 装 请 求 参 数 的 username 和 password 属性 
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private String username; 
private String password; 
1/ 省略 username 和 password 的 setter 和 getter 方法 


// 处 理 用 户 请 求 的 execute 方法 
public String execute() throws Exception 
{ 
if (getUsername().equals("crazyit.org") 
46 getPassword() .equals("leegang") ) 
{ 
ActionContext .getContext () .getSession() 
.put ("user" , getUsername()); 
return SUCCESS; 


return ERROR; 


} 
} 


从 上 面 的 类 代码 可 以 看 出 , 该 Action 与 前 面 介绍 的 普通 Action 并 没有 太 大 的 区 别 , 只 是 该 Action 
被 放 在 org.crazyit.app.action 包 的 user 子 包 下 。 根 据 前 面 介绍 的 映射 规则 ， 该 Action 将 被 映射 到 如 下 
URL: /user/login。 

为 了 让 页 面 请 求 提交 给 actions.lee.LoginAction 处 理 ， 我 们 将 首页 的 表单 定义 代码 改 为 如 下 : 


<s:form action="user/login"> 
// 省 略 其 他 表单 域 定义 代码 


</s:f0rm> 

当 用 户 向 user/login 提交 表单 时 ， 该 请 求 将 交 给 org.crazyit.app.action.user.LoginAction 处 理 。 
除 此 之 外 ， 本 应 用 中 还 包含 另外 一 个 Action 类 ; GetBooksAction， 代 码 如 下 。 

程序 清单 :codes\03\3.9\Convention\WWEB-INF\src\org\crazyit\app\action\book\GetBooksAction.java 


package org.crazyit.app.action.book; 
// 省 略 了 import 语句 


public class GetBooksAction implements Action 
{ 
// 封 装 数 据 的 books 属性 
private String[】 books; 
//books 属性 的 setter 和 getter 方法 
public void setBooks (String[] books) 
{ 
this.books = books; 
} 
public String{] getBooks() 
{ 
return this.books; 


} 
// 处 理 用 户 请 求 的 execute 方法 
public String execute() throws Exception 
{ 
String user = (String)RctionContext.getContext () 
.getSession() .get ("user"); 
if (user != null &6 user.equals("crazyit.org")) 


// 创 建 业务 逻辑 组 件 ， 并 调用 业务 逻辑 组 件 的 方法 
BookService bs = new BookService ()7 
setBooks (bs.getLeeBooks()) 7 
return SUCCESS; 

else 


return LOGIN; 
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于 
} 


该 Action 将 被 映射 到 /book/get-books.action。 
.> >3.9.2 按 约定 映射 Result 


Action 处 理 用 户 请 求 之 后 会 返回 一 个 字符 串 作 为 逻辑 视图 ， 该 逻辑 视图 必须 映射 到 实际 的 物理 视 
图 才 有 意义 。Convention 默认 也 为 作为 逻辑 视图 和 物理 视图 之 间 的 映射 提供 了 约定 。 

默认 情况 下 ，Convention 总 会 到 Web 应 用 的 WEB-INF/content 路 径 下 定位 物理 资源 ， 定 位 资源 的 
约定 是 : actionName + resultcode + suffix。 当 某 个 逻辑 视图 找 不 到 对 应 的 视图 资源 时 ，Convention 会 自 
动 试 图 使 用 actionName + suffix 作为 物理 视图 资源 。 

例如 ，org.crazyit.app.action.user.LoginAction 返回 success 字符 串 时 ，Convention 优先 考虑 使 用 
WEB-INF\content\user 目录 下 的 login-success.jsp 作为 视图 资源 。 如 果 找 不 到 该 文件 ，login.jsp 也 可 作 
为 对 应 的 视图 资源 。 

当然 ， 当 我 们 使 用 不 同 的 Result 类 型 时 ， 对 应 的 资源 也 不 相同 ， 表 3.1 是 Convention 支持 的 一 些 
映射 示例 。 

表 3.1 Result 的 约定 映射 
Action 的 URL 对 应 的 物理 视图 
Mogin \WEB-INPconten login-successjsp. 


/login WEB-INFJcontcntogin-success.html 


/login ispatcl WEB-INFeontenrilogin jsp 


login \WEB-INPcontentogin html 
/eweet-book \WEB-INP eonteneciget-book-error fl 
/lee/get-book \WEB-INP\content\lec\get-book, A 
/lec/get-book WEB-INFIcontenfec\ect-book-inputvm 
/lee/get \WEB-INP\contend\lee\get-input. vm 


为 了 给 前 面 介绍 的 两 个 actions.lee.LoginAction、actions.yeeku.GetBooksAction 提供 对 应 的 视图 资 
源 ， 我 们 在 WEB 应 用 的 WEB-INF\content 目录 的 如 下 目录 结构 下 提供 如 下 JSP 页 面 。 
content 
| 一 user 
| | 一 Ioginjsp 
| | 一 login-success.jsp 
| | 一 Ilogin-errorjsp 
| 一 yeeku 
| | 一 getrbooksjsp 
关于 这 些 JSP 页 面 没有 什么 特别 之 处 ， 与 前 面 开 发 普通 Struts 2 应 用 时 的 JSP 页 面 完全 相同 ， 此 
处 不 再 整 述 。 
至 此 ， 本 示例 应 用 的 Action、Result 等 主要 映射 都 由 Convention 插件 映射 完成 一 一 这 种 映射 由 
Convention 插件 按 约定 进行 ， 无 须 任何 XML 配置 文件 。 
为 了 看 到 Struts 2 应 用 里 Action 等 各 种 资源 的 映射 情况 ，Struts 2 提供 了 Config Browser 插件 ， 这 
个 插件 并 不 是 用 来 增强 Struts 2 功能 的 ， 这 个 插件 主要 是 更 有 利于 开发 者 调试 的 ， 使 用 该 插件 可 以 清 
楚 地 看 出 Struts 2 应 用 下 部 署 了 哪些 Action， 以 及 每 个 Action 详细 的 映射 信息 。 
安装 Config Browser 插件 非常 简单 ， 将 Struts 2 项 目的 lib 目录 下 的 struts2-config-browser- 
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plugin-2.2.1.jar 文件 复制 到 Struts 2 应 用 的 WEB-INF\lib 目录 下 ， 重 启 该 Web 应 用 即 可 。 

为 我 们 的 示例 应 用 (Convention ) 安 装 Config Browser 插件 后 重启 该 应 用 , 接 下 来 就 可 以 利用 Config 
Browser 插件 提供 的 页 面 来 查看 该 应 用 中 部 署 的 Action 信息 。 

Config Browser 插件 的 首页 地 址 为 ，Web_Context/config-browser/index.action， 对 于 我 们 的 示例 应 
用 而 言 ， 首 页 地 址 是 : http://localhost:8888/Convention/config-browser/actionNames.action (其 中 8888 是 
笔者 Tomcat 的 端口 号 )。 

在 浏览 器 里 浏览 Config Browser 插件 的 首页 ， 将 看 到 如 图 3.22 所 示 界 面 。 


图 3.22 ”Config Browser 插件 的 首页 


从 图 3.22 中 可 以 看 出 ， 进 入 Config Browser 插件 首页 时 ， 该 页 面 将 首先 列 出 默认 命名 空间 下 所 有 
的 Action。 由 于 本 应 用 没有 Action 配置 在 默认 命名 空间 下 ， 因 此 图 3.22 的 中 间 显示 一 片 空白 。 

从 图 3.22 可 以 看 出 , Config Browser 插件 首页 的 左上 角 用 于 查看 Struts 2 应 用 里 的 常量 配置 、 Bean 
配置 等 。 而 左下 角 则 列 出 了 当前 系统 里 包含 的 所 有 命名 空间 。 其 中 default 就 是 默认 的 命名 空间 ， 它 总 
是 存在 的 ， 而 /config-browser 则 是 Config Browser 插件 配置 的 命名 空间 ， 与 本 系统 无 关 。 除 此 之 外 ， 
剩 下 的 /user 和 /book 就 是 本 系统 实际 包含 的 两 个 命名 空间 了 一 一 这 两 个 命名 空间 是 Convention 插件 根 
据 org.crazyit.app.action.user.LoginAction 和 org.crazyit.app.action.book.GetBooks 两 个 类 创建 的 。 

单 击 图 3.22 左下 角 的 /user 命名 空间 ， 将 看 到 如 图 3.23 所 示 界 面 。 


图 3.23 查看 /user 命名 空间 下 的 所 有 Action 


从 图 3.23 可 以 看 出 , /user 命名 空间 下 确实 已 经 存在 了 name 为 login 的 Action, 这 表明 Convention 
插件 对 org.crazyit.app.action.user.LoginAction 映射 成 功 。 同 理 ， 我 们 单 击 图 3.22 左下 角 的 /book 链接 ， 
将 可 看 到 在 /book 命名 空间 下 有 一 个 get-books 的 Action。 

单 击 图 3.23 所 示 页 面 中 间 的 login 链接 ， 系 统 将 进入 查看 /user/login.action 详细 配置 的 页 面 ， 如 图 
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3.24 所 示 。 


图 3.24 查看 指定 Action 的 映射 
从 图 3.24 可 以 看 出 /user/login.action 的 详细 映射 信息 .在 图 3.24 所 示 页 面 的 下 方 , 则 可 看 到 Result 
的 映射 信息 ,这些 正 是 Convention 插件 映射 约定 的 体现 。 从 图 3.24 下 方 的 Result 映射 来 看 , 它 只 是 前 

面 表 3.1 中 示例 的 子 集 。 
通过 Config Browser 插件 可 以 清楚 地 看 出 ， 本 应 用 中 的 Action、Result 都 已 映射 成 功 ， 这 个 Struts 

2 应 用 开发 完成 。 
提示 :一 一 一 一 一 一 一 一 一 一 
Config Browser 插件 并 不 是 为 Convention 插件 设计 的 ， 不 管 开发 者 使 用 struts.xml 文件 

总 进行 配置 管理 , 还 是 使 用 Convention 插件 的 约定 法 则 管理 Action 和 Result, Config Browser | 
| 。 插件 一 样 可 用 。 j 


当 浏 览 者 向 /user/login.action 提交 登录 请 求 之 后 ， 如 果 登 录 成 功 ， 将 可 看 到 如 图 3.25 所 示 界 面 。 
单 击 图 3.25 所 示 页 面 里 的 超 链接 ， 系 统 将 看 到 如 图 3.26 所 示 页 面 。 


作者 地 出 忆 比丘 的 阳 书 


Er ti 3 
欢迎 ，crazyit, org, 您 已 经 登录 1 
查看 人 村 忆 了 的 吕 攻 


truts 2 权 丰 指南 


3 
图 3.25 登录 成 功 图 3.26 查看 /book/get-books.action 


>》>》3.9.3 Action 链 的 约定 


如 果 希 望 一 个 Action 处 理 结束 后 不 是 进入 视图 页 面 ， 而 是 进行 另 一 个 Action 形成 Action 链 ， 则 
通过 Convention 插件 只 需 遵守 如 下 三 个 约定 即 可 。 

> 第 一 个 Action 返回 的 逻辑 视图 字符 串 没 有 对 应 的 视图 资源 。 

> 第 二 个 Action 与 第 一 个 Action 处 于 同一 个 包 下 。 
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> ”第 二 个 Action 映射 的 URL 为 : firstactionName + resultcode 


例如 希望 actions.lee.FirstAction 处 理 结束 后 进入 第 二 个 Action 继续 处 理 ， 下 面 我 们 先 看 第 一 个 
Action 代码 。 


程序 清单 : codes\03\3.9\Chain\WWEB-INF\src\org\crazyit\app\action\FirstAction.java 


Package org.crazyit.app.action; 
// 省 略 import 语句 


public class FirstAction extends RctionSupport 


上 
// 封 装 提示 信息 的 +ip 属性 
private String tip; 
//tip 属性 的 setter 和 getter 方法 
public void setTip(String tip) 
{ 
this.tip = tip; 
} 
public String getTip() 
{ 
return this.tip; 
) 
public String execute() 
{ 
System.out .println ("进行 第 一 个 Action"); 
setTip(" 第 一 个 Action 的 提示 信息 ") 7 
return "second"; 
} 
} 


从 上 面 的 粗 体 字 代 码 可 以 看 出 ， 该 Action 处 理 用 户 请 求 后 返回 "second" 字 符 串 ， 为 了 让 该 Action 
处 理 结束 后 进入 第 二 个 Action， 而 不 是 直接 进入 视图 页 面 ， 因 此 该 应 用 的 WEB-INF/content 下 不 能 提 
供 first-second.jsp 或 firstjsp。 

对 于 FirstAction 返回 "second" 字 符 串 的 情形 ， 第 二 个 Action 的 映射 的 URL 应 该 是 first-second， 因 
此 第 二 个 Action 的 类 名 应 该 为 FirstSecond。 下 面 是 第 二 个 Action 类 的 代码 。 

程序 清单 : codes\03\3.9\Chain\WWEB-INF\src\org\crazyit\app\action\FirstSecondAction.jav 


Package actions.1ee; 
// 省 略 import 语句 


public class FirstSecondAction extends ActionSupport 


// 处 理 用 户 请 求 
public String execute() 
{ 
System.out.println(" 进 行 第 二 个 Action”) 
return SUCCESS; 
} 
} 


提供 这 两 个 Action 之 后 ， 当 first Action 处 理 用 户 请 求 结束 之 后 ， 系 统 将 自动 调用 org.crazyit.app. 
action.FirstSecondAction 处 理 用 户 请 求 。 当 浏览 者 向 /first 发 送 请 求 后 ， 将 可 在 Tomeat 控制 台 看 到 如 图 
3.27 所 示 的 界面 。 


图 3.27 两 个 Action 形成 的 链 式 处 理 
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>>3.9.4 自动 重 加 载 映 身 


可 能 有 读者 对 Convention 插件 感到 麻烦 了 ， 由 于 Convention 插件 是 根据 Action、JSP 页 面 来 动态 
生成 映射 的 , 因此 不 管 是 Action 的 改变 , 还 是 JSP 页 面 的 改变 , 都 需要 Convention 插件 重新 加 载 映射 。 
实际 上 , Convention 插件 完全 支持 自动 重 加 载 映射 ,只 要 我 们 为 Struts 2 应 用 配置 如 下 两 个 常量 即 可 ( 既 


可 在 web.xml 文件 中 配置 ， 也 可 在 struts.xml 或 struts.properties 文件 中 配置 ): 


<!-- 配置 Struts 2 应 用 处 于 开发 模式 -> 
<constant name="struts.devMode" value="true"/> 


<!-- 配置 Convention 插件 自动 重 加 载 映射 


-> 


<constant name="struts.convention.classes.reload" value="true" /> 


常量 还 只 是 停留 在 试验 阶段， Stmts2 官 


| 常量。 实际 上 第 二 个 常量 在 Tomcat 6.0.X 上 运行 良好 ; 在 Tomeat 7.0.X 上 会 引发 Null 
| PointerBxoeption, 


方 文档 也 告 诚 要 慎重 使 用 ; 


>>3.9.5 ovenlbni 让 个 泊 半 党 量 - 


虽然 Convention 插件 号 称 “ 零 配置 ”插件 ， 但 实际 上 想 真正 让 Struts 2 变 成 “ 零 配 置 ” 还 是 有 些 
难度 的 ， 至 少 我 们 要 在 web.xml 文件 中 配置 Struts 2 的 核心 Filter。 除 此 之 外 ，Struts 2 应 用 的 各 种 全 局 
配置 ， 如 Bean 配置 、 拦 截 配 置 等 ， 依 然 还 需要 借助 于 Struts 2 的 配置 文件 。 

Convention 插件 主要 致力 于 解决 Action 管理 、Result 管理 等 最 常见 、 也 最 琐碎 的 配置 。 将 开发 者 
从 庞大 而 烦琐 的 struts.xml 文件 中 释放 出 来 ， 而 不 是 完全 舍弃 struts xml 文件 。 

除 此 之 外 ，Convention 插件 还 允许 配置 如 表 3.2 所 示 的 各 种 常量 ， 这 些 常量 用 于 设置 Convention 


插件 的 全 局 属性 。 


表 3.2 ”Convention 插件 的 常量 


常 最 名 


说 明 


struts.convention.action.disableJarScanning 


Struts.convention.action.packages 


设置 是 否 从 JAR 包 里 搜索 Action 类 。 如 果 开 发 者 喜欢 将 Action 类 打包 成 JAR， 则 应 将 
该 常量 没 为 ve。 默认 值 为 we 
Convention 插件 以 该 常量 指定 包 作为 根 包 来 搜索 Action 类 


struts.convention result.path 


设置 Convention 插件 定位 视图 资源 的 根 路 径 。 默认 值 为 /WEB-INF/content 


struts.convention resultflatLayout 


如 果 设 置 为 false， 则 可 以 将 视图 页 面 放置 到 Action 对 应 的 目录 下 (无 须 放 入 
WEB-INF/content 下 ) 


struts.convention.action suffix 


Convention 搜索 Action 类 的 的 类 名 后 级 。 默 认 值 为 Action 


Stnuts.convention.action.disableScanning 


是 吾 钴 止 通过 包 扫 描 Action。 默认 值 是 false 


Struts.convention.action.mapAllMatches 


设置 即使 没有 @Action 注释 ， 依 然 创 建 Action 映射 。 默认 值 是 false 


struts.convention action.checkImplementsAction 


设置 是 否 将 实现 了 Action 接口 的 类 映射 成 Action。 默认 值 是 ue 


struts.convention. default parent. package 


设置 Convention 映射 的 Action 所 在 包 的 默认 父 包 。 默 认 值 是 convention-default 


Struts.convention.action.name.lowercase 


设置 映射 Action 时 ， 是 否 将 Action 的 name 属性 值 转 为 所 有 字母 小 写 。 默认 值 是 ue 


struts.convention action.name separator 


设置 映射 Action 时 指定 name 属性 值 各 单词 之 问 的 分 隔 符 。 默认 值 是 中 划 线 


struts.convention.package.locators 


Convention 插件 使 用 该 常量 指定 的 包 作为 搜寻 Action 的 根 包 。 默 认 值 是 
action,actions,struts,struts2 


struts.convention.package.locators.disable 


指定 禁止 从 Action 的 根 包 里 搜寻 Acton。 默认 值 是 false 


struts.convention.exclude.packages 


指定 排除 在 搜索 Action 之 外 的 包 - 默认 值 为 
orgapache stmuts 
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org springframework. web.struts.*, org.springframework- web.struts2.*, 


struts.convention.exclude.packages 


orghibematc 
| struts.convention.package.locators.basePackage | 如 果 指 定 了 该 常情 ，Convention 只 会 从 以 该 常量 值 开始 的 包 中 搜索 Action 类 。 
指定 Convention 映射 Result 时 默认 支持 的 结果 类 型 默认 值 是 
dispatchervelocity freemarker 
设置 是 否 重 定向 到 斜 线 (/)。 例 如 用 户 请 求 /foo， 但 /foo 不 存在 时 ， 如 果 设 置 该 常生 为 
true 则 可 重 定向 到 /foo/， 默 认 值 是 wue 


struts.convention.relative.resulttypes 


struts.convention.redirect to.slash 


和 
闫 .注意 : ~ 
这 里 的 许多 常量 就 是 用 于 控制 前 面 介绍 的 约定 的 .例如 struts.convention.action.name. 
lowercase 和 struts.convention.action.name.separator 就 是 用 于 控制 指定 Action 的 name 属 
性 值 为 Action 类 名 的 中 划 线 写法 .而 struts.convention.package.locators 和 struts.convention. 
action.suffix 就 是 Convention 默认 搜索 Action 的 规 见 


》>3.9.6 ”Convention 插件 相关 Annotation 


Struts 2 的 Convention 插件 主要 集中 在 管理 Action 和 Result 映射 之 上 , 而 Struts 2 的 配置 文件 除了 
管理 Action、Result 之 外 ， 还 需要 管理 拦截 器 、 异 常 处 理 等 相关 信息 ，Convention 使 用 Annotation 来 
管理 这 些 配置 。 除 此 之 外 ，Convention 还 允许 使 用 Annotation 管理 Action 和 Result 的 配置 ， 从 而 着 盖 
Convention 的 约定 。 

关于 Convention 插件 相关 Annotation 的 介绍 ， 本 书 由 于 篇 幅 原因 不 再 详 述 。 对 此 感 兴趣 的 读者 可 
以 参考 《Struts 2.1 权威 指南 》 一 书 。 


3.10 使 用 Struts 2 的 国际 化 


程序 国际 化 是 商业 系统 的 一 个 基本 要 求 ， 因 为 今天 的 软件 系统 不 再 是 简单 的 单机 程序 ， 往 往 都 

是 一 个 开放 系统 ， 需 要 面 对 来 自 全 世界 各 个 地 方 的 浏览 者 ， 因 此 ， 国 际 化 是 商业 系统 中 不 可 或 缺 的 
-部 分 。 

Struts 2 的 国际 化 是 建立 在 Java 国际 化 的 基础 之 上 ， 一 样 也 是 通过 提供 不 同 国家 /语言 环境 的 消息 
资源 ， 然 后 通过 ResourceBundle 加 载 指定 Locale 对 应 的 资源 文件 ， 再 取得 该 资源 文件 中 指定 key 对 应 
的 消息 一 一 整个 过 程 与 Java 程序 的 国际 化 完全 相同 ， 只 是 Struts 2 框架 对 Java 程序 国际 化 进行 了 进 一 
步 封装 ， 从 而 简化 了 应 用 程序 的 国际 化 。 

关于 Java 程序 国际 化 的 相关 知识 ， 请 读者 自行 参考 疯狂 Java 体系 的 《疯狂 Java 讲义 》 一 书 ， 在 
该 书 的 9.6 节 有 关于 Java 程序 国际 化 的 详细 介绍 。 


》》3.10.1 Struts 2 中 加 载 全 局 资源 文件 


Struts 2 提供 了 很 多 加 载 国际 化 资源 文件 的 方式 , 最 简单 、 最 常用 的 就 是 加 载 全 局 的 国际 化 资源 文 
件 ， 加载 全 局 的 国际 化 资源 文件 的 方式 通过 配置 常量 来 实现 。 不 管 在 struts.xml 文件 中 配置 常量 , 还 是 
在 struts.properties 文件 中 配置 常量 ， 只 需要 配置 struts.custom.il8n.resources 常量 即 可 。 
配置 struts.custom.il8n.resources 常量 时 ， 该 常量 的 值 为 全 局 国际 化 资源 文件 的 baseName。 
-有 旦 指定 了 全 局 的 国际 化 资源 文件 ， 即 可 实现 程序 的 国际 化 。 
假设 系统 需要 加 载 的 国际 化 资源 文件 的 baseName 为 messageResource ， 则 我 们 可 以 在 
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struts.properties 文件 中 指定 如 下 一 行 : 
# 指 定 Struts 2 国际 化 资源 文件 的 baseName 为 messageResource 
struts.custom.il8n. sageResource 
或 者 在 struts.xml 文件 中 配置 如 下 的 一 个 常量 : 


<!-- 指定 Struts 2 国际 化 资源 文件 的 baseName 为 messageResource -> 
<constant name="struts.custom.ilB8n.resources" value="messageResource"/> 


通过 这 种 方式 加 载 国际 化 资源 文件 后 ，Struts 2 应 用 就 可 以 在 所 有 地 方 取出 这 些 国 际 化 资源 文件 
了 ， 包 括 JSP 页 面 和 Action。 


》>》>3.10.2 访问 国际 化 消息 


Struts 2 既 可 以 在 JSP 页 面 中 通过 标签 来 输出 国际 化 消息 ， 也 可 以 在 Action 类 中 输出 国际 化 消息 。 
不 管 采用 哪 种 方式 ，Struts 2 都 提供 了 非常 简单 的 支持 。 
Struts 2 访问 国际 化 消息 主要 有 如 下 三 种 方式 。 
> ”为 了 在 JSP 页 面 中 输出 国际 化 消息 ， 可 以 使 用 Struts 2 的 <s:text .…/> 标 签 ， 该 标签 可 以 指定 
-个 name 属性 ， 该 属性 指定 了 国际 化 资源 文件 中 的 key。 

> 为 了 在 Action 类 中 访问 国际 化 消息 ， 可 以 使 用 ActionSupport 类 的 getText 方法 ， 该 方法 可 
以 接受 一 个 name 参数， 该 参数 指定 了 国际 化 资源 文件 中 的 key。 

> ”为 了 在 该 表单 元 素 的 Label 里 输出 国际 化 信息 , 可 以 为 该 表单 标签 指定 一 个 key 属性 , 该 key 
指定 了 国际 化 资源 文件 中 的 key。 

假设 系统 提供 如 下 两 份 资源 文件 。 

程序 清单 ，codes\03\3.10\18N\WWEB-INF\src\imess_en_US.properties 


# 资 源 文件 的 内 容 就 是 key-value 对 
loginpage=Login Page 
errorPage=Error Page 
succPage=Welcome Page 
failTip=Sorry, You can't log in! 
succTip=welcome, you has logged in! 
user=User Name 

pass=User Pass 

login=Login 


上 面 的 文件 以 mess_en_US.properties 文件 名 保存 ， 表 明 该 国际 化 资源 文件 的 baseName 是 mess， 
国 的 次 涯 这 作 


接 下 来 为 该 应 用 提供 中 文 环境 的 资源 文件 ， 资 源 文件 代码 如 下 。 
程序 清单 :codes\033.10\18N\WEB-INF\src\mess.properties 


loginPage= 登 录 页 面 
errorPage= 错 误 页 面 
succPage= 成 功 页 面 
failTip= 对 不 起 ， 和 
succTip= 欢 迎 ， 您 已 经 登 
user= 用 户 名 

pass= 密 码 

login= 登 录 


熟悉 国际 化 的 读者 应 该 知道 : 对 于 包含 非 西欧 字符 的 国际 化 资源 文件 必须 使 用 native2ascii 工具 进 
行 处 理 ， 使 用 该 命令 来 处 理 上 面 的 资源 文件 ， 将 处 理 后 的 资源 文件 命名 为 mess_zh_CN.properties， 表 
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明 是 简体 中 文 的 资源 文件 ， 将 这 份 资源 文件 保存 在 WEB-INF/classes 路 径 下 。 

提供 了 上 面 两 份 资源 文件 后 ， 通 过 上 一 节 所 介绍 的 方式 加 载 国 际 化 资源 文件 ， 系 统 会 根据 浏览 者 
所 在 的 Locale 来 加 载 对 应 的 语言 资源 文件 。 

下 面 是 login.jsp 页 面 的 代码 。 

程序 清单 : codes\03\3.10\18NWoginjsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 

<%@taglib prefix="s" uri="/struts-tags"%®> 

<!IDOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 

‘<html xmlns="http://www.w3.org/1999/xhtml"> 

<head> 

<!-- 使 用 s:text 标签 输出 国际 化 消息 --> 

<title><s:text name="loginPage"/></title> 

</head> 

<body> 

<s:form action="Login"> 
<!-- 在 表单 元 素 中 使 用 key 来 指定 国际 化 消息 的 key --> 
textfield name="username" key="user"/> 
textfield name="password" key="pass"/> 

<s:submit key="login"/> 

</s:form> 

</body> 

</html> 

上 面 的 JSP 页 面 中 使 用 了 <s:text .… 记 标签 来 直接 输出 国际 化 信息 ， 也 通过 在 表单 元 素 中 指定 key 

属性 来 输出 国际 化 消息 。 通 过 这 种 方式 ， 就 可 以 完成 JSP 页 面 中 普通 文本 、 表 单元 素 标签 的 国际 化 。 

如 果 在 简体 中 文 环境 下 浏览 该 页 面 ， 将 看 到 如 图 3.28 所 示 的 页 面 。 

如 果 将 浏览 器 的 语言 /区 域 环境 修改 成 美国 英语 环境 ， 再 次 浏览 该 页 面 ， 将 看 到 如 图 3.29 所 示 的 


页 面 。 


图 3.28 简体 中 文 环境 下 的 页 面 图 3.29 美国 英语 语言 环境 下 的 页 面 
如 果 想 在 Action 中 访问 国际 化 消息 ， 则 可 以 利用 ActionSupport 类 的 getText 方法 。 下 面 是 本 示例 
应 用 中 Action 类 的 代码 。 


程序 清单 : codes\03\3.10\[18N\WEB-INF\src\org\crazyit\app\action\LoginAction.java 
public class LoginAction extends ActionSupport 


{ 
// 定 义 封装 请 求 参数 的 两 个 属性 
Private String username; 
private string password; 
// 省 略 两 个 属性 的 setter 和 getter 方法 


public String executel() throws Exception 
{ 
ActionContext ctx = ActionContext.getContext (); 
if (getUsername() .equals("crazyit.org") 
&& getPassword() .equals ("leegang") ) 
{ 
ctx.getSession().put ("user" , getUsername()); 
ctx.put("tip" , getText("sucoTip")); 
return SUCCESS; 
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} 


else 


ctx.put("tip" , getText("failTip")); 
return ERROR; 


} 


上 面 的 代码 中 粗 体 字 代 码 取出 了 国际 化 资源 文件 中 key 为 succTip 的 信息 ， 并 将 其 设置 成 request 
范围 的 属性 。 通 过 这 种 方式 ， 即 使 Action 需要 设置 在 下 一 个 页 面 显 示 的 信息 ， 也 无 须 直接 设置 字符 串 
常量 ， 而 是 使 用 国际 化 消息 的 key 来 输出 ， 从 而 实现 程序 的 国际 化 。 


> 3.10.3 输出 带 占 位 符 的 国际 化 消息 


熟悉 国际 化 的 读者 可 能 会 想到 : 国际 化 消息 可 能 包含 占 位 符 ， 这 些 占 位 符 必须 使 用 参数 来 填充 。 
在 Java 程序 的 国际 化 中 ， 我 们 可 以 使 用 MessageFormat 类 来 完成 填充 这 些 占 位 符 。 而 Struts 2 则 提供 
了 更 简单 的 方式 来 填充 占 位 符 ，Struts 2 中 提供 了 如 下 两 种 方式 来 填充 消息 字符 串 中 占 位 符 。 

> ”如 果 需 要 在 JSP 页 面 中 填充 国际 化 消息 里 的 占 位 符 ， 则 可 以 通过 在 <s:text .… /> 标签 中 使 用 


多 个 <s:param .…/> 标 签 来 填充 消息 中 的 占 位 符 。 第 一 个 <s:param .…/> 标 签 指定 第 一 个 占 位 符 
值 ， 第 二 个 <s:param .…/> 标 签 指定 第 二 个 占 位 符 值 …… 

如 果 需 要 在 Action 中 填充 国际 化 消息 里 的 占 位 符 ， 则 可 以 通过 在 调用 getText 方法 时 使 用 
getText(String aTextName, List args) 或 getText(String key, String[] args) 方 法 来 填充 占 位 
符 。 该 方法 的 第 二 个 参数 既 可 以 是 一 个 字符 串 数组 ， 也 可 以 是 字符 串 组 成 的 List 对 象 ， 从 而 
完成 对 占 位 符 的 填充 。 其 中 字符 串 数组 、 字 符 串 集合 中 第 一 个 元 素 将 填充 第 一 个 占 位 符 ， 字 
符 串 数组 、 字 符 串 集合 中 第 二 个 元 素 将 填充 第 二 个 占 位 符 …… 


假设 国际 化 资源 文件 中 有 如 下 三 条 国际 化 消息 。 
程序 清单 :codes\03\3.10\placeholderl18N\WEB-INF\src\mess.properties 


# 三 条 带 占 位 符 的 国际 化 消息 

failTip~{0)， 对 不 起 ， 您 不 能 登录 ! 

succTip={0}， 欢迎， 您 已 经 登录 ! 

welcomeMsg={0}， 您 好 ! 现在 时 间 是 {1)! 

这 三 条 国际 化 消息 对 应 的 英文 消息 如 下 。 

程序 清单 ，codes\03\3.10\placeholderl18N\WEB-INF\src\imess_en_US.properties 


failTip={0},Sorry, You can't 1og in! 
succTip={0},Welcome, you has logged in! 
welcomeMsg={0}, Hello!Now is {1}! 


为 了 在 Action 类 中 输出 带 占 位 符 的 消息 ,我 们 在 Action 类 中 调用 ActionSupport 类 的 getText 方 法， 
调用 该 方法 时 ， 传 入 用 于 填充 占 位 符 的 参数 值 。 访 问 该 带 占 位 符 消息 的 Action 类 如 下 : 
程序 清单 : codes\033.10\placeholderl18N\WWEB-INF\src\org\crazyit\app\action\LoginActionjava 
public class LoginAction extends ActionSupport 


{ 
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// 封 装 用 户 请 求 参数 的 username 和 password 属性 
private String username; 

private String password; 

// 省 略 两 个 属性 的 setter 和 getter 方法 


public String execute() throws Exception 
{ 
ActionContext ctx = ActionContext.getContext(); 
if (getUsername () .equals ("crazyit.org") 
55 getPassword().equals ("leegang") ) 
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ctx.getSession().put ("user" , getUsername()); 

// 根 据 key 取出 国际 化 消息 ， 并 为 占 位 符 指定 值 

ctx.put("tip" , getText("succTip" , new String[] 
{getUsername () })) ; 

return SUCCESS; 


// 根 据 key 取出 国际 化 消息 ， 并 为 占 位 符 指定 值 

otx.put("tip" , getText("failTip", new String[] 
{getUsername () })); 

return ERROR; 


} 


通过 上 面 的 带 参数 的 getText 方法 ， 就 可 以 为 国际 化 消息 的 占 位 符 指定 值 了 。 
为 了 在 JSP 页 面 中 输出 带 两 个 占 位 符 的 国际 化 消息 ， 只 需要 为 <s:text .… 信 标签 指定 两 个 
<s:param .… 户 子 标签 即 可 。 下 面 是 welcomejsp 页 面 的 代码 。 
程序 清单 : codes\03\3.10\placeholderl18N\welcome.jsp 
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" > 
<%@taglib prefix="s" uri="/struts-tags"®> 
<!1DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0org/1999/xhtml"> 
<head> 
<title><s:text name="succPage"/></title> 
</head> 
<body> 
S${requestScope. tip} <br/> 
eBean id="d" class="java.util.Date" scope="page"/> 
<s:text name="welcomeMsg"> 
<a:param><s:property value="username"/></s:param> 
<s:param>${d}</s:param> 
</s:text> 
</body> 
</html> 


上 面 的 页 面 使 用 ${requestScope.tip} 输 出 的 是 Action 类 中 取出 的 国际 化 消息 ， 而 通过 <s:text …/> 标 
签 取出 的 是 key 为 welcomeMsg 的 国际 化 消息 ， 且 使 用 了 两 个 <param … 人 > 标签 为 该 国际 化 消息 的 两 个 
占 位 符 指定 了 值 。 

如 果 简 体 中 文 语言 环境 下 用 户 通过 登录 页 面 登录 成 功 ， 进 入 welcomejsp 页 面 ， 将 看 到 如 图 3.30 
所 示 的 页 面 。 - 


图 3.30 简体 中 文 语言 环境 下 的 欢迎 页 面 


从 上 面 的 介绍 中 可 以 看 出 ，Struts 2 中 完成 程序 国际 化 更 加 简单 ,这 都 得 益 于 Struts 2 的 简单 封装 。 
除 此 之 外 ，Struts 2 还 提供 了 对 占 位 符 的 一 种 替代 方式 , 这 种 方式 直接 允许 在 国际 化 消息 中 使 用 表 
达 式 ， 对 于 这 种 方式 ， 则 可 避免 在 使 用 国际 化 消息 时 需要 为 占 位 符 传 入 参数 值 。 
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将 上 面 的 三 条 消息 资源 改 为 如 下 形式 : 

failTip=${! }， 对 不 起 ， 您 不 能 登录 ! 

succTip=${ }， 欢 迎 ， 您 已 经 登录 ! 

welcomeMsg=${username}， 您 好 ! 现在 时 间 是 {0}! 

这 样 我 们 就 可 以 将 LoginAction 类 的 execute 方法 代码 修改 成 如 下 形式 : 
public String execute() throws Exception 

{ 


ActionContext ctx = ActionContext .getContext(); 
if (getUsername() .equals("crazyit.org") 
55 getPassword() .equals ("leegang") ) 


ctx.getSession() .put ("user" , getUsername()); 
// 根 据 key 取出 国际 化 消息 ， 并 为 占 位 符 指定 值 。 
etx.Put ("tip"” , getText("succTip")); 

return SUCCESS; 


// 根 据 key 取出 国际 化 消息 ， 并 为 占 位 符 指定 值 。 
ctx.put("tip" , getText("failTip")); 
return ERROR; 


从 上 面 的 粗 体 字 代码 来 看 ， 程 序 直接 取出 了 key 为 succTip 和 failTip 的 国际 化 消息 ， 但 因为 这 两 
条 国际 化 消息 中 使 用 了 表达 式 ， 所 以 Action 中 的 属性 值 依然 可 以 传 入 国际 化 消息 中 。 

不 仅 如 此 ，JSP 页 面 使 用 上 面 key 为 welcomeMsg 的 国际 化 消息 时 ，Struts 2 同样 会 自动 使 用 
username 属性 值 填充 国际 化 消息 ， 因 此 该 消息 只 要 使 用 一 个 <param... 人 > 元 素来 传 入 参数 值 即 可 。 如 下 
为 页 面 片段 ， 

<s:text name="welcomeMsg"> 


<s:param>$ {d}</s:param> 
</s:text> 


关于 在 国际 化 消息 资源 中 使 用 表达 式 的 示例 可 以 参考 光盘 codes\03\3.10\ 路 径 下 的 exprl18N 应 用 ， 
读者 可 通过 运行 该 应 用 了 解 更 多 细节 。 

在 上 面 的 消息 资源 中 ,通过 使 用 表达 式 ， 可 以 从 ValueStack 中 取出 该 usermame 属性 值 ， 自 动 填充 
到 该 消息 资源 中 。 通 过 这 种 方式 ， 当 需要 在 Action 类 中 使 用 该 消息 资源 时 ， 就 无 须 为 该 消息 资源 传 入 
参数 了 。 即 可 以 将 该 Action 类 改 为 最 开始 的 样子 ， 当 使 用 getText 方法 获取 国际 化 消息 时 ， 无 须 为 消 
息 资 源 中 的 占 位 符 传 入 参数 。 


> >3.10.4 加载 资源 文件 的 方式 


前 面 介绍 了 Struts 2 中 加 载 国际 化 资源 的 最 常用 方式 ， 除 此 之 外 ，Struts 2 还 提供 了 多 种 方式 来 加 
载 国际 化 资源 文件 ， 包 括 指定 包 范 围 资 源 文件 、Action 范围 资源 文件 ， 以 及 临时 指定 资源 文件 等 。 

1. 包 范 围 资源 文件 

对 于 一 个 大 型 应 用 而 言 ， 国 际 化 资源 文件 的 管理 也 是 一 个 非常 “浩大 ”的 工程 ， 因 为 整个 应 用 中 
有 大 量 内 容 需 要 实现 国际 化 ， 如 果 我 们 将 所 有 的 国际 化 资源 都 放 在 同一 个 全 局 文件 里 ， 这 将 是 不 可 想 
象 的 事情 。 

为 了 更 好 地 体现 软件 工程 里 “分 而 治之 ”的 原则 ，Struts 2 允许 针对 不 同 模块 、 不 同 Action 来 组 
织 国际 化 资源 文件 。 

为 Stmts 2 应 用 指定 包 范围 资源 文件 的 方法 是 : 在 包 的 根 路 径 下 建立 多 个 文件 名 为 
package_language_country.properties 的 文件 ,一 旦 建立 了 这 个 系列 的 国际 化 资源 文件 ， 应 用 中 处 于 该 包 
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下 的 所 有 Action 都 可 以 访问 该 资源 文件 。 


本 二 .往生 ， 间 - 
上 面 的 包 范围 次 源 文件 的 baseName 就 是 package, 不 是 Action 所 在 的 包 名 . 该 文件 ey 


通常 只 需 放 在 该 包 的 根 路 径 下 即 


例如 ， 有 如 下 的 Action 类 。 


程序 清单 : codes\03\3.10\packageScope\WWEB-INF\src\org\crazyit\app\action\LoginAction.java 
package org.crazyit.app.action; 

// 此 处 省 略 了 导入 包 的 语句 

poblie class LoginAction extends Actionsupport 


{ 
// 下 面 定义 了 两 个 属性 ， 用 于 封装 请 求 参数 
private String username; 
private String password; 
// 此 处 省 略 了 属性 的 setter 和 getter 方法 


// 处 理 用 户 请 求 的 execute 方法 
public String execute() throws Exception 
{ 
ActionContext ctx = ActionContext.getContext(); 
if (getUsername () .equals("crazyit.org") 
&5 getPassword() .equals("leegang") ) 


ctx.getSession() .put ("user" , getUsername()); 
ctx.put ("tip" , getText("sucoTip")); 
return SUCCESS; 


ctx.put("tip" , getText("failTip")); 
return ERROR; 


上 面 的 Action 没有 任何 特殊 之 处 ， 只 是 粗 体 字 代 码 通 过 ActionSupport 提供 的 getText0 方 法 访问 
了 国际 化 资源 文件 里 国际 化 消息 。 

接着 我 们 提供 如 下 两 份 资源 文件 ,第 一 份 资源 文件 :package.properties( 该 文件 还 需 使 用 native2ascii 
工具 人 处理， 处 理 后 的 新 文件 名 为 package_zh_CN.properties)， 文 件 内 容 为 : 


failTip= 包 范围 消息 ， 对 不 起 ， 您 不 能 登录 ! 
succTip= 包 范围 消息 欢迎， 您 已 经 登录 ! 


第 二 份 资源 文件 ，package_en_US.properties， 文 件 内 容 为 : 


failTip=Package Scope:Sorry,You can't log in! 
succTip=Package Scope:welcome,you has logged in! 


将 这 两 份 资源 文件 保存 在 WEB-INF/classes/app 路 径 下 ， 该 资源 文件 就 可 以 被 位 于 app 包 ， 包 括 
app 包 以 及 其 所 有 子 包 下 的 所 有 Action 访问 了 。 

实际 上 我 们 还 在 该 应 用 的 类 加 载 路 径 下 提供 了 国际 化 资源 文件 ， 甚 至 也 提供 了 failTip 和 succTip 
两 个 key 的 国际 化 消息 。 

因此 ， 当 我 们 在 简体 中 文 语言 环境 下 成 功 登录 时 ， 将 看 到 如 图 3.31 所 示 的 页 面 。 

从 图 3.31 可 以 看 出 ，Struts 2 成 功 使 用 了 包 范围 的 国际 化 资源 文件 。 不 仅 如 此 ， 我 们 还 可 以 得 到 

-个 结论 ，Action 将 优先 使 用 包 范 围 的 资源 文件 ， 虽 然 本 应 用 也 提供 了 全 局 范围 的 资源 文件 ， 但 系统 

输出 包 范 围 资源 文件 里 succTip 和 failTip， 这 就 可 见 Action 优先 使 用 包 范 围 的 资源 文件 。 
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图 3.31 输出 包 范围 国际 化 消息 的 效果 


2. Action 范围 资源 文件 

除 此 之 外 ，Struts 2 还 允许 为 Action 单独 指定 一 份 国际 化 资源 文件 。 为 Action 单独 指定 国际 化 资 
源 文件 的 方法 是 : 在 Action 类 文件 所 在 的 路 径 建 立 多 个 文件 名 为 ActionName_language_country. 
properties 的 文件 ， 一 旦 建立 了 这 个 系列 的 国际 化 资源 文件 ， 这 系列 资源 文件 只 能 由 该 Action 来 访问 。 

还 是 使 用 上 面 应 用 中 的 Action 类 ,该 Action 类 的 类 文件 位 于 WEB-INF/classes/org/crazyiVapp/action 
路 径 下 ， 于 是 我 们 新 增 如 下 两 份 资源 文件 。 

第 一 份 文件 的 文件 名 为 ， LoginAction.properties， 将 该 文件 保存 在 WEB-INF/classes/org/crazyit/ 
app/action 路 径 下 (该 文件 还 需 使 用 native2ascii 工具 处 理 , 处 理 后 的 新 文件 名 为 LoginAction.properties )。 
该 文件 的 内 容 为 


failTip=Action 范围 消息 ， 对 不 起 ， 您 不 能 登录 ! 
succTip=Action 范围 消息 ， 欢 迎 ， 您 已 经 登录 ! 


第 二 份 文件 的 文件 名 为 ， LoginAction_en_US.properties， 将 该 文件 也 保存 在 WEB-INF/ classes/lee/ 
action 路 径 下 。 该 文件 的 内 容 为 : 


failTip=Action Scope:Sorry, You can't 16g inl 
succTip=Rction Scope:welcome,you has logged in! 


- 旦 我 们 提供 了 这 两 份 资源 文件 后 ,org.crazyit.app.action.LoginAction 将 优先 加 载 Action 范围 的 资 

源 文件 ， 如 果 我 们 使 用 简体 中 文 语言 环境 ， 登 录 成 功 将 看 到 如 图 3.32 所 示 的 页 面 。 
通过 使 用 这 种 Action 范围 的 资源 文件 ， 我 们 就 可 以 在 不 同 的 Action 里 使 用 相同 的 key 名 来 表示 不 
同 的 字符 串 值 。 例 如 ， 在 ActonOne 中 title 为 “动作 一 "， 还 可 用 title 在 ActionTwo 中 则 可 以 表示 “动作 
-”， 这 样 就 可 以 简化 key 的 命名 ， 无 须 像 Struts1 中 使 用 loginForm.title、registForm.title 来 以 示 区 分 了 。 


图 3.32 Action 范围 的 国际 化 资源 文件 优先 


3. 临时 指定 资源 文件 

还 有 一 种 临时 指定 资源 文件 的 方式 ， 可 以 在 JSP 页 面 中 输出 国际 化 消息 时 临时 指定 国际 化 资源 的 
位 置 。 在 这 种 方式 下 ， 需 要 借助 Strurts 2 的 另外 一 个 标签 :<s:il8n .…/>。 

如 果 把 <s:il8n .… 户 标签 作为 <s:text .… 亿 标签 的 父 标签 ， 则 <s:text .… 亿 标签 将 会 直接 加 载 <s:ilgn .… 往 
标签 里 指定 的 国际 化 资源 文件 ， 如 果 把 <s:il8n .… 人 > 标签 当成 表单 标签 的 父 标签 ， 则 表单 标签 的 key 属 
性 将 会 从 国际 化 资源 文件 中 加 载 该 消息 。 

下 面 提供 如 下 两 份 资源 文件 ， 第 一 份 资源 文件 ， tmp.properties， 该 文件 的 内 容 如 下 。 

程序 清单 : codes\03\3.10\tmpResource\WWEB-INF\src\tmp.properties 


# 在 JSP 页 面 使 用 的 临时 资源 文件 
loginPage= 临 时 消息 登录 页 面 
errorPage= 临 时 消息 ， 错 误 页 面 
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succPage= 临 时 消息 : 成 功 页 面 

failTip= 临 时 消息 ;全 局 消息 : 对 不 起 ， 您 不 能 登录 ! 
succTip= 临 时 消息 :全 局 消息 ， 欢迎， 您 已 经 登录 ! 
user= 临 时 消息 : 用 户 名 

Pass= 临 时 消息 ; 密码 

login= 临 时 消息 ， 登 录 


将 这 份 文件 保存 在 WEB-INF/classes 路 径 下 当然 还 要 用 native2ascii 工具 来 处 理 这 份 文件 ， 处 理 
后 的 新 文件 为 tmp_zh_CN.properties)。 

第 二 份 资源 文件 ，tmp_en_US.properties， 这 份 资源 文件 的 内 容 如 下 。 

程序 清单 : codes\03\3.10\tmpResource\WEB-INF\src\tmp_en_US.properties 


# 在 JSP 页 面临 时 使 用 的 资源 文件 

loginpage=Temp Message:Login Page 

errorPage=Temp Message:Error Page 

succPage=Temp Message:Welcome Page 

failTip=Temp Messar lobal Mess: Sorry,You can't log in! 

succTip=Temp Message:Global Message:welcome,you has logged in! 

user=Temp Message:User Name 

pass=Temp Message:User Pass 

login=Temp Message:Login 

这 份 文件 也 被 保存 在 WEB-INF/classes 路 径 下 ， 我 们 无 须 指 定 系统 加 载 该 资源 文件 ， 可 以 直接 在 
JSP 页 面 中 通过 <s:il8n .人 > 标签 来 使 用 该 资源 文件 了 。 下 面 是 系统 登录 页 面 的 页 面 代码 。 

程序 清单 : codes\03\3.10\tmpResource\Login.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $%> 

<%@taglib prefix="s" uri="/struts-tags"%> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head> 

<!-- 使 用 i18n 作为 s:text 标签 的 父 标签 


临时 指定 国际 化 资源 文件 的 baseName 为 tmp -> 
使 用 s:text 输出 国际 化 消息 --> 


<4-- 使 用 i18n 作为 s:from 标签 的 父 标签 ， FF 
临时 指定 国际 化 资源 文件 的 baseName 为 tmp --> 

<s:ilgn name="tmp"> 

<s:form action="Login"> 
<s:textfield name="username" key="user"/> 
<s:textfield name="password" key="pass"/> 
<s:submit 的 

</s: form> 

</s:ilgn> 

</body> 

</html> 


上 面 的 页 面 中 两 处 粗 体 字 代 码 临 时 指定 了 该 JSP 页 面 所 使 用 的 国际 化 资源 文件 ， 在 浏览 吕 中 浏 览 
该 页 面 ， 将 看 到 如 图 3.33 所 示 的 页 面 。 


图 3.33 在 JSP 页 面临 时 指定 国际 化 资源 文件 
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>>3.10.5 ”加载 资 源 文件 的 顺序 


Struts 2 提供 了 如 此 多 的 方式 来 加 载 国际 化 资源 文件 , 这 些 加 载 国际 化 资源 文件 的 方式 有 自己 的 优 
先 顺序 。 假 设 我 们 需要 在 ChildAction 中 访问 国际 化 消息 ， 则 系统 加 载 国际 化 资源 文件 的 优先 级 是 ; 

@ 优先 加 载 系统 中 保存 在 ChildAction 的 类 文件 相同 位 置 ， 且 baseName 为 ChildAction 的 系列 资 
源 文件 。 

回 如 果 在 @ 中 找 不 到 指定 key 对 应 的 消息 ， 且 ChildAction 有 父 类 ParentAction， 则 加 载 系统 中 保 
存在 ParentAction 的 类 文件 相同 位 置 ， 且 baseName 为 ParentAction 的 系列 资源 文件 。 

@ 如 果 在 @@ 中 找 不 到 指定 key 对 应 的 消息 ， 且 ChildAction 有 实现 接口 IChildAction， 则 加 载 系统 
中 保存 在 IChildAction 的 类 文件 相同 位 置 ， 且 baseName 为 IChildAction 的 系列 资源 文件 。 

图 如 果 在 四 中 找 不 到 指定 key 对 应 的 消息 ， 且 ChildAction 有 实现 接口 ModelDriven (即使 用 模 
型 驱动 模式 )， 则 对 于 getModel0 方 法 返回 的 model 对 象 ， 重 新 执行 第 〇 步 操作 。 

回 如 果 在 @ 中 找 不 到 指定 key 对 应 的 消息 ， 则 查找 当前 包 下 baseName 为 package 的 系列 资源 
文件 。 

如 果 在 @@ 中 找 不 到 指定 key 对 应 的 消息 ， 则 沿 着 当前 包 上 滴 ， 直 到 最 顶层 包 来 查找 baseName 
为 package 的 系列 资源 文件 。 

@ 如 果 在 @ 中 找 不 到 指定 key 对 应 的 消息 , 则 查找 struts.custom.il8n.resources 常量 指定 baseName 
的 系列 资源 文件 。 

如 果 经 过 上 面 的 步骤 一 直 找 不 到 该 key 对 应 的 消息 ， 将 直接 输出 该 key 的 字符 串 值 ， 如 果 
在 上 面 的 步骤 四 一 @ 的 任 一 步 中 ,找到 指定 key 对 应 的 消息 ,系统 停止 搜索 ,直接 输出 该 key 对 应 
的 消息 。 

对 于 在 JSP 中 访问 国际 化 消息 ， 则 简单 得 多 ， 它 们 又 可 以 分 成 两 种 形式 : 

> ”对 于 使 用 <s:i18n .…/> 标 签 作为 父 标签 的 <s:text .…/> 标 签 、 表 单 标签 的 形式 

@ 将 从 <s:il8n .… 记 标签 指定 的 国际 化 资源 文件 中 加 载 指定 key 对 应 的 消息 。 

@ 如 果 在 中 找 不 到 指定 key 对 应 的 消息 , 则 查找 struts.custom.il8n.resources 常量 指定 baseName 
的 系列 资源 文件 。 

图 如 果 经 过 上 面 的 步骤 一 直 找 不 到 该 key 对 应 的 消息 , 将 直接 输出 该 key 的 字符 串 值 , 如 果 在 上 
面 的 步骤 @ 一 @ 的 任 一 步 中 ， 找 到 指定 key 对 应 的 消息 ， 系 统 停止 搜索 ， 直 接 输 出 该 key 对 应 的 消息 。 

> ”如 果 <s:text .…/> 标 签 、 表 单 标签 没有 使 用 <s:i18n .…/> 标 签 作为 父 标签 

直接 加 载 struts.custom.il8n.resources 常量 指定 baseName 的 系列 资源 文件 ,如 果 找 不 到 该 key 对 应 
的 消息 ， 将 直接 输出 该 key 的 字符 串 值 ， 否 则 ， 输 出 该 key 对 应 的 国际 化 消息 。 


3.11 使 用 Struts 2 的 标签 库 


Struts 2 也 提供 了 大 量 标签 来 帮助 开发 表现 层 页 面 ， 与 Stmutsl 的 标签 库 相 比 ，Struts 2 的 标签 库 功 
能 更 加 强大 ， 而 且 更 加 简单 易 用 。 


》>>3.11.1 Struts 2 标签 库 概述 


与 Struts1 标签 库 相 比 ，Struts 2 的 标签 库 有 一 个 巨大 的 改进 之 处 ，Struts 2 标签 库 的 标签 不 依赖 于 
任何 表现 层 技术 ， 也 就 是 说 ，Struts 2 提供 的 大 部 分 标签 ， 可 以 在 各 种 表现 层 技术 中 使 用 ， 包 括 最 常用 
的 JSP 页 面 ， 也 可 以 在 Velocity 和 FreeMarker 等 模板 技术 中 使 用 。 
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二 


营 
' 生 . 注 惠 :* … 

虽然 Struts 2 大 部 分 标签 可 以 在 所 有 表现 层 技术 中 使 用 ， 但 也 有 极 少 数 标签 在 某 些 
这 更 技 扰 下 中 全 用 时 会 受到 限制 ， 二 请 开发 者 务 要 注意 。 


Struts 2 不 像 Stmtsl 那样 ， 对 整个 标签 库 提供 了 严格 的 分 类 ， Struts 2 把 所 有 标签 都 定义 在 一 个 s 
标签 库 里 。 虽 然 Struts 2 把 所 有 的 标签 都 定义 在 URI 为 “/struts-tags” 的 空间 下 , 但 我 们 依然 可 以 对 Struts 
2 标签 进行 简单 的 分 类 。 从 最 大 的 范围 来 分 ，Struts 2 可 以 将 所 有 标签 分 成 如 下 三 类 。 

> ”UI (User Interface， 用 户 界面 ) 标签 : 主要 用 于 生成 HTML 元 素 的 标签 。 

> 非 UI 标签 : 主要 用 于 数据 访问 、 逻 辑 控制 等 的 标签 。 

> Ajax 标签 : 用 于 Ajax (Asynchronous JavaScript And XML) 支持 的 标签 。 

对 于 UI 标 签 ， 则 又 可 分 为 如 下 两 类 。 

> 表单 标签 ， 主 要 用 于 生成 HTML 页 面 的 form 元 素 ， 以 及 普通 表单 元 素 的 标签 。 

>  ” 非 表单 标签 ， 主 要 用 于 生成 页 面 上 的 树 、Tab 页 等 标签 。 

对 于 非 UI 标签， 也 可 分 为 如 下 两 类 。 

> ”流程 控制 标签 ， 主 要 包含 用 于 实现 分 支 、 循 环 等 流程 控制 的 标签 。 

> ”数据 访问 标签 ， 主 要 包含 用 于 输出 ValueStack 中 的 值 、 完 成 国际 化 等 功能 的 标签 。 


Struts 2 的 标签 库 分 类 如 图 3.34 所 示 。 
Suuts2 标 签订 


CE I 


图 3.34 Struts 2 标签 库 分 类 
>>3.11.2 使 用 Struts 2 标签 


上 一 章 介绍 过 开发 自 定 义 标签 的 步 又， 标签 库 开 发 包括 两 个 步骤 :开发 标签 处 理 类 和 定义 标签 库 
定义 文件 ，Struts 2 框架 已经 完成 了 这 两 个 步骤 ， 即 Struts 2 既 提供 了 标签 的 处 理 类 ， 也 提供 了 Struts 2 
的 标签 库 定义 文件 。 

使 用 WinRAR 打开 struts2-core-2.2.1.jar 文件 ， 在 该 压缩 包 的 META-INF 路 径 下 找到 struts-tags.tld 
文件 ， 这 就 是 Struts 2 的 标签 库 定义 文件 。 

下 面 是 struts-tags.tld 文件 的 片段 。 


<?xml version="1.0" encoding="UTF-8"?> 

<taglib xmlns="http://java.sun.com/xml/ns/j2ee" 
xmlns:xsi="http://www.w3. org/2001/XMLSchema-instance™ version=: 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java. sun. com/xml /ns/j2ee/web-jsptaglibrary_2_0.xsd"> 
<tlib-version>2.2</tlib-version> 
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<!-- 指定 该 标签 库 默认 的 短 名 --> 
<short-name>s</short-name> 
<!-~ 指定 该 标签 库 默 认 的 DRI--> 
<uri>/struts-tags</uri> 
<display-name>"Struts Tags"</display-name> 
</taglib> 
根据 上 - 章 的 介绍 已 经 知道 ， 在 该 标签 库 定义 文件 中 <uri .… 必 元 素 很 重要 ， 该 URI 实际 上 相当 于 
该 标签 库 的 唯一 
为 了 使 JSP 页 面具 有 更 好 的 兼容 性 ， 因 此 推荐 定义 Struts 2 标签 库 的 URI 时 ， 使 自 定义 的 Struts 2 
标签 库 URI 与 默认 的 URI 相同 。 
与 前 面 使 用 自 定义 标签 的 用 法 完全 一 样 ， 使 用 Struts 2 标签 必须 先导 入 标签 库 ， 在 JSP 页 面 中 使 
用 如 下 代码 来 导入 Struts 2 标签 库 。 


<!-- 导入 Struts 2 标签 库 --> 
<setaglib prefix="s" uri="/struts-tags"®> 


上 面 代码 用 于 导入 Struts 2 标签 库 ， 其 中 URI 就 是 Struts 2 标签 库 的 URI， 而 prefix 属性 值 是 该 标 
签 库 的 前 级 。 例 如 ， 对 于 如 下 的 标签 : 
<!-- 使 用 以 作为 前 角 的 标 答 -> 


<s:abc ... 

:上 面 标签 中 ,因为 该 标签 以 “s” 作 为 前 级 ,， 故 该 标签 需要 使 用 URI 为 /struts-tags 的 标签 库 处 理 ， 
六 系统 知道 从 Struts 2 标签 库 中 寻找 名 为 abc 的 标签 来 处 理 该 标签 (当然 ，Struts 2 标签 
库 中 不 存在 abe 标签 ， 故 此 行 代码 会 出 现 错误 )。 


》>》》>3.11.3 Struts 2 的 OGNL 表达 式 语言 


Struts 2 利用 内 建 的 OGNL (Object Graph Navigation Language ) 表达 式 语言 支持 , 大 大 加 强 了 Struts 
2 的 数据 访问 功能 ，XWork 在 原 有 的 OGNL 的 基础 上 ， 增 加 了 对 ValueStack 的 支持 。 


式 语 言 比 较 难以 理解 。 实际 上 可 能 读者 过 分 “高 估 ” 了 OGNL 表达 式 语 言 ， 实 际 上 OGNL ， 
| ”表达 式 语言 和 JSP2 EL 的 作用 完全 相似 .在 Stmuts 2 应 用 中 ， 视 图 页 面 可 通过 标 答 直 接 访 | 
:; ” 间 Action 属性 值 ( 实际 上 这 只 是 一 种 假想 ,类 似 于 Web 应 用 保持 application ,session ,request ， 
| 和 page 四 个 范围 的 “银行 "一样 ，Struts 2 自行 维护 一 个 特定 范围 的 “银行 "，Action 将 数 1 
; 。 据 放 入 其 中 ， 而 JSP 页 面 可 从 其 中 取出 数据 ， 表 面 上 似乎 JSP 可 直接 访问 Action 数据 )， 
| 。 当 Action 属性 不 是 简单 值 (基本 类 型 值 或 String 类 型 值 ) 时 ， 而 是 某 个 对 象 ， 甚 至 是 数组 、| 
| 。 集合 时 ， 就 需要 使 用 表达 式 语言 来 访问 这 些 对 象 、 数 组 、 集 合 的 内 部 数据 了 ，Stmuts2 利用 
;OGNL 表达 式 语言 来 实现 这 个 功能 。 实 际 上 ，OGNL 也 不 是 真正 的 编程 语言 ， 只 是 一 种 数 | 
| ” 据 访问 语言 . j 


二 es 
Fn 从 《Struts 2 权威 指南 》 一 书面 世 以 来 ， 笔 者 收 到 一 些 读者 来 信 ， 他 们 反应 OGNL 表达 ， 


在 传统 的 OGNL 表达 式 求 值 中 ， 系 统 会 假设 只 有 一 个 “ 根 ”对 象 。 下 面 是 标准 OGNL 表达 式 求 
值 ， 如 果 系统 的 Stack Context 中 包含 两 个 对 象 : foo 对 象 ， 它 在 Context 中 的 名 字 为 foo; bar 对 象 ， 它 
在 Context 中 的 名 字 为 bar， 并 将 foo 对 象 设置 成 Context 的 根 对 象 。 

看 如 下 三 行 代码 : 

// 返 回 foo .getBlah () 方 法 的 返回 值 

#f00.blah 

// 返 回 bar .getBlah() 方 法 的 返回 值 

#bar.blah 

// 因 为 foo 是 根 对 象 ， 所 以 默认 是 取得 foo 对 象 的 blah 属性 ， 
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// 即 返回 f00. getBlah () 方 法 的 返回 秆 
blah 


通过 上 面 代码 可 以 看 出 ，OGNL 表达 式 的 语法 非常 简洁 ， 如 果 有 如 下 的 语法 : 

#bar. fo0.blah 

上 面 代码 将 意味 着 返回 bar getFoo0).getBlah() 方 法 的 返回 值 。 如 果 需 要 访问 的 属性 属于 根 对 象 ， 则 
可 以 直接 访问 该 属性 ， 如 blah; 否则 必须 使 用 一 个 对 象 名 作为 前 缀 修饰 该 属性 ， 如 #barblah。 

Struts 2 可 以 直接 从 对 象 中 获取 属性 。Struts 2 提供 了 一 个 特殊 的 OGNL PropertyAccessor (属性 访 
问 器 )， 它 可 以 自动 搜寻 Stack Context 的 所 有 实体 (从 上 到 下 )， 直 到 找到 与 求 值 表达 式 匹 配 的 属性 。 

例如 ，Stack Context 中 包括 两 个 根 实例 ，animal 和 person， 这 两 个 实例 中 包含 “name” 属 性 ， 而 
且 animal 实例 还 有 一 个 “species” 属 性 ， 而 person 实例 还 有 一 个 “salary” 属 性 ， 其 中 animal 实例 是 
栈 项 元 素 ， 而 person 实例 在 其 后 面 。 看 下 面 的 求 值 表达 式 ， 

// 返 回 animal,getSpecies () 方 法 的 返回 值 

Species 

// 返 回 person.getSpecies1() 方 法 的 返回 值 

tute 2 先 找到 animal 实例 ， 返 回 animal .getName () 方法 的 返回 值 ， 

name 

在 最 后 的 一 行 代码 中 ， 如 果实 在 需要 取得 person 实例 的 name 属性 ， 必 须 通过 如 下 代码 : 

// 直 接 取得 person 实例 的 name 属性 


#person.name 
除 此 之 外 ， 还 可 以 通过 索引 来 访问 Stack Context 中 的 对 象 。 
例如 ， 如 下 代码 ; 


(人 animal.getName() 方 法 的 返回 值 ， 因 为 从 第 一 个 开始 找 ， 就 会 先 找到 animal 实例 
name 
// 返 回 person.getName () 方 法 的 返回 值 ， 因 为 从 第 二 个 开始 找 ， 就 会 先 找到 Person 实例 


[1] .name 
值得 注意 的 是 ， 上 面 使 用 索引 的 方式 并 不 是 直接 取得 指定 元 素 ， 而 是 从 指定 索引 开始 向 下 搜索 。 
Struts 2 使 用 标准 的 Context 来 进行 OGNL 表达 式 语言 求 值 ，OGNL 的 顶级 对 象 是 一 个 Context， 

这 个 Context 对 象 就 是 一 个 Map 类 型 实例 ， 其 根 对 象 就 是 ValueStack， 如 果 需 要 访问 ValueStack 里 的 

属性 ， 直 接 通过 如 下 方式 即 可 : 


// 取 得 valuestack 中 的 bar 属性 
S$fbar) 


除 此 之 外 ,Struts 2 还 提供 了 一 些 命名 对 象 , 但 这 些 命名 对 象 都 是 不 是 Stack Context 的 “ 根 ” 对 象 ， 
它们 只 是 存在 于 Stack Context 中 。 所 以 访问 这 些 对 象 时 需要 使 用 # 前 级 来 指明 。 
> ”parameters 对 象 用 于 访问 HTTP 请 求 参数 。 例 如 #parameters['foo"] 或 #parameters.foo， 
用 于 返回 调用 HttpServletRequest 的 getParameter("foo") 方 法 的 返回 值 。 
> ”request 对象， 用 于 访问 HttpServletRequest 的 属性 。 例 如 大 equest [foo'] 或 #request.foo， 
用 于 返回 调用 HttpServletRequest 的 getAttribute("foo") 方 法 的 返回 值 。 
> ”session 对 象 : 用 于 访问 HttpSession 的 属性 。 例 如 #session['foo"] 或 #session.foo， 用 于 返回 
调用 HttpSession 的 getAttribute("foo") 方 法 的 返回 值 。 
> application 对 象 :用 于 访问 ServletContext 的 属性 。 例 如 #application[foo'] 或 #application .foo, 
用 于 返回 调用 ServletContext 的 getAttribute("foo") 方 法 的 返回 值 。 
> attr 对 象 :该 对 象 将 依次 搜索 如 下 对 象 : PageContext、HttpServletRequest、HttpSession 、 
ServletContext 中 的 属性 。 
当 系统 创建 了 Action 实例 后 ， 该 Action 实例 已 经 被 保存 到 ValueStack 中 ， 故 无 须 书写 # 即 可 访问 
Action 属性 。 
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{ 有 些 读者 在 OGNL 这 个 地 方 感到 容易 混淆 ， 估 计 还 因为 把 OGNL 的 Stack Contex 
| 和 ValueStack 两 个 概念 摘 混 了 : OGNL 的 Stack Context 是 整个 OGNL 计算 、 求 值 的 
i Context， 而 ValueStack 只 是 StackContex 内 的 “ 根 ” 对 象 而 已 。OGNL 的 Stack Context 
里 除了 包括 ValueStack 这 个 根 之 外 ， 还 包括 parameters、request、session、application、 
attr 等 命名 对 象 ， 但 这 些 命名 对 象 都 不 是 根 。Stack Context “ 根 ” 对 象 和 普通 命名 对 象 
的 区 别 在 于 : 

今 访问 Stack Context 里 的 命名 对 象 需要 在 对 象 名 之 前 添加 # 前 组 ; yy 


略 对 象 名 。 


图 3.35 是 我 们 在 前 面 的 namespace 的 welcome.jsp 页 面 中 增加 <s:debug/> 标 签 , 浏览 者 成 功 登录 该 
应 用 , 并 单 击 “Debug ”链接 后 看 到 的 效果 , 读者 只 需 按 如 图 所 示 方式 来 访问 Value Stack 和 Stack Context 
里 的 数据 即 可 。 


Struts ValueStack Debug 


Valoe Stack Contents 


Stack Context 


Hhese frens ae aval /able wring the Mey oo 


>>3.11.4 OGNL 中 的 集合 操作 


很 多 时 候 ， 我 们 可 能 需要 一 个 集合 对 象 〈 例 如 List 对 象 ， 或 者 Map 对 象 )， 使 用 OGNL 表达 式 可 
以 直接 创建 集合 对 象 。 
直接 创建 List 类 型 集合 的 语法 为 : 


{el,e2,e3 ...} 
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上 面 语法 格式 将 创建 一 个 List 类 型 集合 ， 该 集合 包含 了 3 个 元 素 : el、e2 和 e3。 如 果 需 要 更 多 元 
素 ， 直 接 在 后 面 添加 即 可 ， 多 个 元 素 之 问 以 英文 逗号 隔 开 。 
直接 生成 Map 类 型 集合 的 语法 为 : 
#{keyl:valuel, key2: value2, ...} 
上 面 语法 格式 将 创建 一 个 Map 类 型 的 集合 ， 该 Map 对 象 中 每 个 key-value 对 象 之 间 以 英文 冒号 隔 
开 ; 多 项 之 间 以 英文 逗号 隔 开 。 
对 于 集合 ，OGNL 提供 了 两 个 运算 符 : in 和 not in， 其 中 in 判断 某 个 元 素 是 否 在 指定 集合 中 ; not 
in 则 用 于 判断 某 个 元 素 是 否 不 在 指定 集合 中 。 
看 下 面 代码 : 


<!-- 如 果 指 定 集 合 中 包含 foo 元 素 一 > 
<s:if test="'fo0' in {'fo0','bar'}"> 


</s:else> 

<!-- 如 果 指定 集合 中 不 包含 foo 元 素 一 > 

<s:if test="'fo0' not in {'foo','bar'}"> 
不 包含 

</s:if> 

<s:else> 


</s:else> 

除 此 之 外 ，OGNL 还 允许 通过 某 个 规则 取得 集合 的 子 集 。 取 得 子 集 时 有 如 下 三 个 操作 符 。 

> ? : 取出 所 有 符合 选择 逻辑 的 元 素 。 

> ^ : 取出 符合 选择 逻辑 的 第 一 个 元 素 。 

> $ : 取出 符合 选择 逻辑 的 最 后 一 个 元 素 。 

例如 ， 如 下 代码 : 

person, relatives. {? #this.gender == ‘male'} 

在 上 面 代码 中 ， 直 接 在 集合 后 紧 跟 .{ } 运 算 符 表明 用 于 取出 该 集合 的 子 集 ， 在 { } 内 使 用 ?表明 取出 
所 有 符合 选择 逻辑 的 元 素 ， 而 #this 代表 集合 里 元 素 。 因 此 ， 上 面 代码 的 含义 是 : 取出 person 的 所 有 性 
别 为 male 的 relatives (亲戚) 集合。 

从 这 些 代码 可 以 看 出 ,， 虽然 OGNL 表达 式 语言 和 JSP2 表达 式 语言 的 作用 相似 , 但 OGNL 表达 式 
语言 的 功能 更 强大 。 


>>3.11.5 访问 静态 成 员 


OGNL 表达 式 还 提供 了 一 种 访问 静态 成 员 (包括 调用 静态 方法 、 访问 静态 Field) 的 方式 , 但 Struts 
2 默认 关闭 了 访问 静态 方法 ， 只 允许 通过 OGNL 表达 式 访问 静态 Field。 为 了 让 OGNL 表达 式 可 以 访 
问 静 态 成 员 ， 应 该 在 Struts 2 应 用 中 将 struts.ognl.allowStaticMethodAccess 设置 为 true。 
例如 我 们 在 struts.xml 文件 中 增加 如 下 代码 片段 : 
<!-- 设置 允许 OGNL 允许 访问 静态 成 员 一 -> 
<constant name="struts.ognl.allowstaticMethodAccess" 
value="true"/> 
一 旦 设置 了 上 面 所 示 常 量 ，OGNL 表达 式 可 以 通过 如 下 语法 来 访问 静态 成 员 : 


eclassName@staticField 
@className@staticMethod (val. ..) 


下 面 JSP 页 面 使 用 这 种 方式 来 访问 静态 Field 和 静态 方法 : 
访问 系统 环境 变量 : <s:property value= 
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"@java. lang,System@getenv('JAVA_HOME')"/> <br /> 
圆周 率 的 值 ; <s:property value="@java.lang.Math@PI"/> 


浏览 该 页 面 可 以 看 到 如 图 3.36 所 示 效 果 。 


访问 系统 环 境 夺 量 ，D: Java\jdet.6. 0.22 
国 局 率 的 值 ， 3 14159265358973 


图 3.36 访问 静态 成 员 
>>3.11.6 Lambda (入 ) 表达 式 


OGNL 支持 基本 的 Lambda (入 ) 表达 式 语法 , 通过 这 种 Lambda 表达 式 语法 , 可 以 让 我 们 在 OGNL 
表达 式 语言 中 使 用 一 些 简单 的 函数 。 
假设 有 如 下 斐 波 那 契 数列 ; 


if n==0 return 07 
elseif n==]1 return 1; 
else return fib(n-2)+fib(n-1); 


给 定 fib(0) = 0，fib(1) = 1， 如 果 我 们 希望 根据 上 面 数列 规则 求 fib(11) 的 值 ， 那 么 我 们 可 以 使 用 如 
下 的 OGNL 表达 式 来 求 该 数列 中 第 11 个 元 素 的 值 : 


<s:property value="#fib =:[#this==0 ? 0 ; #this==l ? 1: 
#fib(#this-2)+ #fib(#this-1)], #fib(11)" /> 


在 上 面 的 代码 中 ，#fib =:[#this 一 0 ? 0 : #this 一 1 ? 1 : #fib(#this-2)+#fib(#this-1)] 表 示 定义 了 一 个 简 
单 函数 ， 上 面 表达 式 可 输出 fib(11) 的 值 。 


》 3.11.7 控制 标签 


Struts 2 的 非 UI 标签 包括 控制 标签 和 数据 标签 ， 主 要 用 于 完成 流程 控制 ， 以 及 操作 Struts 2 的 
ValueStack。 数 据 标签 主要 结合 OGNL 表达 式 进行 数据 访问 。 控 制 标签 可 以 完成 流程 控制 ， 如 分 支 、 
循环 等 ， 也 可 完成 对 集合 的 合并 、 排 序 等 操作 。 控 制 标签 有 如 下 9 个 。 

> ”if 用 于 控制 选择 输出 的 标签 。 
elself/elseif， 与 if 标签 结 合 使 用 ， 用 于 控制 选择 输出 的 标签 。 
else: 与 if 标 签 结合 使 用 ， 用 于 控制 选择 输出 的 标签 。 
append: 用 于 将 多 个 集合 拼接 成 一 个 新 的 集合 。 
generator: 它 是 一 个 字符 串 解析 器 ， 用 于 将 一 个 字符 串 解析 成 一 个 集合 。 
iterator: 这 是 一 个 迭代 器 ， 用 于 将 集合 迭代 输出 。 
merge: 用 于 将 多 个 集合 拼接 成 一 个 新 的 集合 。 但 与 append 的 拼接 方式 有 所 不 同 。 
sort: 这 个 标签 用 于 对 集合 进行 排序 。 

> ”subset: 这 个 标签 用 于 截取 集合 的 部 分 元 素 ， 形 成 新 的 子 集合 。 

下 面 依次 介绍 这 9 个 标签 。 

1. ifelseiffelse 标签 

ifyelseifyelse 这 三 个 标签 都 是 用 于 进行 分 支 控制 的 ， 它 们 都 用 于 根据 一 个 boolean 表达 式 的 值 ， 来 
决定 是 否 计算 、 输 出 标签 体 的 内 容 。 

这 三 个 标签 可 以 组 合 使 用 ， 只 有 <s:if .… 亿 标签 可 以 单独 使 用 ， 后 面 的 <s:elseif .…/> 和 <s:else … 人 > 都 
不 可 单独 使 用 ， 必 须 与 <s:if .… 记 标签 结合 使 用 ， 其 中 <s:if .… 记 标签 可 以 与 多 个 <s:elseif .… 人 > 标签 结合 使 
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用 ， 并 可 以 结合 一 个 <s:else ..… 户 标签 使 用 。 
这 三 个 标签 实质 就 是 取代 JSP 脚本 中 的 让 语言 ， 因 为 证 和 else 讶 后 都 可 以 指定 一 个 boolean 表达 
式 ， 所 以 证 标签 和 else 标签 可 接受 一 个 test 属性 ， 该 属性 确定 执行 判断 的 boolean 表达 式 。 
三 个 标签 结合 的 语法 格式 如 下 : 
<s:if test=" 表 达 式 "> 
标签 体 


</s:if> 
<s:elseif test=" 表 达 式 "> 
标签 体 


</s:elseif> 
<!-- 允许 出 现 多 次 elseif 标签 --> 


<sielsey 
标签 体 
</s:else> 
看 下 面 的 代码 片段 
程序 清单 :codes\03\3.11\controlTag\s-ifjsp 


<!-- 在 Stack Context 中 定义 一 个 age 属性 ， 其 值 为 29 --> 
<s:set name="age" value="29"/> 

<!-- 如 果 Stack Context 中 的 age 属性 大 于 60 --> 

<s:if test="#age>60"> 


</s:if> 
<!-- 如 果 Stack Context 中 的 age 属性 大 于 35 --> 
<s:elseif test="#age>35"> 

中 年 人 
</s:elseif> 
<!-- 如 果 Stack Context 中 的 age 属性 大 于 15 --> 
<s:elseif test="#age>15"> 

人 


</s:elseif> 
<s:else> 
少年 


</s:else> 
在 上 面 的 代码 中 ， 页 面 根据 age 属性 值 的 范围 来 控制 输出 。 因 为 age 的 属性 值 是 29， 故 上 面 代码 
将 输出 “青年 人 ”。 
从 上 面 的 代码 中 可 以 看 出 ，ifyelseif/else 标签 组 合 使 用 ， 作 用 类 似 于 Java 语言 里 的 igelseifyelse 条 
件 控制 结构 。 对 于 <if… 人 > 标签 和 <elseif .人 > 标签 必须 指定 一 个 test 属性 ,该 test 属性 就 是 进行 条 件 判断 
的 逻辑 表达 式 。 
2. iterator 标签 
iterator 标签 主要 用 于 对 集合 进行 迭代 ， 这 里 的 集合 包含 List、Set 和 数组 ， 也 可 对 Map 集合 进行 
迭代 输出 。 
使 用 <s:iterator .… 亿 标签 对 集合 进行 迭代 输出 时 ， 可 以 指定 如 下 三 个 属性 。 
> ”value: 这 是 一 个 可 选 的 属性 ，value 属性 指定 的 就 是 被 选 代 的 集合 ， 被 迭代 的 集合 通常 都 使 
用 OGNL 表达 式 指定 。 如 果 没 有 指定 value 属性 ， 则 使 用 ValueStack 栈 项 的 集合 。 
> ”id: 这 是 一 个 可 选 的 属性 ， 该 属性 指定 了 集合 里 元 素 的 ID。 
> ”status: 这 是 一 个 可 选 的 属性 ， 该 属性 指定 迭代 时 的 lteratorStatus 实例 ， 通 过 该 实例 即 可 判 
断 当前 迭代 元 素 的 属性 。 例 如 是 否 为 最 后 一 个 ， 以 及 当前 迭代 元 素 的 索引 等 。 
看 下 面 的 代码 片段 。 
程序 清单 : codes\03\3.11\controlTag\s-iterator-list.jsp 


<table border="1" width="200"> 
<s:iterator value="{' 首 狂 Java 讲义 '， 
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' 轻 量 级 Java EE 企业 应 用 实战 ' 。 
' 经 典 Java EE 企业 应 用 实战 '}" 
id="name"> 
<tr> 
<td><s:property value="#st.count"/> 
<s:property value="name"/></td> 
</tr> 
</s:iterator> 
</table> 


上 面 的 value 属性 是 直接 给 定 了 一 个 集合 ,集合 里 包含 了 3 个 元 素 ,指定 了 被 迭代 元 素 的 id 为 name， 
所 以 在 <s:iterator .…/> 标 签 里 ， 就 可 以 通过 <s:property value="name"/> 来 输出 每 个 集合 元 素 的 值 。 

如 果 为 <s'iterator … 亿 标签 指定 status 属性 ， 即 每 次 选 代 时 都 会 有 一 个 IteratorStatus 实例 ， 该 实例 
包含 了 如 下 几 个 方法 。 

> int getCount(): 返回 当前 迭代 了 几 个 元 素 。 


> int getlndex(): 返回 当前 选 代 元 素 的 索引 。 

> ”boolean isEven(): 返回 当前 被 选 代 元 素 的 索引 是 否 是 偶数 。 
> ”boolean isFirst(): 返回 当前 被 迭代 元 素 是 否 是 第 一 个 元 素 。 

> ”boolean isLast(): 返回 当前 被 迭代 元 素 是 否 是 最 后 一 个 元 素 。 
> ”boolean isOdd(): 返回 当前 被 选 代 元 素 的 索引 是 否 是 奇数 。 


通过 上 面 几 个 方法 ， 我 们 就 可 以 在 迭代 时 根据 当前 迭代 元 素 的 属性 来 进行 更 多 的 控制 ， 看 如 下 代 
码 片段 ， 使 用 iterator 标签 对 List 对 象 、Map 对 象 进行 和 迭代 。 
程序 清单 :codes\03\3.11\controlTag\s-iteratorjsp 


<table border="1" width="300"> 
<!1-- 迁 代 输出 List 集合 --> 
<s:iterator value="{' 狗 狂 Java 讲义 '， 
' 轻 量 级 Java EE 企业 应 用 实战 '， 
' 经 典 Java BE 企业 应 用 实战 '}" 
id="name" status="st"> 
<tr <a:if teat="#at.odd"> 
atyle="background-color:#bbbbbb"</s:if>> 
<td><s:property value="name"/></td> 
</tr> 
</s:iterator> 
</table> 
<table border="1" width="350"> 
<tr> 
<th> 书 名 </th> 
<th> 作 者 </th> 
</tr> 
<!-- 对 指定 的 Map 对 象 进行 选 代 输出 , 并 指定 status 属性 --> 
<s:iterator value="#{' 首 狂 Java 讲义 ': "李刚 'v 
' 轻 量 级 Java EE 企业 应 用 实战 ' : "李刚 " ， 
"经 典 Java EE 企业 应 用 实战 ' : "李刚 "1" 
id="score" status="st"> 
<!-- 根据 当前 被 选 代 元 素 的 索引 是 否 为 奇数 来 决定 是 否 使 用 背景 色 一 > 
<tr <a:if test="#st.odd"> 
style="background-color:#bbbbbb"</s:i£>> 
<!-- 输出 Map 对 象 里 Entry 的 key --> 
<td><s:property value="key"/></td> 
<!-- 输出 Map 对 象 里 Entry 的 value --> 
<td><s:property value="value"/3</td> 
</tr> 
</s:iterator> 
</table> 


上 面 的 程序 中 粗 体 字 代 码 用 于 根据 和 迭代 的 奇偶 行 来 控制 不 同 的 背景 色 , 从 而 提供 更 好 的 视觉 效果 。 
在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.37 所 示 的 效果 。 
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图 3.37 使 用 iterator 和 迭代 List、Map 对 象 


ifyelseifyelse 以 及 此 处 介绍 的 iterator 标签 是 Struts 2 中 最 常用 的 标签 ， 通 常 Action 会 调用 Model 
取出 大 量 数据 ， 这 些 数据 被 封装 成 VO〔Value Object) 集合 (该 集合 通常 是 List 或 Map) 传 给 JSP 页 
面 ， 而 JSP 页 面 中 则 需要 通过 这 两 个 标签 来 访问 这 些 数据 。 

3. append 标签 

append 标签 用 于 将 多 个 集合 对 象 拼接 起 来 ， 组 成 一 个 新 的 集合 。 通 过 这 种 拼接 ， 从 而 允许 通过 一 
个 <s:iterator .… 人 > 标签 就 完成 对 多 个 集合 的 迁 代 。 

使 用 <s:append .…/> 标 签 时 需要 指定 一 个 var 属性 (也 可 使 用 id 属性 ， 但 推荐 使 用 var)， 该 属性 确 
定 拼接 生成 的 新 集合 的 名 字 ， 该 新 集合 被 放 入 Stack Context 中 。 除 此 之 外 ，<s:append .… 户 标签 可 以 接 
受 多 个 <s:param .…/> 子 标签 ， 每 个 子 标签 指定 一 个 集合 ，<s:append .…/> 标 签 负责 将 <s:param …/> 标 签 指 
定 的 多 个 集合 拼接 成 一 个 集合 。 

看 如 下 代码 片段 

程序 清单 : codes\03\3.11\controlTag\s-append.jsp 


<!-- 使 用 append 标签 将 两 个 集合 拼接 成 新 的 集合 ， 
新 集合 的 名 字 是 newList， 新 集合 放 入 Stack Context 中 --> 
<s:append var="newList"> 
<s:param value="{ ,并 狂 Java 讲义 ， 


<a:param value="{'http://mmw.craryit.org', 
‘http://blog.crazyit.org'}" /> 
</s:append> 
<table border="1" width="260"> 
<!-- 使 用 iterator 选 代 newList 集合 --> 
<s:iterator value="#newList" status="st" id="ele"> 
<tr> 
<td><s:property value="#st.count"/></td> 
<td><s:property value="ele"/></td> 
</tr> 
</s:iterator> 


上 面 的 粗 体 字 代码 用 于 将 两 个 List 集合 拼接 成 新 List 对 象 , 其 中 <s:param.… 人 > 标签 用 于 为 父 标签 传 
入 参数 ， 也 就 是 传 入 需要 拼接 的 集合 。 拼 接 集合 时 指定 了 var 属性 ， 这 表明 将 拼接 得 到 的 新 集合 放 入 
Stack Context 中 。 

然后 使 用 iterator 标签 对 新 集合 进行 和 迭代。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.38 所 示 的 页 面 。 

上 面 看 到 的 代码 是 将 两 个 集合 拼接 成 一 个 新 集合 。 实际 上 如 果 传 入 更 多 的 <s:param..…/> 子 元 素 ， 则 
还 可 以 将 3 个 、4 个 以 及 更 多 个 集合 拼接 成 一 个 新 集合 。 

当然 ， 使 用 append 标签 也 可 以 将 多 个 Map 对 象 拼接 成 一 个 新 的 Map 对 象 ， 更 甚至 于 将 一 个 Map 
对 象 和 一 个 List 对 象 拼接 起 来 。 看 如 下 的 代码 片段 。 
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图 3.38 使 用 append 标签 将 两 个 集合 拼接 成 新 集合 


程序 清单 : codes\03\3.11\controlTag\s-append-map.jsp 


<!-- 使 用 append 将 List 和 Map 集合 拼接 在 一 起 
新 集合 实际 上 是 Map 集合 ， 其 名 字 为 newList --> 
<a:append var="newList"> 
<s:param value="#{' 首 狂 Java 讲义 ' : ' 李 刚 '， 
' 轻 量 级 Java 全 业 应 用 实生 ,李刚 '， 
“经 典 Java EE 企业 应 用 实战 ' : "李刚 ']m /> 
<s:param value="#{'http://www.craryit.org', 
‘http://blog.crazyit.org'}" /> 
</s:append> 
<table border="1" width="280"> 
<!-- 使 用 iterator 选 代 newList 集合 --> 
<s:iterator value="#newList" status="st"> 
<tr <s:if test="#st.odd"> 
style="background-color:#bbbbbb"</s:if>> 
<td><s:property value="key"/></td> 
<td><s:property value="value"/></td> 
</tr> 
</s:iterator> 
</table> 


上 面 的 程序 中 粗 体 字 代码 用 于 将 List 集合 和 Map 集合 拼接 在 一 起 ，List 集合 只 有 系列 值 ， 这 些 值 
将 全 部 作为 新 Map 的 key， 这 些 key 没有 对 应 的 value。 上 面 页 面 使 用 了 iterator 标签 新 集合 newList 
进行 迭代 输出 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.39 所 示 的 页 面 。 
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图 3.39 使 用 append 标签 拼接 List 和 Map 


4. generator 标签 

使 用 generator 标签 可 以 将 指定 字符 串 按 指定 分 隔 符 分 隔 成 多 个 子 串 , 临时 生成 的 多 个 子 串 可 以 使 
用 iterator 标签 来 帮 代 输出 。 可 以 这 样 理 解 : generator 将 一 个 字符 串 转化 成 一 个 Iterator 集合 。 在 该 标 
签 的 标签 体内 ， 整 个 临时 生成 的 集合 将 位 于 ValueStack 的 顶端 ， 但 一 旦 该 标签 结束 ， 该 集合 将 被 移出 
ValueStack 。 

generator 标签 的 作用 有 点 类 似 于 String 对 象 的 split0 方 法 ,但 这 个 generator 标签 比 split() 方 法 的 功 
能 更 加 强大 。 

使 用 generator 标签 时 可 以 指定 如 下 几 个 属性 。 
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count: 该 属性 是 一 个 可 选 的 属性 ， 该 属性 指定 生成 集合 中 元 素 的 总 数 。 
separator: 这 是 一 个 必 填 的 属性 ， 该 属性 指定 用 于 解析 字符 串 的 分 隔 符 。 
val: 这 是 一 个 必 填 的 属性 ， 该 属性 指定 被 解析 的 字符 串 。 
converter: 这 是 一 个 可 选 的 属性 ， 该 属性 指定 一 个 转换 器 ， 该 转换 器 负责 将 集合 中 的 每 个 字 
符 串 转换 成 对 象 ， 通 过 该 转换 器 可 以 将 一 个 字符 串 解析 成 对 象 集合 。 该 属性 值 必 须 是 一 个 
org.apache.Struts 2.util.lteratorGenerator.Converter 对 象 。 
> ”var: 这 是 一 个 可 选 的 属性 ,如果 指 定 了 该 属性 ， 则 将 生成 的 lterator 对 象 放 入 Stack Context 
中 。 该 属性 也 可 替换 成 id， 但 推荐 使 用 var 属性 。 
下 面 的 代码 片段 生成 一 个 简单 集合 。 
程序 清单 : codes\03W3.11\controlTag\s-generator-simple.jsp 
<table border="1" width="240"> 
<!-- 使 用 generator 标签 将 指定 字符 申 解析 成 Tterator 集合 
在 generator 标签 内 ， 得 到 的 List 集合 位 于 ValueStack 顶端 --> 
<s:generator val="' 妆 狂 Java 讲义 
, 轻 量 级 Java EE 企业 应 用 实战 ， 
经 典 Java EE 企业 应 用 实战 '”separator=","> 
<!-- 没有 指定 迭代 哪个 集合 ， 直 接 选 代 ValueStack 顶端 的 集合 --> 
<s:iterator status="st"> 
<tr <s:if test="#st.odd"> 
style="background-color:#bbbbbb"</s:if>> 
<td><s:property/></td> 
</tr> 
</s:iterator> 
</s:generator> 
</table> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.40 所 示 的 页 面 。 
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图 3.40 ”使 用 generator 将 字符 串 解析 成 集合 


如 果 使 用 generator 标签 时 指定 了 count 和 var 属性 ， 则 count 设置 集合 中 最 多 只 能 包含 count 个 元 
素 〈 就 是 前 count 个 元 素 ); 如 果 指定 了 var 属性 ， 就 可 将 生成 的 集合 放 入 Struts 2 的 Stack Context 中 
(实际 上 还 会 设置 成 request 范围 的 属性 )。 代 码 如 下 。 

程序 清单 : codes\03\3.11\controlTag\s-generator-countjsp 


<!-- 使 用 generator 将 一 个 字符 中 解析 成 一 个 集合 
， 指 定 了 var 和 count 属性 --> 
<s:generator val="' 首 狂 Java 讲义 
, 轻 量 级 Java EE 企业 应 用 实战 ， 
经 典 Java EE 企业 应 用 实战 '"” separator="," 
var="books" count="2"/> 
<table border="1" width="300"> 
<!-- 选 代 输出 Stack Congtext 中 的 books 集合 --> 
<s:iterator value="#books"> 
<tr> 
<td><s:property/></td> 
</tr> 
</s:iterator> 
</table> 
${requestscope.books} 
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上 面 的 代码 在 使 用 generator 标签 将 字符 串 转换 成 集合 时 ， 指 定 了 count 属性 ， 这 将 意味 着 解析 出 
来 的 集合 最 多 只 包含 两 个 (前 面 两 个 ), 且 指定 了 var 属 性 ,该 var 属 性 将 导致 该 集合 被 放 入 Stack Context 
中 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.41 所 示 的 效果 。 


or pache. strutSI util. TeratorGenerator2982bf 


图 3.41 使 用 generator 标签 时 指定 count 和 id 属性 


人 
天 -注意 : 
Struts 2 的 很 多 标签 都 与 该 标签 类 似 ， 它 们 都 可 以 指定 var (以 前 是 id) » 
指定 了 var 属性 ， 则 会 将 新 生成 、 新 设置 的 值 放 入 Stack Context 中 ( 必须 通过 #name 形 
式 访问 )) 如果 不 指 定 var 属性 ， 则 新 生成 、 新 设置 的 值 不 会 放 入 Stack Context 中 ， 因 此 
只 能 在 该 标签 内 部 访问 新 生成 、 新 设置 的 值 一 一 此 时 新 生成 、 新 设置 的 值 位 于 ValueStack y 


中 ， 因 此 可 以 直接 


5，merge 标签 

merge 标签 的 用 法 看 起 来 非常 像 append 标签 ， 也 是 用 于 将 多 个 集合 拼接 成 一 个 集合 ， 但 它 采 用 的 
拼接 方式 与 append 的 拼接 方式 有 所 区 别 。 下 面 假设 有 三 个 集合 (每 个 集合 包含 三 个 集合 元 素 )， 分 别 . 
使 用 append 和 merge 方式 进行 拼接 ， 产 生 的 新 集合 将 有 所 区 别 。 

如 果 采 用 append 方式 拼接 ， 新 集合 的 元 素 顺序 为 : 

(1) 第 一 个 集合 中 的 第 一 个 元 素 

(2) 第 一 个 集合 中 的 第 二 个 元 素 

(3) 第 一 个 集合 中 的 第 三 个 元 素 

(4) 第 二 个 集合 中 的 第 一 个 元 素 

(5) 第 二 个 集合 中 的 第 二 个 元 素 

(6) 集合 中 的 第 三 个 元 素 

(7) 第 三 个 集合 中 的 第 一 个 元 素 

(8) 第 三 个 集合 中 的 第 二 个 元 素 

(9) 第 三 个 集合 中 的 第 三 个 元 素 

如 果 采 用 merge 方式 拼接 ， 新 集合 的 元 素 顺序 为 : 

(1) 第 一 个 集合 中 的 第 一 个 元 素 

(2) 第 二 个 集合 中 的 第 一 个 元 素 

(3) 第 三 个 集合 中 的 第 一 个 元 素 

(4) 第 一 个 集合 中 的 第 二 个 元 素 

(5) 第 二 个 集合 中 的 第 二 个 元 素 

(6) 第 三 个 集合 中 的 第 二 个 元 素 

(7) 第 一 个 集合 中 的 元 素 

(8) 第 二 个 集合 中 的 第 三 个 元 素 
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(9) 第 三 个 集合 中 的 第 三 个 元 素 
从 上 面 的 介绍 中 可 以 看 出 : 采用 append 和 merge 方式 合并 集合 时 ， 新 集合 中 集合 元 素 完全 相同 ， 
只 是 新 集合 中 集合 元 素 的 顺序 有 所 不 同 。 
merge 标签 的 使 用 示例 ， 与 使 用 append 标签 的 使 用 示例 大 致 相同 ， 此 处 不 再 著述 ， 读 者 可 参考 光 
盘 中 的 代码 。 
6，subset 标签 
subset 标签 用 于 取得 集合 的 子 集 , 该 标签 的 底层 通过 org.apache.struts2.util.Subset IteratorFilter 类 提 
使 用 subset 标签 时 可 指定 如 下 几 个 属性 。 
> ”count; 这 是 一 个 可 选 属性 ， 该 属性 指定 子 集中 元 素 的 个 数 。 如 果 不 指定 该 属性 ， 则 默认 取得 
源 集合 的 全 部 元 素 。 
> ”source: 这 是 一 个 可 选 属性 , 该 属性 指定 源 集合 。 如 果 不 指定 该 属性 , 则 默认 取得 ValueStack 
栈 项 的 集合 。 
> start， 这 是 一 个 可 选 属性 ， 该 属性 指定 子 集 从 源 集合 的 第 几 个 元 素 开 始 截取 。 默 认 从 第 一 个 
元 素 〈 即 start 的 默认 值 为 0) 开始 截取 。 
> ”decider: 这 是 一 个 可 选 属性 ， 该 属性 指定 由 开发 者 自己 决定 是 否 选中 该 元 素 。 该 属性 必须 指 
定 一 个 org.apache.struts2.util.SubsetlteratorFilter.Decider 对 象 。 
> var: 这 是 一 个 可 选 属性 ， 如 果 指 定 了 该 属性 ， 则 将 生成 的 lterator 对 象 设置 成 page 范围 的 
属性 。 该 属性 也 可 替换 成 id， 但 推荐 使 用 var 属性 。 
在 subset 标签 内 时 ，subset 标签 生成 的 子 集合 放 在 ValueStack 的 栈 项 ， 所 以 我 们 可 以 在 该 标签 内 
直接 迭代 该 标签 生成 的 子 集合 。 如 果 该 标签 结束 后 ， 该 标签 生成 的 子 集合 将 被 移出 ValueStack 栈 。 
下 面 的 代码 使 用 subset 标签 截取 了 源 集合 形成 子 集 ， 使 用 subset 元 素 时 ， 指 定 了 start 属性 为 1， 
即 标签 子 集 从 源 集合 的 第 二 个 元 素 开始 截取 ， 指定 count 属性 为 3， 表 明子 集 的 长 度 为 3。 
程序 清单 ，codes\03\3.11\controlTag\s-subsetjsp 


<table border="1" width="300"> 
i 使 用 subset 标签 截取 目标 集合 的 4 个 元 素 ， 从 第 2 个 元 素 开始 截取 一: 


<!-- 使 用 iterator 标签 来 选 代目 标 集合 ， 因 为 没有 指定 value 属性 值 ， 
故 迁 代 Valuestack 栈 项 的 集合 -> 
<s:iterator status="st"> 
<!--~ 根据 当前 迁 代 元 素 的 索引 是 否 为 奇数 决定 是 否 使 用 CSS 样式 -> 
<tr <s:if test="#st.odd"> 
style="background-color:#bbbbbb"</s:if>> 
<td><s:property/></td> 
</tr> 
</s:iterator> 
</s:subset> 
</table> 


上 面 代码 的 source 属性 指定 的 集合 包含 了 5 个 元 素 ， 通 过 subset 从 第 2 个 元 素 开始 截取 ， 只 取出 

其 中 4 个 元 素 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.42 所 示 的 页 面 。 
除 此 之 外 ，Struts 2 还 允许 开发 者 决定 截取 标准 ， 如 果 开发 者 需要 实现 自己 的 截取 标准 ， 则 需要 实 
现 一 个 Decider 类 ，Decider 类 需要 实现 SubsetlteratorFilter Decider 接口 ， 实 现 该 类 时 ， 需 要 实现 一 个 
boolean decide(Object element) 方 法 ， 如 果 该 方法 返回 真 ， 则 表明 该 元 素 将 被 选 入 子 集中 。 看 下 面 的 
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Decider 类 代码 。 


图 3.42 ”使 用 subset 标签 截取 集合 


程序 清单 : codes\03\3.11\controlTag\WEB-INF\src\org\crazyit\app\uti\MyDeciderjava 


// 用 户 自 定义 的 Decider 类 ， 实现 了 SubsetIteratorFilter.Decider 接口 
public class MyDecider 
implements SubsetIteratorFilter.Decider 
{ 
// 实 现 Decider 接口 必须 实现 的 decide 方法 ， 
// 该 方法 决定 集合 中 的 元 素 是 否 被 选 入 子 集 
public boolean decide (Object element) throws Exception 
{ 
String str = (String)element; 
// 如 果 集合 元 素 《字符 串 》 中 包含 Java EE 子 串 ， 即 可 被 先入 子 集 
return str.indexOf ("Java EE") > 0; 
这 


定义 了 Decider 类 后 ， 即 可 以 在 JSP 页 面 中 使 用 该 Decider 实例 来 过 滤 集 合 ， 从 目标 集合 中 选 出 子 
集 。 看 如 下 的 JSP 页 面 代码 。 
程序 清单 ，codes\03\3.11\controlTag\s-subset-deciderjsp 


<!-- 定义 一 个 Decider Bean --> 
<s:bean var="mydecider" name~"org.crazyit.app.util.MyDecider"/> 
<!-- 使 用 自 定义 的 Decider 实例 来 截取 目标 集合 ， 生 成 子 集 

指定 var 属性 ， 将 生成 的 Itertor 放 入 pageScope 中 --> 
<s:subset source="{' 首 狂 Java 讲义 ' 

，" 轻 量 级 Java EE 企业 应 用 实战 " 


var="newList"/> 
直接 输出 page 范围 的 newList 属性 : <br/> 
${pageScope.newList} 
<table border="1" width="240"> 、 
<!-- 和 迭代 page 范围 内 的 newList 属性 --> 
<a:iterator status="st" value="#attr.newList"> 
<tr <s:if test="#st.odd"> 
style="background-color:#bbbbbb"</s:if>> 
<td><s:property/></td> 
</tr> 
</s:iterator> 
</table> 


上 面 第 一 行 粗 体 字 代 码 创建 了 一 个 MyDecider 对 象 ， 该 对 象 可 以 决定 截取 子 集合 时 的 规则 。 上 面 
页 面 中 粗 体 字 代码 还 指定 了 var 属性 ， 程 序 斜 体 字 代码 选 代 输 出 pageContext 范围 的 newList 集合 。 
在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.43 所 示 的 页 面 。 
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细心 的 读者 可 能 已 经 发 现 : 为 什么 subset 标签 和 generator 标签 中 的 var 属性 的 作用 
并 不 相同 ，subset 的 var 属性 是 将 新 集合 放 入 pageScope 内 ， 并 不 放 入 Stack Context 中 ; 
而 generator 标签 的 var 属性 将 新 集合 放 入 Stack Context 以 及 requestScope 内 . 但 Struts 2 
官方 文档 中 对 subset 标签 和 generator 标签 这 两 个 标签 中 的 var 属性 的 解释 完全 相同 。 这 要 


点 笔者 估计 应 该 是 Struts 2 或 其 文档 的 小 bug。 


7. sort 标签 
sort 标签 用 于 对 指定 的 集合 元 素 进行 排序 ， 进 行 排序 时 ， 必 须 提供 自己 的 排序 规则 ， 即 实现 自己 
的 Comparator， 自 己 的 Comparator 需要 实现 java.util. Comparator 接口 。 
使 用 sort 标签 时 可 指定 如 下 几 个 属性 。 
> comparator: 这 是 一 个 必 填 的 属性 ， 该 属性 指定 进行 排序 的 Comparator 实例 。 
> source: 这 是 一 个 可 选 的 属性 ， 该 属性 指定 被 排序 的 集合 。 如 果 不 指定 该 属性 ， 则 对 
ValueStack 栈 项 的 集合 进行 排序 。 
> ”var: 这 是 一 个 可 选 的 属性 ， 如 果 指 定 了 该 属性 ， 则 将 生成 的 lterator 对 象 设 置 成 page 范围 
的 属性 ， 不 放 入 Stack Context 中 。 该 属性 也 可 替换 成 id， 但 推荐 使 用 var 属性 。 该 属性 的 
作用 与 subset 标签 中 var 属性 的 作用 相同 。 
在 sort 标签 内 时 ，sort 标签 生成 的 子 集合 放 在 ValueStack 的 栈 项 ， 所 以 我 们 可 以 在 该 标签 内 直接 
迭代 该 标签 生成 的 子 集合 。 如 果 该 标签 结束 后 ， 该 标签 生成 的 子 集合 将 被 移出 ValueStack 栈 。 
下 面 是 本 示例 应 用 中 的 Comparator 类 的 代码 。 
程序 清单 ，codes\03\3.11\eontrolTag\WEB-INF\srcvorgverazyituappvutil\MyComparatorjava 
public class MyComparator implements Comparator 


// 决 定 两 个 元 素 大 小 的 方法 2 
public int compare(Object element1，Object element2) 


{ 
// 根 据 元 素 字符 申 长 度 来 决定 大 小 
return element1-tostring () .length () 
~ element2.tostring() .length(); 


上 
3 


实现 自己 的 Comparator 时 ,需要 实现 一 个 compare(Object elementl, Object element2) 方 法 ， 如 果 该 
方法 返回 一 个 大 于 0 的 整数 ， 则 第 一 个 元 素 大 于 第 二 个 元 素 ; 如 果 该 方法 返回 0， 则 两 个 元 素 相等 
如 果 该 方法 返回 小 于 0 的 整数 ， 则 第 一 个 元 素 小 于 第 二 个 元 素 。 

上 面 的 代码 根据 目标 元 素 的 字符 串 长 度 来 决定 元 素 的 大 小 。 

下 面 是 对 集合 元 素 进行 排序 的 JSP 页 面 代码 。 

程序 清单 : codes\03\3.11\controlTag\s-sort.jsp 

<1-- 定义 一 个 Comparator 实例 --> 
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<s:bean var="mycomparator" name="org.crazyit,app.util.MyComparator"/> 
<!-- 使 用 自 定义 的 排序 规则 对 目标 集合 进行 排序 -> 
<s:sort source="{ ' 攻 狂 Java 讲义 ' 


输出 page 范围 的 sortedList 属性 : <br/> 
${pageScope. sortedbist} 
<table border="1" width="300"> 
<!-- 迭代 page 范围 内 的 sortedList 属性 一 > 
<s:iterator status="st" value="#attr.sortedList"> 
<tr <s:if test="#st.odd"> 
style="background-color:#bbbbbb"</s:if>> 
<td><s:property/></td> 
</tr> 
</s:iterator> 
</table> 


上 面 的 粗 体 字 代 码 使 用 sort 标签 对 指定 集合 进行 排序 ， 排 序 结束 后 程序 使 用 JSP 2 表达 式 语言 直 
接 输 出 page 范围 的 sortedList 属性 。 程 序 斜体 字 代码 还 使 用 iterator 标签 来 迭代 输出 page 范围 的 
sortedList 集合 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.44 所 示 的 页 面 。 


SND_ WMD WE Fe EO IAD Pos 


园 人 用 nero 条 合 元 二 进行 排 库 
输出 page 共 图 的 sortedList 属 性 ， 
rg. apache. struts?. util, SortJYeratorgi lterglfal0da 


图 3.44 ”使 用 sort 标签 对 集合 元 素 进行 排序 
在 图 ” 44 中 可 以 看 到 ， 因 为 “疯狂 XML 讲义 ”的 字符 串 长 度 最 短 ， 故 该 集合 元 素 被 放 在 最 前 面 。 


四 订 


sort 标签 的 var 属性 也 只 是 将 排序 后 的 新 集合 放 入 pageScope 中 ， 并 未 放 入 OGNL 
的 Stack Context 中 。 其 实 笔者 对 Struts 2 标签 的 var 属性 最 恼火 ， 有 的 标签 的 Var 属性 会 | 
将 新 创建 、 新 生成 值 放 入 Stack Context 中 ; 有 的 又 不 放 入 Stack Context 中 . 这 一 点 让 人 
感觉 很 难 记 住 ， 只 能 在 用 的 时 候 试 一 下 by 


》>>3.11.8 数据 标签 


数据 标签 主要 用 于 提供 各 种 数据 访问 相关 的 功能 ， 包 含 显示 一 个 Action 里 的 属性 ， 以 及 生成 国际 
化 输出 等 功能 。 数 据 标签 主要 包含 如 下 几 个 。 
> ”action: 该 标签 用 于 在 JSP 页 面 直接 调用 一 个 Action， 通 过 指定 executeResult 参数 ， 还 可 
将 该 Action 的 处 理 结果 包含 到 本 页 面 中 来 。 
> ”bean: 该 标签 用 于 创建 一 个 JavaBean 实例 .如 果 指定 了 var 属性 , 则 可 以 将 创建 的 JavaBean 
实例 放 入 Stack Context 中 。 
> ”date: 用 于 格式 化 输出 一 个 日 期 。 
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> debug: 用 于 在 页 面 上 生成 一 个 调试 链接 ， 当 单 击 该 链接 时 ， 可 以 看 到 当前 ValueStack 和 
Stack Context 中 的 内 容 。 
i18n: 用 于 指定 国际 化 资源 文件 的 baseName。 
include: 用 于 在 JSP 页 面 中 包含 其 他 的 JSP 或 Servlet 资源 。 
param: 用 于 设置 一 个 参数 ， 通 常 是 用 做 bean 标签 、url 标签 的 子 标签 。 
push: 用 于 将 某 个 值 放 入 ValueStack 的 栈 顶 。 
set: 用 于 设置 一 个 新 变量 ， 并 可 以 将 新 变量 放 入 指定 的 
text: 用 于 输出 国际 化 消息 。 
url， 用 于 生成 一 个 URL 地 址 。 
property: 用 于 输出 某 个 值 , 包括 输出 ValueStack、Stack Context 和 Action Context 中 的 值 。 
1.，action 标签 
使 用 action 标签 可 以 允许 在 JSP 页 面 中 直接 调用 Action， 因 为 需要 调用 Action， 所 以 可 以 指定 需 
要 被 调用 Action 的 name 及 namespace。 如 果 指 定 了 executeResult 参数 的 属性 值 为 tue， 该 标签 还 会 
把 Action 的 处 理 结果 〔 视 图 资源 ) 包含 到 本 页 面 中 来 。 
使 用 action 标签 有 如 下 几 个 属性 。 
> var: 这 是 一 个 可 选 属 性 ， 一 旦 定义 了 该 属性 ， 该 Action 将 被 放 入 ValueStack 中 ， 该 属性 可 
用 id 代替 ， 但 推荐 使 用 var。 
> name: 这 是 一 个 必 填 属性 ， 通 过 该 属性 指定 该 标签 调用 哪个 Action 。 
> namespace: 这 是 一 个 可 选 属性 ， 该 属性 指定 该 标签 调用 的 Action 所 在 的 namespace。 
> ”executeResult:， 这 是 一 个 可 选 属性 ， 该 属性 指定 是 否 要 将 Action 的 处 理 结果 页 面包 含 到 本 
页 面 。 该 属性 值 默认 值 是 false， 即 不 包含 。 
> jignoreContextParams: 这 是 一 个 可 选 参数 ， 它 指定 该 页 面 中 的 请 求 参数 是 否 需 要 传 入 调用 
的 Action。 该 参数 的 默认 值 是 false， 即 将 本 页 面 的 请 求 参数 传 入 被 调用 的 Action 。 
下 面 是 本 示例 应 用 中 的 Action 类 ， 这 个 Action 类 里 包含 了 两 个 处 理 逻 辑 。 看 下 面 的 Action 类 
代码 。 
程序 清单 ，codes\03W3.11\dataTag\WEB-INF\src\org\crazyitapp\action\TagAction.java 
public class TagAction extends ActionSupport 
k // 封 装 用 户 请 求 参数 的 author 属性 
private String author; 
// 省 略 author 属性 的 setter 和 getter 方法 
/7 定义 第 一 个 处 理 远 辑 
当 避 起 String execute() throws Exception 


bi 


Vv 


return "done"; 


} 
// 定 义 第 二 个 处 理 逻 辑 
public string login() throws Exception 
{ 
ActionContext.getContext () . 
Put ("author", getAuthor()); 
return "done"™; 
) 
} 


上 面 的 Action 类 包含 了 两 个 处 理 逻 辑 , 可 以 在 struts.xml 文 件 中 通过 指定 method 属性 来 将 该 Action 
类 映射 成 两 个 逻辑 Action。 下 面 是 在 struts.xml 文件 中 配置 该 Action 的 配置 代码 片段 。 
程序 清单 : codes\03\3.11\dataTag\WEB-INF\src\struts.xml 
<!-- 定义 第 一 个 Action， 使 用 Tagaction 的 
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execute 方法 作为 控制 处 理 逻辑 --> 
<action name="tagl" class="org.crazyit.app.action.TagAction"> 
<result name="done">succ.jsp</result> 
</action> 
<!-- 定义 第 二 个 Action， 使 用 Tagaction 的 
login 方法 作为 控制 处 理 逻 辑 --> 
<action name="tag2" class="org.crazyit.app.action.TagAction" 
method="login"> 
<result name="done">loginsucc.jsp</result> 
</action> 
上 面 的 配置 文件 将 一 个 Action 类 定义 成 两 个 逻辑 Action， 可 以 在 JSP 页 面 中 通过 <s:action .…/> 标 
等 来 调用 这 两 个 逻辑 Action 。 
下 面 是 JSP 页 面 中 使 用 <s:action 标签 来 调用 这 两 个 逻辑 Action 的 代码 片段 。 
程序 清单 :codes\03\3.11\dataTag\s-action.jsp 
下 面 调用 第 一 个 Rction， 并 将 结果 包含 到 本 页 面 中 。<bz/> 
<s :action name="tagl" executeResult="true"/> 
<hr/> 
下 面 调用 第 二 个 Action， 并 将 结果 包含 到 本 页 面 中 。<br/> 
但 阻止 本 页 面 请 求 参数 传 Action。<br/> 
<s:action name="tag2" executeResult="true" 
ignoreContextParams="true"/> 
<hr/> 
下 面 调用 第 三 个 Action， 且 并 不 将 结果 包含 到 本 页 面 中 。<br/> 
<s:action name="tag2" executeResult="false"/> 
本 页 面 是 否 可 访问 ? <s:property value="author"/> 
上 面 的 页 面 中 粗 体 字 代码 三 次 调用 了 目标 Action, 通过 指定 executeResult 属性 来 控制 是 否 将 处 理 结果 
包含 到 本 页 面 中 ， 还 通过 指定 ignoreContextParams 属性 来 决定 是 否 将 本 页 面 的 请 求 参数 传 入 Action。 
除 此 之 外 ， 上 面 的 页 面 中 代码 试图 在 本 页 面 访问 所 调用 Action 对 应 Context 里 的 author 属性 。 在 
浏览 器 中 浏览 该 页 面 ， 并 且 传 入 一 个 名 字 为 author 的 请 求 参数 ， 将 看 到 如 图 3.45 所 示 的 页 面 。 


下 面 调用 第 二 个 ction， 并 将 结果 名 坊 对 在 页面 


面 调 
但 月 目 本 页 面 请 求 参 数 竺 入 hction。 


,本 时 记功 | | 


下 而 调用 苇 三 个 hction。 且 并 不 将 结果 乌 信 到 本 页 而 中 
本 页 面 是 否 可 访问 ? 


图 3.45 在 JSP 页 面 中 使 用 action 标签 调用 Action 


从 图 3.45 中 可 以 看 出 ， 本 次 请 求 包含 了 一 个 名 为 author 的 请 求 参数 ， 该 请 求 参数 的 值 为 yeeku， 
但 在 第 二 次 调用 时 该 参数 并 未 传 给 Action， 因 此 使 用 action 标签 时 阻止 了 参数 的 传 入 。 

2. bean 标签 

正如 前 面 见 过 的 ，bean 标签 用 于 创建 一 个 JavaBean 实例 。 创 建 JavaBean 实例 时 ， 可 以 在 该 标签 
体内 使 用 <param … 人 标签 为 该 JavaBean 实例 传 入 属性 ， 如 果 我 们 需要 使 用 <param .… 记 标签 为 该 
JavaBean 实例 传 入 属性 值 ， 则 应 该 为 该 JavaBean 类 提供 对 应 的 setter 方法 ;如果 我 们 还 希望 访问 该 
JavaBean 的 某 个 属性 ， 则 应 该 为 该 属性 提供 对 应 的 getter 方法 。 

使 用 bean 标签 时 可 以 指定 如 下 两 个 属性 。 

> name: 该 属性 是 一 个 必 填 属性 ， 该 属性 指定 要 实例 化 的 JavaBean 的 实现 类 。 
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> ”var: 该 属性 是 一 个 可 选 属性 .如 果 指 定 了 该 属性 , 则 该 JavaBean 实例 会 被 放 入 Stack Context 
中 ， 并 放 入 requestScope 中 。 该 var 属性 可 用 id 属性 来 代替 ， 但 推荐 使 用 var 属性 。 

在 bean 标签 的 标签 体内 时 , bean 标签 创建 的 JavaBean 实例 位 于 ValueStack 的 顶端 ;但 一 旦 该 bean 
标签 结束 了 ， 则 bean 标签 创建 的 JavaBean 实例 被 移出 ValueStack， 将 无 法 再 次 访问 该 JavaBean 实例 。 
除非 指定 了 var 属性 ， 则 还 可 通过 Stack Context 来 访问 该 实例 。 

下 面 是 一 个 简单 的 JavaBean, 该 JavaBean 包含 了 两 个 属性 , 并 且 为 这 两 个 属性 提供 了 setter 和 getter 
方法 。 该 JavaBean 的 类 代码 片段 如 下 。 

程序 清单 : codes\033.11\dataTag\WEB-INF\src\org\crazyit\app\dto\Person.java 

public class Person 
: private String name; 
private int ager 
// 省 略 name 属性 的 setter 和 getter 方法 
7 /省略 age 属性 的 setter 和 getter 方法 
} 


提供 了 上 面 的 Person 类 后 ， 就 可 以 在 JSP 页 面 中 通过 <s:bean .… 人 > 标签 来 创建 该 JavaBean 的 实例 
了 。 下 面 的 代码 在 使 用 <s:bean … 亿 标签 创建 JavaBean 实例 时 ， 并 未 指定 var 属性 ， 则 只 能 在 该 标签 内 
访问 该 JavaBean 实例 。 
程序 清单 : codes\03W3.11\dataTag\s-bean.jsp 
使 用 bean 标签 创建 一 个 Person 类 的 实例 --> 
<s:bean name="org.crazyit.app.dto.Person"> 
<!-- 使 用 param 标签 为 Person 类 的 实例 传 入 参数 --> 
<s:param name="name" value="'yeeku'"/> 
<s:param name="age" value="29"/> 
<!-- 因为 在 bean 标签 内 ，Person 实例 位 于 ValueStack 的 栈 项 , 
故 可 以 直接 访问 lee ,Person 实例 --> 
Person 实例 的 name 为 : roperty value="name"/><br/> 


Person 实例 的 age 为 : <s:property value="age"/> 
</s:bean> 


上 面 的 粗 体 字 代码 创建 了 一 个 lee.Person 的 实例 ， 并 在 <s:bean... 人 > 标签 内 中 使 用 <s:property …/> 标 
签 直接 访问 该 标签 生成 的 JavaBean 实例 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.46 所 示 的 页 面 。 


Peraon 实 全 的 age 为 ，29 


3 
图 3.46 使 用 bean 标签 创建 JavaBean 实例 


除 此 之 外 ， 我 们 还 可 以 在 使 用 <s:bean/> 标 签 时 指定 var 属性 ， 如 果 指定 了 var 属性 后 ， 就 可 以 将 
该 JavaBean 实例 放 在 Stack Context 中 (并 放 入 requestScope 中 ) 了 ; 这 样 即使 不 在 <s:bean .… 人 > 标签 内 ， 
也 可 通过 该 var 属性 来 访问 该 JavaBean 实例 。 
看 下 面 的 页 面 代码 。 
程序 清单 : codes\03\3.11\dataTag\s-bean-varjsp 
<!-- 使 用 bean 标签 创建 一 个 Person 类 的 实例 ， 为 其 指定 了 var 属性 --> 
<s:bean name="org.crazyit.app.dto.Person" var="p"> 
<!-- 使 用 param 标签 为 Person 类 的 实例 传 入 参数 --> 
<s:param name="name" value="'yeeku'"/> 


<s:param name="age" value="29"/> 
</s:bean> 
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<!-- 根据 JavaBean 实例 指定 的 var 属性 来 访问 JavaBean 实例 --> 
Person 实例 的 name 为 : <s:property value="#p.name"/><br/> 
Person 实例 的 age 为 ， <s:Property value="#p.age"/><br/> 
${requestScope.p} 


在 上 面 的 代码 中 ， 由 于 使 用 <s:bean .… 户 标签 时 指定 了 var 属性 ， 该 属性 意味 着 将 该 JavaBean 放置 
到 Stack Context 中 ， 因 此 即使 不 在 <s:bean .… 人 > 标签 内 ， 也 可 以 通过 该 var 属性 来 访问 该 JavaBean。 在 
浏览 器 中 浏览 该 页 面 ， 将 看 到 与 图 3.46 大 致 相同 的 页 面 。 
3. date 标签 
date 标签 用 于 格式 化 输出 一 个 日 期 。 除 了 可 以 直接 格式 化 输出 一 个 日 期 外 ，date 标签 还 可 以 计算 
指定 日 期 和 当前 时 刻 之 间 的 时 差 。 
使 用 date 标签 时 可 以 指定 如 下 几 个 属性 。 
> ”format: 这 是 一 个 可 选 属性 ， 如 果 指 定 了 该 属性 ， 将 根据 该 属性 指定 的 格式 来 格式 化 日 期 。 
> _nice: 这 是 一 个 可 选 属性 , 该 属性 只 能 为 true 或 者 false， 它 用 于 指定 是 否 输出 指定 日 期 和 当 
前 时 刻 之 间 的 时 差 。 该 属性 默认 是 false， 即 表示 不 输出 时 差 。 
> name: 这 是 一 个 必 填 属性 ， 该 属性 指定 要 格式 化 的 日 期 值 。 
> var: 这 是 一 个 可 选 属性 ,如果 指定 了 该 属性 , 格式 化 后 的 字符 串 将 被 放 入 Stack Context 中 ， 
并 放 入 requestScope 中 ， 但 不 会 在 页 面 上 输出 。 该 属性 也 可 用 id 来 代替 ， 但 推荐 使 用 var。 
通常 , nice 属性 和 format 属性 不 同时 指定 (不 指定 nice 属性 时 ， 该 属性 值 默 认为 false)， 指 定 nice 
属性 为 tue 时 表明 输出 指定 日 期 和 当前 时 刻 的 时 差 ， 但 指定 format 属性 则 用 于 将 指定 日 期 按 format 
指定 的 格式 来 格式 化 输出 。 


喇 
关注 意 : 
如 果 既 指定 了 nice="true"， 也 指定 了 format 属性 ， 则 会 输出 指定 日 期 和 当前 时 刻 之 

的 时 差 ， 即 format 属性 失效 。 


如 果 既 没有 指定 format 属性 ， 也 没有 指定 nice="true"， 则 系统 会 到 国际 化 资源 文件 中 寻找 key 为 
struts.date.format 的 消息 ,将 该 消息 当成 格式 化 文本 来 格式 化 日 期 .如 果 无 法 找到 key 为 struts.date.format 
的 消息 ， 则 默认 采用 DateFormat.MEDIUM 格式 输出 。 

看 如 下 页 面 代码 。 

程序 清单 : codes\03\3.11\dataTag\s-datejjsp 

<s:bean var="now" name="java.util.Date"/> 

nice="false"， 且 指定 format="dd/MM/yyyy"<br/> 

<s:date name="#now" format="dd/MM/yyyy" nice="false"/><hr/> 
nice="true"， 且 指定 format="dd/MM/yyyy"<br/> 

<s:date name="#now" format="dd/MM/yyyy" nice="true"/><hr/> 
指定 nice="true"<br/> 

<s:date name="#now" nice="true" /><hr/> 

nice="false"， 且 没有 指定 format 属性 <br/> 

<s:date name="#now" nice="false"/><hr/> 

nice="false"， 没 有 指定 format 属性 ， 指 定 了 var<br/> 

<s:date name="#now" nice="false" var="abc"/><ht/> 
S${requestScope.abc} <s:property value="#abc"/> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.47 所 示 的 页 面 。 
从 图 3.47 中 可 以 看 到 ， 当 没有 指定 nice="true" 属 性 ， 且 不 提供 format 属性 时 ， 系 统 将 日 期 格式 化 
成 “2010 年 11 月 17 日 ”， 这 是 因为 在 国际 化 资源 文件 中 有 如 下 配置 


# 指定 Struts 2 默认 的 的 时 间 格 式 
struts.date.format=yyyy 年 MM 月 dd 日 
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叶 ce="false"， 且 指定 forzat="dd/ /yyyy” 
17/1/2010 


叶 ce="false”， 且 没有 指定 forsat 属 性 
2010 年 11 月 1 日 


mice=false"， 投 有 措 定 forzat 属 性 ， 指 定 了 var 
2010 年 11 月 17 日 2010 年 11 月 17 日 


台 
图 3.47 使 用 date 标签 格式 化 输出 日 期 
4. debug 标签 
debug 标签 主要 用 于 辅助 调试 , 它 在 页 面 上 生成 一 个 超级 链接 , 通过 该 链接 可 以 查看 到 ValueStack 
和 Stack Context 中 所 有 的 值 信息 。 


使 用 debug 标签 只 有 一 个 id 属性 ， 这 个 属性 并 没有 太 大 的 意义 ， 仅 仅 是 该 元 素 的 一 个 引用 id。 

在 前 面 3.11.3 节 已 经 见 过 使 用 debug 标签 来 辅助 调试 ValueStack 和 Stack Context 中 的 内 容 ， 故 此 
处 不 再 著述 。 

5. include 标签 

include 标签 用 于 将 一 个 JSP 页 面 ， 或 者 一 个 Servlet 包含 到 本 页 面 中 。 使 用 该 标签 有 如 下 属性 。 

> ”value: 这 是 一 个 必 填 属性 ， 该 属性 指定 需要 被 包含 的 JSP 页 面 ， 或 者 Servlet。 

除 此 之 外 ， 还 可 以 为 <s:include .… 人 标签 指定 多 个 <param .…/> 子 标签 ， 用 于 将 多 个 参数 值 传 入 被 包 
含 的 JSP 页 面 或 者 Servlet。 

看 如 下 页 面 代码 。 

程序 清单 ， codes\03\3.11vdataTag\s-includejsp 


<h2> 使 用 s: include 标签 来 包含 目标 页 面 </h2> 
<1-- 使 用 include 标签 来 包含 其 他 页 面 --> 
<s:include value="included-file.jsp"/> 
<!-- 使 用 include 标签 来 包含 其 他 页 面 ， 并 且 传 入 参数 一 > 
<s:include value="included-file.jsp"> 

<s:param name="author" value="!yeeku'"/> 
</s:include> 


被 包含 的 页 面 仅 使 用 表达 式 语言 输出 author 参数 ， 被 包含 页 面 的 代码 如 下 。 
程序 清单 : codes\033.11\dataTag\included-filejsp 


<h3> 被 包含 的 页 面 </h3> 
author 参数 值 为 :$ {param.author} 


在 浏览 器 中 浏览 s-includejsp 页 面 ,将 看 到 如 图 3.48 


使 用 s: include 标 签 来 包含 目标 页 面 


所 示 的 页 面 。 
6. param 标签 被 包含 的 页 面 
param 标签 主要 用 于 为 其 他 标签 提供 参数 ， 例 如 ，。 | 22 
为 include 标签 和 bean 标签 提供 参数 。 福生 全 区 页 本 [CE 
param 标签 可 以 接受 如 下 参数 。 epost 
> name: 这 是 一 个 可 选 属性 ， 指 定 需 要 设置 参 攻 
数 的 参数 名 。 图 3.48 ”使 用 include 标签 包含 其 他 页 面 
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> ”value: 这 是 一 个 可 选 属性 ， 指 定 需要 设置 参数 的 参数 值 。 


name 属性 是 可 选 的 - 如 果 提 供 了 name 属性 , 则 要 求 Component 提供 该 属性 的 setter 
方法 ， 系 统 正 是 根据 setter 方法 来 传 入 参数 的 ; 如 果 不 提供 ， 则 外 层 标 答 必 须 实现 本 


UnnamedParametric 接口 (如 TextTag ). 


value 属性 是 可 选 的 ， 因为 <s:param .…/> 标 签 有 两 种 用 法 。 

第 一 种 用 法 : 

<param name="color">blue</param> 

在 上 面 的 用 法 中 ， 指 定 一 个 名 为 color 的 参数 ， 该 参数 的 值 为 blue。 
第 二 种 方法 : 

<param name="color" value="bluen/> 


在 上 面 的 用 法 中 ， 指 定 一 个 名 为 color 的 参数 ， 该 参数 的 值 为 blue 对 象 的 值 一 一 如 果 blue 对 象 不 


存在 ， 则 color 参数 的 值 为 null。 如 果 想 指定 color 参数 的 值 为 blue 字符 串 ， 则 应 该 这 样 写 : 
<param name="color" value="'blue'"/> 


和 
得- 注意 :w 
如 果 采用 第 一 种 写 


， 又 希望 直接 传 入 字符 囊 值 , 则 应 该 将 字符 囊 常 量 放 入 引号 中 ， 


学 


关于 param 标签 的 示例 ， 前 面 已 经 有 了 很 多 ， 故 此 处 不 再 提供 。 

7. push 标签 

push 标签 用 于 将 某 个 值 放 到 ValueStack 的 栈 项 ， 从 而 可 以 更 简单 地 访问 该 值 。 使 用 该 标签 时 可 以 
提供 如 下 属性 。 


> value: 这 是 一 个 必 填 属性 ， 该 属性 指定 需要 放 到 ValueStack 栈 顶 的 值 。 
直 

三 -注意 :二 … 
只 有 在 push 标 答 内 时 ， 被 push 标签 放 入 ValueStack 中 的 对 象 才 存 在 

push 标签 ， 则 刚刚 放 入 的 对 象 将 立即 被 移出 ValueStack. 


下 面 的 代码 将 一 个 值 放 到 ValueStack 的 栈 顶 ， 从 而 可 以 通过 <s:property .…/> 标 签 
程序 清单 : codes\03\3.11\dataTag\s-push.jsp 


<h2> 使 用 s: push 来 将 某 个 值 放 入 Valuestack 的 栈 顶 </h2> 
<!-- 使 用 bean 标签 创建 一 个 JavaBean 实例 ， 
指定 var 属性 ， 并 将 其 放 入 Stack Context 中 --> 
<s:bean name="org.crazyit.app. dto.Person" var="p"> 
<s:param name="name" value="'yeeku'"/> 
<s:param name="age" value="29"/> 
</s:bean> 
<!-- 将 Stack Context 中 的 P 对 象 放 入 ValueStack 栈 项 --> 
<a :Push value="#p"> 
<!-- 输出 Valuestack 栈 顶 对 象 的 name 和 age 属性 --> 
ValueStack 栈 顶 对 象 的 name 属性 : <s:property value="name"/><br/> 
> ValueStack 栈 顶 对 象 的 age 属性 : <s:property value="age"/><br/> 
</a:push> 


上 面 的 程序 中 粗 体 字 代码 实现 了 将 Stack Context 中 p 对 象 放 入 ValueStack 栈 顶 的 功能 ,程序 在 push 
标签 内 将 可 直接 访问 被 放 入 ValueStack 栈 顶 的 对 象 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.44 所 示 的 
页 面 。 


间 。 
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二 3 


使 用 s:push 来 将 某 个 值 放 入 ValueStack 的 
栈 顶 


YoloeStack 术 项 对 入 的 mamc 民 性 ，yeeinu 
ValveSrack 居 项 对 象 的 age 时 性 ，29 


图 3.49 ”使 用 push 标签 将 某 个 值 放 入 ValueStack 的 栈 项 


8，set 标签 
set 标签 用 于 将 某 个 值 放 入 指定 范围 内 ， 例 如 application 范围 、session 范围 等 。 
当 某 个 值 所 在 对 象 图 深度 非常 深 时 ， 例 如 有 如 下 的 值 : person.worker.wife.parentage， 每 次 访问 该 
值 不 仅 性 能 低下 ， 而 且 代码 可 读 性 也 差 。 为 了 避免 这 个 问题 ， 可 以 将 该 值 设置 成 一 个 新 值 ， 并 放 入 特 
定 的 范围 内 。 
使 用 set 标签 可 以 理解 为 定义 一 个 新 变量 ， 且 将 一 个 已 有 的 值 复制 给 新 变量 ， 并 且 可 以 将 新 变量 
放 到 指定 的 范围 内 。 
使 用 set 标签 有 如 下 属性 。 
> scope: 这 是 一 个 可 选 属性 , 指定 新 变量 被 放置 的 范围 , 该 属性 可 以 接受 application、 session、 
request、page 或 action 5 个 值 。 该 属性 默认 值 是 action 。 
> value: 这 是 一 个 可 选 属性 ， 指 定 将 赋 给 变量 的 值 。 如 果 没有 指定 该 属性 ， 则 将 ValueStack 
栈 项 的 值 赋 给 新 变量 。 
> var: 这 是 一 个 可 选 属性 ， 如 果 指 定 了 该 属性 ， 则 会 将 该 值 放 入 ValueStack 中 。 
当 把 指定 值 放 入 特定 范围 时 ， 范 围 可 以 是 application、session、request、page 和 action 5 个 值 ， 前 
面 4 个 范围 很 容易 理解 ; 如果 指定 action 范围 ， 则 该 值 将 被 放 入 request 范围 中 ， 并 被 放 入 OGNL 的 
Stack Context 中 。 
下 面 的 代码 先 定义 了 一 个 JavaBean 实例 ， 然 后 通过 set 标签 将 该 JavaBean 实例 放 入 指定 范围 ， 分 
别 放 入 默认 范围 (Stack Context)、application 和 session 范围 中 。 
程序 清单 :codes\03\3.11\dataTag\s-setjsp 
<h2> 使 用 s: set 设置 一 个 新 变量 </h2> 
!-- 使 用 bean 标签 定义 一 个 JavaBean 实例 一 > 
<s:bean name="org.crazyit.app.dto.Person" id="p"> 
<s:param name="name" value="'yeeku'"/> 
<s:param name="age" value="29"/> 
</s:bean> 
将 Stack Context 中 的 p 值 放 入 默认 范围 (action) 内 。<br/> 
<a: set value="#p" name="xxx"/> 
Stack Context 内 xxx 对 象 的 name 属性 ,<s:property value="#xxx.name"/><br/> 
Stack Context 内 xxx 对 象 的 age 属性 : <s:property value="#xxx.age"/><br/> 
request 范围 的 xxx 对 象 的 name 属性 : ${requestScope.xxx.name}<br/> 
request 范围 的 xxx 对 象 的 age 属性 : ${requestScope.xxx.age}<hr/> 
将 Stack Context 中 的 p 值 放 入 application 范围 内 。<br/> 
<a: aet value="#p" name="yyy" scope="application"/> 
application 范围 的 yyy 对 象 的 name 属性 : S{applicationScope.yyY-namej<br/> 
application 范围 的 yyy 对 象 的 age 属性 : ${applicationScope.yyy.age}<hr/> 
将 Stack Context 中 的 p 值 放 入 session 范围 内 。<br/> 
<s:set value="#p" name="zzz" scope="session"/> 
session 范围 的 zzz 对 象 的 name 属性 : ${sessionscope.zzz.name}<br/> 
session 范围 的 zzz 对 象 的 age 属性 : ${sessionscope.zzz.age} 


上 面 的 粗 体 字 代码 分 别 将 位 于 Stack Context 中 的 p 对 象 放 入 action 范围 .application 范围 和 session 


251 


http://52pdf.taobao.com 


粒 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


范围 ， 页 面 代码 还 使 用 JSP 2 表达 式 语言 来 访问 不 同 范围 内 的 xxx 属性 。 在 浏览 器 中 浏览 该 页 面 ， 将 
看 到 如 图 3.50 所 示 的 页 面 。 


使 用 s: set 设 置 一 个 新 变量 
将 Stack oe ee 4 on) 内 


roger 和 因 的 zrn 对 和 nan， ,yey 
request 范 围 的 zrz 对 象 的 see 属性 ，29 


ROOT 
的 yy 对象 的 nme 民 性 ，yeciw 
的 yyy 对 录 的 age 属性 ，29 
Ee Te 
session 区 图 的 zz 对 象 的 nc 属性 ， 
区区 和 的 


图 3.50 使 用 set 标签 设置 新 变量 


从 图 3.50 中 可 以 看 出 ，set 标签 用 于 生成 一 个 新 变量 ， 并 且 把 该 变量 放置 到 指定 范围 内 ， 这 样 就 
允许 直接 使 用 JSP 2 表达 式 语言 来 访问 这 些 变量 了 ， 当 然 也 可 通过 Struts 2 标签 来 访问 它们 。 

9. url 标 签 

url 标签 用 于 生成 一 个 URL 地 址 ， 可 以 通过 为 url 标签 指定 param 子 元 素 ， 从 而 向 指定 URL 发 送 
请 求 参数 。 使 用 该 标签 时 可 以 指定 如 下 几 个 属性 。 
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action: 这 是 一 个 可 选 属性 ， 指 定 生 成 URL 的 地 址 为 哪个 Action， 如 果 Action 不 提供 ， 就 使 
用 value 作为 URL 的 地 址 值 。 

anchor: 这 是 一 个 可 选 属性 ， 指 定 URL 的 锚 点 。 

encode: 这 是 一 个 可 选 属性 ， 指 定 是 否 需 要 对 参数 进行 编码 ， 默 认 是 true。 

escapeAmp: 这 是 一 个 可 选 参数 ， 指 定 是 否 需要 对 & 符 号 进行 编码 ， 默 认 是 true。 
forceAddSchemeHostAndPort， 这 是 一 个 可 选 参数 ， 指 定 是 否 需 要 在 URL 对 应 的 地 址 里 强 
制 添加 scheme、 主 机 和 端口 。 

includeContext:， 这 是 一 个 可 选 属性 ， 指 定 是 否 需 要 将 当前 上 下 文 包含 在 URL 地 址 中 。 
includeParams: 这 是 一 个 可 选 属性 ， 该 属性 指定 是 否 包含 请 求 参 数 ， 该 属性 的 属性 值 只 能 
为 none、get 或 者 all。 该 属性 值 默 认 是 get。 

method: 这 是 一 个 可 选 属性 ， 该 属性 指定 Action 的 方法 。 当 我 们 用 Action 来 生成 URL 时 ， 
如 果 指 定 了 该 属性 ， 则 URL 将 链接 到 指定 Action 的 特定 方法 。 

namespace: 这 是 一 个 可 选 属性 ， 该 属性 指定 命名 空间 。 当 我 们 用 Action 来 生成 URL 时 ， 
如 果 指定 了 该 属性 ， 则 URL 将 链接 到 此 namespace 的 指定 Action 处 。 

portletMode: 这 是 一 个 可 选 属性 ， 指 定 结果 页 面 的 portlet 模式 。 

scheme: 这 是 一 个 可 选 属性 ， 用 于 设置 scheme 属性 。 

value: 这 是 一 个 可 选 属性 ， 指 定 生成 URL 的 地 址 值 ， 如 果 value 不 提供 就 用 action 属性 指 
定 的 Action 作为 URL 地 址 。 

var: 这 是 一 个 可 选 属性 ， 如 果 指 定 了 该 属性 ， 将 会 把 该 链接 值 放 入 Struts 2 的 ValueStack 
中 。 该 属性 可 用 id 代替 ， 但 推荐 使 用 var。 

windowState: 这 是 一 个 可 选 属性 ， 指 定 结果 页 面 的 portlet 的 窗口 状态 。 
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六 . 
- 右 - 注意 : 

上 面 的 action 属性 和 value 属性 的 作用 大 致 相同 ， 只 是 action 指定 的 是 一 个 Action， 
因此 系统 会 自动 在 action 指定 的 属性 后 添加 .action 后 缓 .只 要 指定 action 和 value 两 个 属 村 


性 之 一 即 可 ， 如 果 两 个 属性 都 没有 指定 ， 就 页 面 作为 URL 的 地 址 值 


Fes portletMode 和 windowState 都 需要 结合 Struts 2 的 Portlet 功能 才 有 用 。 | 


看 如 下 使 用 url 标签 的 代码 片段 。 
程序 清单 : codes\03\3.11\dataTag\s-urljsp 


<h2>s:url 来 生成 一 个 URL 她 址 </h2> 
只 指定 value 属性 的 形式 。<br/> 
<s:url value="editGadget .action"/> 
<hr/> 
指定 action 属性 , 且 使 用 param 传 入 参数 的 形式 。<br/> 
<s:url action="showBook"> 
<s:param name="author"” value="'yeeku’" /> 
</s:url> 
<hr/> 
既 不 指定 action 属性 , 也 不 指定 value 属性 , 且 使 用 Param 传 入 参数 的 形式 。<br/> 
<s:url includeParams="get" > 
<s:param name="id"” value="${"22}"/> 
</s:url> 
<hr/> 
同时 指定 action 属性 和 value 属性 , 且 使 用 param 传 入 参数 的 形式 。<br/> 
<siurl action="showBook" value="xxxx"> 
<s:param name="author” value=""yeeku'" /> 
</s:url> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.51 所 示 的 窗口 。 


s:url 来 生成 一 个 URL 地 址 


只 指定 value 必 性 的 形式 。 
ditCadget-action 


指定 action 属 性, 且 使 用 paraz 全 入 参 娄 的 形式 - 
/dataTag/ahovBocik actionyauthorsyealu 


和 二 要 定 we 属性 也 不 扣 证 lw 大 性 且 人 用 area 入 入 多 的 形 
/dataTag/snurl. jap9id22 


同时 指定 actian 属 性 和 valuz 属 性 , 有 使 用 paraz 伟 入 争 数 的 形式 。 
rr9authorsyeeknu 


图 3.51 使 用 url 标签 来 生成 URL 地 址 


10. property 标签 

property 标签 的 作用 就 是 输出 指定 值 。property 标签 输出 value 属性 指定 的 值 ， 如 果 没 有 指定 value 
属性 ， 则 默认 输出 ValueStack 栈 项 的 值 。 使 用 该 标签 有 如 下 几 个 属性 。 

> default: 这 是 一 个 可 选 属 性 ， 如 果 需 要 输出 的 属性 值 为 null， 则 显示 default 属性 指定 的 值 。 

> escape: 这 是 一 个 可 选 属性 ， 指 定 是 否 escape HTML 代码 。 该 属性 值 默 认 是 true。 
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> value: 这 是 一 个 可 选 属性 ， 指 定 需要 输出 的 属性 值 ， 如 果 没有 指定 该 属性 ， 则 默认 输出 


ValueStack 栈 项 的 值 。 
前 面包 含 了 大 量 使 用 property 属性 的 示例 ， 此 处 不 再 给 出 使 用 property 属性 的 示例 。 


>>3.11.9 主题 和 模板 


因为 Struts 2 所 有 的 UI 标签 都 是 基于 主题 和 模板 的 ， 主 题 和 模板 是 Struts 2 所 有 UI 标签 的 核心 ， 
所 以 此 处 先 从 主题 和 模板 讲 起 。 模 板 是 一 个 UI 标签 的 外 在 表示 形式 ， 例 如 ， 当 我 们 使 用 <s:select .…/> 
标签 时 ，Struts 2 就 会 根据 对 应 的 select 模板 来 生成 一 个 有 模板 特色 的 下 拉 列 表 框 。 如 果 为 所 有 的 UI 
标签 都 提供 了 对 应 的 模板 ， 那 么 这 系列 的 模板 就 会 形成 一 个 主题 。 

对 于 一 个 JSP 页 面 里 包含 的 UI 标签 而 言 ， 既 可 以 直接 设置 该 UI 标签 需要 使 用 的 模板 ， 也 可 以 设 
置 该 UI 标签 使 用 的 主题 。 实 际 上 ， 对 于 界面 开发 者 而 言 ， 并 不 推荐 直接 设置 模板 属性 。 因 为 模板 是 
以 主题 的 形式 组 织 在 一 起 的 ， 界 面 开发 者 应 该 选择 特定 主题 ， 而 不 是 强制 使 用 特定 模板 来 表现 一 个 UL 
标签 。 

主题 是 模板 的 组 织 形 式 ， 模 板 被 包装 在 主题 里 面 ， 对 于 开发 者 应 该 是 透明 的 。 当 需要 使 用 特定 模 
板 来 表现 某 个 UI 标签 时 ， 应 让 主题 来 负责 模板 的 加 载 。 

设置 主题 的 方法 有 如 下 几 种 : 

> ”通过 设 定 特定 UI 标签 上 的 theme 属性 来 指定 主题 。 
通过 设 定 特定 UI 标签 外 围 的 Form 标签 的 theme 属性 来 指定 主题 。 
通过 取得 page 会 话 范围 内 以 theme 为 名 称 的 属性 来 确定 主题 。 
通过 取得 request 会 话 范围 内 的 命名 为 theme 的 属性 来 确定 主题 。 
通过 取得 session 会 话 范围 内 的 命名 为 theme 的 属性 来 确定 主题 。 
通过 取得 application 会 话 范围 内 的 命名 为 theme 的 属性 来 确定 主题 。 1 
通过 设置 名 为 struts.ui.theme 的 常量 默认 值 是 xhtml) 来 确定 默认 主题 ， 该 常量 可 以 在 
struts.properties 文件 或 者 struts.xml 文件 中 确定 。 . 

上 面 的 几 种 指定 特定 UI 标签 主题 的 方式 ， 它 们 是 有 着 不 同 优先 级 的 ， 排 在 前 面 的 方式 会 禾 盖 排 
在 后 面 的 方式 。 例 如 ， 我 们 通过 特定 UI 标签 上 的 theme 属性 指定 了 该 标签 的 主题 ， 那 么 后 面 指 定 的 
主题 将 不 会 起 作用 。 

从 上 面 的 介绍 可 以 看 出 ，Struts 2 完全 人 允许 在 一 个 视图 页 面 中 使 用 几 种 不 同 的 主题 。 关 于 设置 主题 
方式 的 选择 ， 通 常 有 如 下 建议 : 

如 果 需 要 改变 整个 表单 (包括 表单 元 素 的 主题 )， 则 可 以 直接 设置 该 表单 标签 的 theme 属性 。 如果 
需要 让 某 次 用 户 会 话 使 用 特定 的 主题 则 可 以 通过 在 session 中 设置 一 个 theme 的 变量 。 如 果 想 改变 整 
个 应 用 的 主题 ， 则 应 该 通过 修改 struts.ui.theme 常量 值 来 实现 。 

- 旦 指定 了 某 个 UI 标签 的 theme 属性 后 ，Struts 2 就 负责 根据 主题 来 加 载 模板 ，Struts 2 加 载 模板 
是 通过 主题 和 模板 目录 来 实现 的 。 

模板 目录 是 存放 所 有 模板 文件 的 地 方 ， 所 有 的 模板 文件 以 主题 的 方式 来 组 织 ， 模 板 目 录 下 有 如 图 
3.52 所 示 的 目录 结构 。 

Struts 2 的 模板 目录 是 通过 struts.ui.templateDir 常量 来 指定 的 ， 该 常量 的 默认 值 是 template， 即 意 
味 着 Struts 2 会 从 Web 应 用 的 template 目录 、CLASSPATH (包括 Web 应 用 的 WEB-INF/classes 路 径 和 
WEB-INF/lib 路 径 ) 的 template 目录 来 依次 加 载 特定 模板 文件 。 例如 ,我 们 使 用 一 个 select 标签 ， 且 指 
定 主题 为 xhtml， 则 加 载 模板 文件 的 顺序 为 : 

(1) 搜索 Web 应 用 里 /template/xhtml/select. 人 |。 

(2) 搜索 CLASSPATH 路 径 下 的 /template/xhtml/select. 人 tl。 


bb 
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和 3 


模板 自 亲 


主题 1 主 是 2 主 是 3 主题 " 


主题 1 的 模板 广 件 1 主题 | 约 模板 文件 2 ”主题 ! 的 模板 文 件 3 主题 | 的 模板 文件 n 
图 3.52 模板 目录 的 目录 结构 组 织 


从 上 面 的 介绍 中 可 以 看 出 , Struts 2 默认 的 模板 文件 是 *. 人 文件 , *. 亿 文件 是 FreeMarker 模板 文件 ， 
Struts 2 使 用 FreeMarker 技术 来 定义 所 有 模板 文件 。 因 此 ， 如 果 开 发 者 需要 扩展 自己 的 模板 ， 也 推荐 
使 用 FreeMarker 来 开发 自 定义 模板 。 

当然 ，Struts 2 也 可 以 选择 自己 的 模板 技术 ， 通 过 修改 struts.ui.templateSuffix 常量 的 值 ， 就 可 以 改 
变 Struts 2 默认 的 模板 技术 。 该 常量 可 以 接受 如 下 几 个 值 。 

> 仙 (默认 ) : 基于 FreeMarker 的 模板 技术 。 

> vm: 基于 Velocity 的 模板 技术 。 

> ”jsp: 基于 JSP 的 模板 技术 。 

虽然 Struts 2 允许 使 用 自己 的 模板 技术 ， 但 如 果 用 户 选择 了 使 用 Veliocty 或 者 JSP 作为 模板 技术 ， 
则 开发 者 必须 自己 完全 实现 模板 和 主题 ， 这 是 一 件 非常 有 挑战 的 工作 。 

“通常 不 推荐 开发 者 完全 实现 自 己 的 模板 和 主题 ， 而 应 该 对 原 有 主题 进行 扩展 ， 因 此 ， | 
开发 者 只 有 选择 原 有 的 FreeMarker 作为 模板 技术 . 不 过 读者 也 不 要 形 气 ，FreeMarker 是 一 | 
| 个 非常 简单 、 易 用 的 模板 语言 ， 完 全 可 以 取代 JSP 作为 表现 层 技术 ， 因 此 在 FreeMarker 上 、 

SR | 

Struts 2 默认 提供 了 三 个 主题 : simple、xhtml 和 css_xhtml， 用 WinRAR 打开 struts2-core-2.2.1.jar 
文件 , 将 看 到 一 个 template 文件 夹 ， 而 该 文件 夹 下 包含 了 simple、xhtml、css_xhtml 三 个 文件 夹 ， 这 三 
个 文件 夹 分 别 对 应 三 种 主题 。 从 Stmts 2.1 开始 ，Struts 2 核心 包 不 再 提供 Ajax 主题 ， 而 是 由 
struts2-dojo-plugin-2.2.1.jar 来 提供 Ajax 主题 。 

simple 主题 是 最 简单 的 主题 ， 它 是 最 底层 的 结构 ， 主 要 用 于 构建 最 基本 的 HTML UI 组 件 。 使 用 
simple 主题 时 ， 每 个 UI 标签 只 生成 一 个 简单 的 HTML 元 素 ， 不 会 生成 其 他 额外 的 内 容 ， 不 会 有 额外 
的 布局 行为 。 

Struts 2 的 xhtml 主题 和 css_xhtml 主题 都 是 对 simple 主题 的 包装 和 扩展 。 

xhtml 主题 是 Stmts 2 默认 的 主题 , 它 对 simple 主题 进行 扩展 , 在 该 主题 的 基础 上 增加 了 如 下 附加 
的 特性 : 

> 针对 HTML 标签 (如 textfield 和 select 标签 ) 使 用 标准 的 两 列表 格 布局 。 

> ”每 个 HTML 标签 增加 了 配套 的 label，label 既 可 以 出 现在 HTML 元 素 的 左边 ， 也 可 以 出 现在 

上 边 ， 这 取决 于 labelposition 属性 的 设置 。 

> 自动 输出 校 验 错误 提示 。 

> 输出 JavaScript 的 客户 端 校 验 。 

css_xhtml 主题 则 对 原 有 的 xhtml 主题 进行 了 扩展 ， 在 xhtml 主题 基础 上 加 入 了 CSS 样式 控制 。 
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>>3.11.10 自 定 义 主 题 


有 些 时 候 ， 系 统 提供 的 主题 可 能 不 能 完全 满足 开发 者 的 需要 ， 此 时 可 能 需要 创建 自 定义 的 主题 。 
创建 自 定义 的 主题 有 如 下 三 种 方式 : 

> ”开发 者 完全 实现 一 个 全 新 的 主题 。 

> 包装 一 个 现 有 的 主题 。 

> 扩展 一 个 现 有 的 主题 

对 于 开发 者 完全 实现 一 个 全 新 的 主题 的 方式 ， 这 种 方式 可 以 允许 开发 者 选择 自己 的 模板 技术 ， 例 
如 , 改换 使 用 JSP 或 者 Velocity 作为 模板 技术 。 但 这 种 方式 需要 开发 者 为 每 个 UI 标签 都 提供 自 定义 的 
模板 文件 ， 这 是 非常 大 的 工作 量 ， 因 此 不 推荐 使 用 这 种 方式 。 

Struts 2 允许 通过 对 现 有 主题 进行 包装 来 创建 自 定义 主题 ， 所 谓 包装 就 是 在 现 有 主题 基础 上 , 增加 
一 些 自 定义 代码 部 分 ， 从 而 完成 改写 。 

系统 的 xhtml 主题 就 大 量 使 用 了 包装 技术 ， 我 们 发 现在 xhtml 主题 下 的 模板 文件 可 能 包含 如 下 代 
码 片 段 。 

<!-- 包含 xhtml 主题 下 的 controlheader.ftl1 模板 --> 

<#include "/${parameters.templateDir}/xhtml/controlheader. ftl" /> 

<!-- 包含 simple 主题 下 的 xxx. ftl 模板 --> 

<#include "/${parameters.templateDir}/simple/xxx:ftl” /> 


<!-- 包含 xhtml 主题 下 的 controlfooter.ftl 模板 --> 
<#include "/${parameters.templateDir}/xhtml/controlfooter.ft1l" /> 


这 个 模板 使 用 一 个 header 和 一 个 footer 包装 了 simple 主题 下 已 存在 的 模板 ,从 而 为 原 有 模板 增加 


使 用 纯粹 的 包装 方法 来 创建 主题 时 ， 开 发 颂 为 每 个 UI 组 件 都 提供 自 定义 主题 
的 模板 文件 ， 即 使 自 定义 主题 里 某 个 UI 组 件 与 原来 主题 里 UI 组 件 的 行为 完全 一 样 。 


除 此 之 外 ，Struts 2 允许 对 现 有 的 主题 进行 扩展 。 在 这 种 方式 下 ， 开 发 者 只 需要 提供 自 定义 的 模板 
文件 。 例 如 ， 用 户 自 定 义 的 主题 是 以 xhtml 主题 为 基础 的 ， 并 且 只 想 改变 select UI 标签 的 行为 ， 则 可 
以 提供 一 个 自己 的 select.fl 文件 ， 并 将 该 文件 放 在 对 应 的 主题 目录 (lee) 下 。 

下 面 是 笔者 提供 的 select .fl 文件 代码 。 

程序 清单 : codes\033.11\extends\WEB-INF\src\template\lee\select. 人 i 


<!-- 加 入 自己 的 文字 部 分 --> 

<h3> 作 者 李刚 已 经 出 版 的 图 书 :</h3> 

<!-- 包含 xhtml 主题 下 的 controlheader.ftl 模板 --> 

<#include "/${parameters.templateDir}/xhtml/controlheader.ft1l" /> 

<!-- 包含 simple 主题 下 的 select .ftl 模板 --> 

<#include "/${parameters.templateDir}/simple/select.ftl" /> 

<!-- 包含 xhtml 主题 下 的 controlfooter.ftl 模板 --> 

<#include "/${parameters.templateDir}/xhtml/controlfooter.ftl" /> | 

生成 项 目 时 ，Ant 会 将 该 文件 复制 到 Web 应 用 的 WEB-INF\class\template\lee 路 径 下 ， 这 表明 笔者 
扩展 了 原 有 的 主题 ， 新 主题 名 为 lee， 但 该 主题 只 为 select 标签 提供 了 模板 。 

除 此 之 外 ， 还 必须 在 主题 目录 下 增加 一 个 theme.properties 文件 ， 该 文件 指定 自 定义 模板 是 以 哪个 
模板 为 基础 进行 扩展 的 。 该 文件 中 只 有 一 行 代码 : 

程序 清单 : codes\03\3.11\extends\WEB-INF\src\template\lee\theme.properties 


# 指 定 该 主题 以 xhtml 主题 为 基础 进行 扩展 
parent=xhtml 


256 


http://52pdf.taobao.com 


3 


扩展 了 自己 的 lee 主题 之 后 ， 就 可 以 在 JSP 页 面 中 使 用 该 主题 了 。 
<!-- 使 用 select 标签 生成 一 个 列表 框 ， 指 定 使 用 lee 的 主题 --> 
<s:select name="aa" theme="lee" 1ist="{ "疯狂 Java 讲义 

，" 轻 量 级 Java EE 企业 应 用 实战 ” 

，" 经 典 Java EE 企业 应 用 实战 "， 

"疯狂 Ajax 讲义 '}”size="5"/> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.53 所 示 的 效果 。 


图 3.53 使 用 自 定义 主题 的 效果 


从 图 3.53 中 可 以 看 出 ， 因 为 我 们 在 select 模板 文件 中 增加 了 一 个 标题 ， 故 此 处 页 面 中 的 下 拉 列 表 
也 增加 了 一 个 标题 (这 个 标题 是 通过 主题 生成 的 ， 而 不 是 直接 写 在 这 里 的 )。 

Struts 2 的 主题 、 模 板 技术 是 非常 优秀 的 : 每 个 应 用 中 总 有 大 量 表单 、 表 现 层 组 件 ， 它 们 有 相似 的 
外 观 ， 在 传统 的 Web 开发 过 程 中 ， 我 们 不 得 不 在 各 页 面 重复 定义 这 些 表单 、 表 现 层 组 件 ， 但 使 用 了 
Struts 2 之 后 ,我 们 就 可 以 把 它们 定义 成 自 定义 主题 的 模板 ,然后 就 可 以 重复 使 用 它们 了 ， 这 样 就 可 以 
提供 极 好 的 代码 复 用 。 


>>3.11.11 表单 标签 


Struts 的 表单 标签 ， 可 分 为 两 种 ，form 标签 本 身 和 单个 表单 元 素 的 标签 。form 标签 的 行为 不 同 于 
表单 元 素 标签 。Struts 2 的 表单 元 素 标签 都 包含 了 非常 多 的 属性 ， 但 有 很 多 属性 完全 是 通用 的 。 

所 有 表单 标签 处 理 类 都 继承 了 UIBean 类 , UIBean 包含 了 一 些 通用 属性 , 这 些 通用 属性 分 成 三 种 : 

> ”模板 相关 属性 。 

> ”JavaScript 相关 属性 。 

> 通用 属性 。 

除了 这 些 属性 之 外 ， 所 有 表单 元 素 标签 都 存在 一 个 特殊 的 属性 ，form， 这 个 属性 引用 表单 元 素 所 
在 的 表单 ， 通 过 该 form 属性 ， 可 以 实现 表单 元 素 和 表单 之 间 的 交互 。 例 如 ， 我 们 可 以 通过 
${parameters.form.id} 来 取得 表单 元 素 所 在 表单 的 ID。 下 面 详细 列 出 这 些 表单 标签 的 通用 属性 。 

模板 相关 的 通用 属性 如 下 。 

> ”templateDir， 指定 该 表单 所 用 的 模板 文件 目录 。 

> ”theme: 指定 该 表单 所 用 的 主题 。 

> ”template: 指定 该 表单 所 用 的 模板 。 

Javascript 相关 的 通用 属性 如 下 。 

> onclick: 指定 鼠标 在 该 标签 生成 的 表单 元 素 上 单 击 时 触发 的 JavaScript 函数 。 
ondbclick: 指定 鼠标 在 该 标签 生成 的 表单 元 素 上 双击 时 触发 的 JavaScript 函数 。 
onmousedown: 指定 鼠标 在 该 标签 生成 的 表单 元 素 上 按 下 时 触发 的 JavaScript 函数 。 
onmouseup: 指定 鼠标 在 该 标签 生成 的 表单 元 素 上 松 开 时 触发 的 JavaScript 函数 。 
onmouseover: 指定 鼠标 在 该 标签 生成 的 表单 元 素 上 县 停 时 触发 的 JavaScript 函数 。 
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onmouseout: 指定 鼠标 移出 该 标签 生成 的 表单 元 素 时 触发 的 JavaScript 函数 。 

onfocus: 指定 该 标签 生成 的 表单 元 素 得 到 焦点 时 触发 的 函数 。 

onblur: 指定 该 标签 生成 的 表单 元 素 失去 焦点 时 触发 的 函数 。 

onkeypress: 指定 单 击 键 盘 上 某 个 键 时 触发 的 函数 。 

onkeyup: 指定 松 开 键盘 上 某 个 键 时 触发 的 函数 。 

onkeydown: 指定 按 下 键盘 上 某 个 键 时 触发 的 函数 。 

onselect: 对 下 拉 列 表 项 等 可 以 选择 表单 元 素 ， 指 定 选 中 该 元 素 时 触发 的 JavaScript 函数 。 
onchange: 对 于 文本 框 等 可 以 接受 输入 的 表单 元 素 ， 指 定 当 值 改变 时 触发 的 JavaScript 函数 。 


因为 HTML 元 素 本 身 的 限制 ， 并 不 是 每 个 HTML 元 素 都 可 以 触发 以 上 的 所 有 函数 。 因 此 ， 上 面 
的 属性 并 不 是 对 Struts 2 的 每 个 标签 都 有 效 。 

Struts 2 还 允许 为 表单 元 素 设 置 提示 ， 当 鼠标 在 这 些 元 素 上 悬 停 时 ， 系 统 将 出 现 提示 ，Struts 2 将 
这 种 特性 称 为 Tooltip。 与 Tooltip 相关 的 通用 属性 如 下 。 
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tooltip: 设置 此 组 件 的 Tooltip。 

tooltiplcon: 设置 Tooltip 图 标的 URL 路 径 。 

tooltipAboveMousePointer: 是 否 在 光标 位 置 上 显示 Tooltip。 也 可 通过 设置 tooltipOffseY 属 
性 ， 设 置 Tooltip 与 光标 位 置 的 垂直 位 移 。 

tooltipBgColor: 设置 Tooltip 的 背景 色 。 

tooltipBglmg: 设置 Tooltip 的 背景 图 片 。 

tooltipBorderWidth， 设置 Tooltip 边框 的 宽度 。 

tooltipBorderColor: 设置 Tooltip 边框 的 颜色 。 

tooltipDelay: 设置 显示 Tooltip 的 时 间 延 迟 〈 单 位 是 毫秒 ) 。 

tooltipFixCoordinateX: 设置 固定 Tooltip 在 指定 的 X 坐标 上 ， 与 tooltipSticky 属性 结合 时 很 
有 用 。 

tooltipFixCoordinateY: 设置 固定 Tooltip 在 指定 的 Y 坐标 上 ， 与 tooltipSticky 属性 结合 时 很 
有 用 。 

tooltipFontColor: 设置 Tooltip 的 字体 颜色 。 

tooltipFontFace: 设置 Tooltip 的 字体 ， 例 如 verdana、geneva、sans-serif 等 。 
tooltipFontSize: 设置 Tooltip 的 字体 大 小 ， 例 如 30px。 

tooltipFontWeight: 设置 Tooltip 的 字体 是 否 使 用 粗 体 ， 可 以 接受 normal 和 bold ( 粗 体 ) 两 
个 值 。 

tooltipLeftOfMousePointer: 设置 是 否 在 光标 左 侧 显 示 Tooltip， 默 认 是 在 右边 显示 。 
tooltipOffsetX: 设置 Tooltip 相对 光标 位 置 的 水 平 位 移 。 

tooltipOffsetY: 设置 Tooltip 相对 光标 位 置 的 垂直 位 移 。 

tooltipOpacity: 设置 Tooltip 的 透明 度 ， 设 置 值 可 以 是 0 (完全 透明 ) 和 100 (不 透明 ) 之 间 
的 数字 。Opera 浏览 器 不 支持 该 属性 。 

tooltipPadding: 指定 Tooltip 的 内 部 间隔 。 例 如 ， 边 框 和 内 容 之 间 的 间距 。 
tooltipShadowColor: 使 用 指定 的 颜色 为 Tooltip 创建 阴影 。 

tooltipShadowWidth: 使 用 指定 的 宽度 为 Tooltip 创建 阴影 。 

tooltipStatic， 设置 Tooltip 是 否 随 着 光标 的 移动 而 移动 。 

tooltipSticky: 设置 Tooltip 是 否 一 直 停 留 在 它 初始 的 位 置 ， 直 到 另外 一 个 Tooltip 被 激活 ， 或 
者 浏览 者 点 击 了 HTML 页 面 。 

tooltipStayAppearTime: 指定 一 个 Tooltip 消失 的 时 间 间 隔 〈 毫 秒 ) ， 即 使 鼠标 还 在 相关 的 
HTML 元 素 上 不 动 。 设 置 值 为 0， 就 和 没有 定义 一 样 。 
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tooltipTextAlign: 设置 Tooltip 的 标题 和 内 容 的 对 齐 方式 ， 可 以 是 right ( 右 对 齐 ) 、left ( 左 
对 齐 ) 或 justify (居中 对 齐 )。 
tooltipTitle: 设置 Tooltip 的 标题 文字 。 
tooltipTitleColor: 设置 Tooltip 的 标题 文字 的 颜色 。 
tooltipWidth: 设置 Tooltip 的 宽度 。 
此 之 外 ，Struts 2 还 有 其 他 的 通用 属性 ， 用 于 设置 表单 元 素 的 CSS 样式 等 。 
cssClass: 设置 该 表单 元 素 的 class 属性 。 
cssStyle: 设置 该 表单 元 素 的 style 属性 ， 使 用 内 联 的 CSS 样式 。 
tile: 设置 表单 元 素 的 tle 属性。 
disabled: 设置 表单 元 素 的 disabled 属性 。 
label: 设置 表单 元 素 的 label 属性 。 
labelPosition: 设置 表单 元 素 的 label 所 在 位 置 ， 可 接受 的 值 为 tpp 〈( 上 面 ) 和 left (左边 ) ， 
默认 是 在 左边 。 
requiredposition: 定义 必 填 标记 (默认 以 “作为 必 填 标记 ) 位 于 label 元 素 的 位 置 ， 可 接受 
的 值 为 left (左面) 和 right (右边 ) ， 默 认 是 在 右边 。 
> name: 定义 表单 元 素 的 name 属性 ， 该 属性 值 用 于 与 Action 的 属性 形成 对 应 。 
> required: 定义 是 否 在 表单 元 素 的 label 上 增加 必 填 标记 默认 以 “作为 必 填 标记 ) ， 设 置 
为 true 时 增加 必 填 标记 ， 否 则 不 增加 。 
> tablndex: 设置 表单 元 素 的 tabindex 属性 。 
> value: 设置 表单 元 素 的 value 属性 。 
1， 表 单 标签 的 name 和 value 属性 
对 于 表单 标签 而 言 ，name 和 value 属性 之 间 存 在 一 个 特殊 的 关系 : 因为 每 个 表单 元 素 会 被 映射 成 
Action 属性 ， 所 以 如 果 某 个 表单 对 应 的 Action 已 经 被 实例 化 〈 该 表单 被 提交 过 )、 且 其 属性 有 值 时 ， 
则 该 Action 对 应 表单 里 的 表单 元 素 会 显示 出 该 属性 的 值 ， 这 个 值 将 作为 表单 标签 的 value 值 。 
name 属性 设置 表单 元 素 的 名 字 , 表单 元 素 的 名 字 实 际 上 封装 着 一 个 请 求 参 数 ， 而 请 求 参数 是 被 封 
装 到 Action 属性 的 。 因 此 ， 可 以 将 该 name 属性 指定 为 你 希望 绑 定 值 的 表达 式 。 
也 就 是 说 ， 表 单 标签 的 name 属性 值 可 使 用 表达 式 ， 如 下 面 的 代码 所 示 : 
<!1-- 将 下 面 文本 框 的 值 绑 定 到 Action 的 person 属性 的 firstName 属性 --> 


<s:textfield name="person.firstName"/> 

大 多 数 场景 下 ， 我 们 希望 表单 元 素 里 可 以 显示 出 对 应 Action 的 属性 值 ， 因 为 name 和 value 属性 
存在 这 种 特殊 关系 ， 所 以 我 们 使 用 Struts 2 的 标签 库 时 ， 无 须 指定 value 属性 ， 因 为 Struts 2 会 为 我 们 
处 理 这 些 。 例 如 ， 如 下 代码 : 


<!-- 将 下 面 文本 框 的 值 绑 定 到 Action 的 person 属性 的 firstName 属性 --> 
<s:textfield name="person. firstName"/> 


虽然 上 面 的 文本 框 没 有 指定 value 属 性 ,但 Stmuts 2 一 样 会 在 该 文本 框 中 输出 对 应 Action 里 的 person 
属性 的 firstName 属性 值 (如 果 该 Action 已 经 被 实例 化 ， 且 其 person 属性 有 对 应 的 值 )。 

Struts 2 提供 了 很 多 表单 标签 ， 大 部 分 表单 标签 和 HTML 表单 元 素 之 间 有 一 一 对 应 的 关系 ， 此 处 
不 再 著述 。 下 面 会 介绍 一 些 比 较 特殊 的 表单 标签 。 

2. checkboxlist 标签 

checkboxlist 标签 可 以 一 次 创建 多 个 复 选 框 ， 用 于 同时 生成 多 个 <input type="checkbox” .> 的 
HTML 标签 。 它 根据 list 属性 指定 的 集合 来 生成 多 个 复 选 框 ， 因 此 ， 使 用 该 标签 指定 一 个 list 属性 。 
除 此 之 外 ， 其 他 属性 大 部 分 是 通用 属性 ， 此 处 不 再 著述 。 

除 此 之 外 ，checkboxlist 表单 还 有 如 下 两 个 常用 属性 。 


VvVvvvvv 有 Vvyv 


vv 


259 


http://52pdf.taobao.com 
米 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


> “listKey: 该 属性 指定 集合 元 素 中 的 某 个 属性 (例如 集合 元 素 为 Person 实例 ， 指 定 Person 实 
例 的 name 属性 ) 作为 复 选 框 的 value。 如 果 集 合 是 Map， 则 可 以 使 用 key 和 value 值 指定 
Map 对 象 的 key 和 value 作为 复 选 框 的 value。 

> “listValue: 该 属性 指定 集合 元 素 中 的 某 个 属性 〈 例 如 集合 元 素 为 Person 实例 ， 指 定 Person 
实例 的 name 属性 ) 作为 复 选 框 的 标签 。 如 果 集合 是 Map， 则 可 以 使 用 key 和 value 值 指定 
Map 对 象 的 key 和 value 作为 复 选 框 的 标签 。 

下 面 是 使 用 该 标签 的 代码 示例 ， 其 中 分 别 使 用 了 简单 集合 、 简 单 Map 对 象 、 集 合 里 放置 Java 实 

例 来 创建 多 个 复 选 框 。 
程序 清单 : codes\033.11\formTag\s-checkboxlistjsp 


<s:form> 
<!-- 使 用 简单 集合 来 生成 多 个 复 选 框 --> 
<s:checkboxlist name="a"” label=" 请 选择 您 喜欢 的 图 书 " 
labelposition="top”list="{' 轻 量 级 Java EE 企业 应 用 实战 ' ， 
/经 典 Java EE 企业 应 用 实战 ” ， "疯狂 Java 讲义 '}"/> 
<!-- 使 用 简单 Map 对 象 来 生成 多 个 复 挝 杠 
使 用 Map 对 象 的 kxey 〈 书 名 ) 作为 复 选 框 的 value, 
使 用 Map 对 象 的 value《〈 出 版 时 间 ) 作为 复 选 框 的 标签 -一 > 
<s:checkboxlist name="b" label=" 请 选择 您 想 选 择 出 版 日 期 " 
labelposition="top” 1ist="#{" 锭 狂 Java 讲义 ': '2008 年 9 月 '， 
' 轻 量 级 Java EE 企业 应 用 实战 ' : "2008 月 12 月 '， 
' 经 典 Java EE 企业 应 用 实战 ' : '2010 年 8 月 '}" 
listKey="key" 
listValue="value"/> 
<!-- 创建 一 个 JavaBean 对 象 ， 并 将 其 放 入 Stack Context 中 --> 
<s:bean name="org.crazyit.app.service,BookService" id="bs"/> 
<!-- 使 用 集合 里 放 多 个 JavaBean 实例 来 生成 多 个 复 选 框 
使 用 集合 元 素 里 name 属性 作为 复 选 框 的 标签 
使 用 集合 元 素 里 author 属性 作为 复 选 框 的 value--> 
<s:checkboxlist name="b” 1abel=" 请 选择 您 喜欢 的 图 书 " 
labelposition="top" 
list="#bs .books" 
listKey="author" 
listValue="name"/> 
</s:form> 


在 上 面 的 代码 中 ， 简 单 集合 对 象 和 简单 Map 对 象 都 是 通过 OGNL 表达 式 语言 直接 生成 的 ， 对 于 
根据 Java 集合 来 生成 复 选 框 列表 的 情形 ， 则 使 用 了 一 个 <s:bean … 亿 标签 来 创建 一 个 JavaBean 实例 。 
该 JavaBean 的 类 代码 如 下 。 

程序 清单 :codes\03W3.11\formTag\WWEB-INF\src\org\crazyitapp\service\BookServicejava 

public class Bookservice 
public Book[] getBooks() 


拉 
return new Book[] 


{ 
new Book (" 狗 狂 Java 讲义 ", "李刚 ") ， 
new Book(" 轻 量 级 Java EE 企业 应 用 实战 "， "李刚 ") ， 
new Book(" 经 典 Java EE 企业 应 用 实战 ", "李刚 ") ， 
new Book ("疯狂 Ajax 讲义 ", "李刚 ") 
1 
ke 5 
} 

上 面 的 代码 定义 了 一 个 BookService 类 ， 该 类 里 定义 了 一 个 getBooks 方法 ， 就 可 以 通过 表达 式 来 
直接 访问 该 BookService 实例 的 books 属性。 该 BookService 中 封装 的 Book 类 就 是 一 个 简单 的 JavaBean， 
其 类 代码 如 下 。 

程序 清单 : codes\03\3.11\formTag\WEB-INF\src\org\crazyit\app\dto\Book.java 

Public class Book 
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{ 
// 定 义 Book 类 的 两 个 属性 
private String name; 
private String author; 
// 定 义 一 个 无 参数 的 构造 器 
public Book() 
{ 


} 
// 定 义 一 个 有 参数 的 构造 器 
public Book(String name , String author) 
{ 
this.name = name; 
this.author = author; 


} 
V/ 此 处 省 略 了 name 和 author 属性 的 setter 和 getter 方法 


当 我 们 在 浏览 器 中 浏览 该 页 面 时 ， 将 看 到 如 图 3.54 所 示 的 页 面 。 


使 用 s:checkboxlist 生 成 多 个 


OTEd dd 
由 既 量 级 ]wvs 到 企业 应 用 突 凡 器 经 典 Jova 本 企业 个 用 实 夏 加 妆 星 


Java 计 义 
PY Ed LLL 
加 2008 年 9 月 回 2008 月 12 月 上 2010 年 8 
斌 翅 个 刘 天 的 用 站 
va 讲义 口 轻 量 级 Jeva 时 多 业 应 用 实 硫 回 经 典 Jara 下 企业 放 


四 病症] 
用 实战 日 并 纤 Aja 讲义 
E33 


ETTTTTD] 


图 3.54 使 用 三 种 方式 来 生成 多 个 复 选 框 


从 图 3.54 中 可 以 看 出 ， 通 过 指定 checkboxlist 标签 的 listKey 和 listValue 属性 ， 可 以 灵活 地 控制 这 
系列 复 选 框 的 value 和 标签 。 
读者 可 以 通过 查看 如 图 3.54 所 示 页 面 的 源 代码 ， 从 而 更 清楚 地 看 到 checkboxlist 标签 的 用 法 。 
3. doubleselect 标签 
doubleselect 标签 会 生成 一 个 级 联 列表 框 (会 生成 两 个 下 拉 列 表 框 )， 当 选择 第 一 个 下 拉 列 表 框 时 ， 
第 二 个 下 拉 列 表 框 的 内 容 会 随 之 改变 。 
因为 两 个 都 是 下 拉 列 表 框 ， 因 此 需要 指定 两 个 下 拉 列 表 框 的 选项 ， 因 此 有 如 下 常用 的 属性 。 
> “list， 指 定 用 于 输出 第 一 个 下 拉 列 表 框 中 选项 的 集合 。 
> “listKey: 该 属性 指定 集合 元 素 中 的 某 个 属性 (例如 集合 元 素 为 Person 实例 ， 指 定 Person 实 
例 的 name 属性 ) 作 为 第 一 个 下 拉 列 表 框 的 value。 如 果 集 合 是 Map, 则 可 以 使 用 key 和 value 
值 分 别 代表 Map 对 象 的 key 和 value 作为 复 选 框 的 value。 
> listValue: 该 属性 指定 集合 元 素 中 的 某 个 属性 (例如 集合 元 素 为 Person 实例 ， 指 定 Person 
实例 的 name 属性 ) 作为 复 选 框 的 标签 。 如 果 集合 是 Map， 则 可 以 使 用 key 和 value 值 分 别 
代表 Map 对 象 的 key 和 value 作为 第 一 个 下 拉 列 表 框 的 标签 。 
> ”doubleList: 指定 用 于 输出 第 二 个 下 拉 列 表 框 中 选项 的 集合 。 
> doubleListKey: 该 属性 指定 集合 元 素 中 的 某 个 属性 (例如 集合 元 素 为 Person 实例 ， 指 定 
Person 实例 的 name 属性 ) 作为 第 二 个 下 拉 列 表 框 的 value。 如 果 集合 是 Map， 则 可 以 使 用 
key 和 value 值 指定 Map 对 象 的 key 和 value 作为 复 选 框 的 value。 
> ”doubleListValue: 该 属性 指定 集合 元 素 中 的 某 个 属性 〈 例 如 集合 元 素 为 Person 实例 ， 指 定 
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Person 实例 的 name 属性 ) 作为 第 二 个 下 拉 列表 框 的 标签 。 如 果 集 合 是 Map， 则 可 以 使 用 
key 和 value 值 来 指定 Map 对 象 的 key 和 value 作为 第 二 个 下 拉 列 表 框 的 标签 。 

> ”doubleName: 指定 第 二 个 下 拉 列 表 框 的 name 属性 。 

下 面 的 代码 示范 了 使 用 doubleselect 标签 来 生成 两 个 相关 的 下 拉 列 表 框 。 

程序 清单 : codes\033.11\formTag\s-doubleselectjsp 


<s:form action="x"> 
<s:doubleselect 

label=" 请 选择 您 喜欢 的 图 书 " 
name="author" list="{' 李 刚 '，'David'}" 
doubleList="top 一 ' 李 刚 ' ? {'struts 2 权威 指南 '， 
' 轻 量 级 Java EE 企业 应 用 实战 '，' 瘦 狂 Java 讲义 ' ) : 
{'Javascript: The Definitive Guide'}" 
doubleName="book"/> 

</s:form> 


上 面 的 代码 表示 , 第 一 个 下 拉 列 表 框 使 用 "{' 李 刚 ', 'David"}" 集 合 来 创建 列表 项 , 而 第 二 个 则 根据 前 
-个 的 选择 来 确定 值 。doubleList 的 值 是 一 个 三 目 运 算 符 表达 式 , 意义 是 当 第 一 个 列表 框 的 值 为 "李刚 " 
时 ， 第 二 个 列表 框 就 使 用 第 一 个 集合 来 创建 列表 项 ， 否 则 使 用 第 二 个 集合 来 创建 列表 项 。 在 浏览 器 中 
浏览 该 页 面 ， 将 看 到 如 图 3.55 所 示 的 页 面 。 


CG XD 


EP 
使 用 s:doubleselect 生 成 级 联 下 拉 列 表 杠 
dd a 


Tr 


图 3.55 使 用 doubleselect 生成 级 联 下 拉 列 表 框 


使 用 doubleselect 标签 时 ,必须 放 在 <s:form .> 标签 中 使 用 ， 上 用。 须 为 该 < orm .../> 
标 tion A 除 此 之 外 ， 还 应 该 在 struts.xml 文件 中 增加 如 下 一 


将 所 有 JSP sp 映射 成 可 通过 Action 来 访问 ~ 


<action name="*"> 
<result>/{1}.jsp</result> 

</action> 

在 默认 情况 下 ， 第 一 个 下 拉 列 表 框 只 支持 两 项 ， 如 果 第 一 个 下 拉 列 表 框 包含 三 个 或 更 多 的 值 ， 这 
里 的 list 和 doubleList 属性 就 不 能 这 样 直 接 设 定 了 。 

我 们 可 以 采用 一 种 迁 回 方式 来 实现 ， 首 先 定义 一 个 Map 对 象 ， 该 Map 对 象 的 value 都 是 集合 ， 
样 就 能 以 Map 对 象 的 多 个 key 创建 第 一 个 下 拉 列 表 框 的 列表 项 , 而 每 个 key 对 应 的 集合 则 用 于 创建 第 

-个 下 拉 列 表 框 的 列表 项 。 
看 下 面 的 代码 示例 。 
程序 清单 : codes\03W3.11\formTag\s-doubleselect2jsp 


<h3> 使 用 s:doubleselect 生成 级 联 下 拉 列 表 框 </h3> 
<!-- 创建 一 个 复杂 的 Map 对 象 ，key 为 普通 字符 串 ，value 为 集合 --> 
<s:set name="bs" value="#{' 李 刚 ': {' 瘦 狂 Java 讲义 '， 
' 轻 量 级 Java EE 企业 应 用 实战 '，' 经 典 Java EE 企业 应 用 实战 '}, 
David' : ome The Definitive Guide')}, 
'Johnson': {'Expert One-on-One J2EE Design and Development'}}"/> 
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<!-- 使 用 Map 对 象 来 生成 级 联 列表 框 --> 
<s:form action="x"> 
<s:doubleselect 

label=" 请 选择 您 喜欢 的 图 书 ” 
size="3" 
name="author" list="#bs.keySet()" 
doubleList="#bs[top]” 
doublesize="3" 
doubleName="book"/> 


</s:form> 
通过 这 种 方式 ， 就 可 以 实现 在 第 一 个 列表 框 中 包含 多 个 列表 项 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 
如 图 3.56 所 示 的 页 面 。 
BC XH w/ends 
Er 
使 用 s:doubleselect 生 成 级 联 下 近 列 表 框 
Wa 
二 > 
全 和 Try 主人 让 | 
3 
图 3.56 使 用 复杂 Map 对 象 来 生成 级 联 列表 框 
4. head 标签 
该 标签 主要 用 于 生成 HTML 主要 页 面 的 HEAD 部 分 。 因 为 有 些 主题 需要 包含 特定 的 CSS 和 
JavaScript 代码 ， 而 该 标签 则 用 于 生成 对 这 些 CSS 和 JavaScript 代码 的 引用 。 


例如 ， 如 果 需 要 在 页 面 中 使 用 Ajax 组 件 ， 则 使 用 一 个 带 theme="ajax" 属 性 的 head 标签 ， 就 可 以 
将 标准 Ajax 的 头 信息 包含 在 页 面 中 。 

使 用 Ajax 主题 时 ， 可 以 通过 设置 head 标签 的 debug 参数 为 tue， 从 而 打开 调试 标志 。 
注意 :w 
一 般 使 用 Struts 2 的 UI 标签 .JavaScript 客户 端 校 验 等 需要 JavaScript 库 和 CSS 支持 本 


5. optiontransferselect 标签 
optiontransferselect 会 生成 两 个 列表 选择 框 ， 并 生成 系列 的 按钮 用 于 控制 各 选项 在 两 个 下 拉 列 表 之 
间 的 移动 、 升 降 等 。 当 提交 该 表单 时 ， 两 个 列表 选择 框 对 应 的 请 求 参 数 都 会 被 提交 。 
因为 该 标签 会 生成 两 个 列表 框 ， 因 此 需要 分 别 指定 两 个 列表 框 中 的 集合 、label 等 属性 ， 下 面 是 该 
标签 常用 的 属性 。 
> addAllToLeftLabel: 设置 全 部 移动 到 左边 按钮 上 的 文本 。 
addAlIToRightLabel; 设置 全 部 移动 到 右边 按钮 上 的 文本 。 
addToLeftLabel: 设置 向 左 移动 按钮 上 的 文本 。 
addToRightLabel: 设置 向 右 移动 按钮 上 的 文本 。 
allowAddAliToLeft， 设置 是 否 出 现 全 部 移动 到 左边 的 按钮 。 
allowAddAlIToRight: 设置 是 否 出 现 全 部 移动 到 右边 的 按钮 。 
allowAddToLeft: 设置 是 否 出 现 移动 到 左边 的 按钮 。 
allowAddToRight: 设置 是 否 出 现 移动 到 右边 的 按钮 。 


bE 
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leftTitle: 设置 左边 列表 框 的 标题 。 

rightTitle: 设置 右边 列表 框 的 标题 。 

allowSelectAll: 设置 是 否 出 现 全 部 选择 按钮 。 

selectAlILabel: 设置 全 部 选择 按钮 上 的 文本 。 

doubleList; 设置 用 于 创建 第 二 个 下 拉 选 择 框 的 集合 。 这 是 必 填 属性 。 
doubleListKey: 设置 创建 第 二 个 下 拉 选 择 框 的 选项 value 的 属性 。 
doubleListValue: 设置 创建 第 二 个 下 拉 选 择 框 的 选项 label 的 属性 。 
doubleName: 设置 第 二 个 下 拉 选 择 框 的 name 属性 ， 这 是 必 填 属性 。 
doubleValue: 设置 第 二 个 下 拉 选 择 框 的 value 属性 。 

doubleMultiple: 设置 第 二 个 下 拉 选 择 框 是 否 允许 多 选 。 

list: 设置 用 于 创建 第 一 个 下 拉 选 择 框 的 集合 。 这 是 必 填 属性 。 
listKey: 设置 创建 第 一 个 下 拉 选 择 框 的 选项 value 的 属性 。 

listValue: 设置 创建 第 一 个 下 拉 选 择 框 的 选项 label 的 属性 。 


wy Mv vy yw 


pi 
fr 注意 :< 
此 处 的 list、doubleList、listKey、doubleListKey、listValue 和 doubleListValue 非常 类 


似 于 checkboxlist 标签 中 list、listKey 和 listValue 的 用 法 ， 只 是 此 处 用 于 生成 两 个 列表 选 si 
择 框 ， 而 前 者 是 生成 多 个 复 选 框 而 已 。 ey 


> name: 设置 第 一 个 下 拉 选 择 框 的 name 属性 。 
> ”value: 设置 第 一 个 下 拉 选 择 框 的 value 属性 。 
> multiple: 设置 第 一 个 下 拉 选 择 框 是 否 允许 多 选 。 


本 
.注意 : 和 
通常 无 须 为 第 一 个 、 列表 框 设置 id 属性 (ii 和 doubleld 来 指定 )， 因 为 : 

这 两 个 列表 框 的 id 将 由 optiontransferselect 标签 自动 生成 .该 标签 所 生成 的 id 和 doubleld 3 


分 别 为 <form_id> <optiontransferselect_name> 和 <form_id> <doubleName>. 


下 面 代码 是 使 用 optiontransferselect 标签 的 示范 , 它 分 别 指定 了 两 个 简单 集合 来 生成 两 个 下 拉 列 表 
框 的 列表 项 。 
程序 清单 : codes\03\3.11\formTag\s-optiontransferselect.jsp 
<s:form> 


<!-- 使 用 简单 集合 对 象 来 生成 可 移动 的 下 拉 列 表 框 --> 
<s:optiontransferselect 
labe1=" 请 选择 你 喜欢 的 图 书 ” 
name="cnbook" 
leftTitle=" 中 文 图 书 :" 
rightTitle=" 外 文 图 书 " 
list="{' 并 狂 Java 讲义 ，，'Struts 2 权威 指南 '， 
' 轻 量 级 Java EE 企业 应 用 实战 ' "经典 Java EE 企业 应 用 实战 '}" 
multiple="true" 
addToLeftLabel=" 向 左 移动 " 
selectAllLabel=" 全 部 选择 " 
addAllToRightLabel=" 全 部 右 移 " 
headerKey="cnKey" 
headerValue="--- 选择 中 文 图 书 ---" 
emptyOption="true" 
doubleList="{'Expert One-on-One J2EE Design and Development', 
'JavaSscript: The Definitive Guide'}" 
doubleName="enBook" 
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doubleHeaderKey="enKey" 
doubleHeaderValue="--- 选择 外 文 图 书 ---" 
doubleEmptyOption="true" 
doubleMultiple="true" 

/> 

</s:form> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.57 所 示 的 页 面 。 


使 用 sa:optiontransferseleet 来 生成 可 敌 动 列表 项 的 下 拉 列 表 杠 


和 外 六 图书 
7 0 
mn SB ss ne oe Fam Decign od boneleeee 
| Te The oti Fa 


| 
| 是 加 Javs 区 企业 应 用 六 才 之 
| 旺 和 Jery EE 将 业 启用 头皮 


图 3.57 使 用 optiontransferselect 标签 的 效果 
6. select 标签 


select 标签 用 于 生成 一 个 下 拉 列 表 框 ， 使 用 该 标签 必须 指定 list 属性 ， 系 统 会 使 用 list 属性 指定 的 
集合 来 生成 下 拉 列 表 框 的 选项 。 这 个 list 属性 指定 的 集合 ， 既 可 以 是 普通 集合 ， 也 可 以 是 Map 对 象 ， 
还 可 以 是 元 素 对 象 的 集合 。 

除 此 之 外 ，select 表单 还 有 如 下 几 个 常用 属性 。 

> listKey: 该 属性 指定 集合 元 素 中 的 某 个 属性 〈 例 如 集合 元 素 为 Person 实例 ,指定 Person 实 

例 的 name 属性 ) 作为 复 选 框 的 value。 如 果 集合 是 Map， 则 可 以 使 用 key 和 value 值 分 别 
代表 Map 对 象 的 key 和 value 作为 复 选 框 的 value。 

> listValue: 该 属性 指定 集合 元 素 中 的 某 个 属性 〈 例 如 集合 元 素 为 Person 实例 ， 指 定 Person 

实例 的 name 属性 ) 作为 复 选 框 的 标签 。 如 果 集 合 是 Map， 则 可 以 使 用 key 和 value 值 分 别 
代表 Map 对 象 的 key 和 value 作为 复 选 框 的 标签 。 

> multiple: 设置 该 列表 框 是 否 允许 多 选 。 

从 上 面 的 介绍 中 可 以 看 出 ，select 标签 的 用 法 与 checkboxlist 标签 的 用 法 非常 相似 。 

下 面 是 使 用 该 标签 的 代码 示例 ， 其 中 分 别 使 用 了 简单 集合 、 简 单 Map 对 象 、 集 合 里 放置 Java 实 
例 来 创建 三 个 列表 框 。 

程序 清单 :codes\03\3.11\formTag\s-selectjsp 

<s:form> 

<!-- 使 用 简单 集合 来 生成 下 拉 选 择 框 --> 

<s:select name="a”1abel=" 请 选择 您 喜欢 的 图 书 ” labelPosition="top" 
multiple="true” list="{' 首 狂 Java 讲义 '，' 轻 量 级 Java EE 企业 应 用 实战 '， 
'JavaScript: The Definitive Guide' 六 

<!-- 使 用 简单 Map 对 象 来 生成 下 拉 选 择 框 --> 


<s:select name="b” label=" 请 选择 您 想 选择 出 版 日 期 ”labelposition="top" 
list="#{' 狼 狂 Java 讲义 ': '2008 年 9 月， 


listKey="key" 
listValue="value"/> 
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<!-- 创建 一 个 JavaBean 实例 --> 
<s:bean name="lee.BookService" id="bs"/> 
<!-- 使 用 集合 里 放 多 个 JavaBean 实例 来 生成 下 拉 选 择 框 --> 
<s:select name="b"” 1abel=" 请 选择 您 喜欢 的 图 书 ” labelposition="top” 
multiple="true" 
list="#bs .books" 
listKey="author™ 
listValue="name"/> 
</s:form> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.58 所 示 的 页 面 。 
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图 3.58 使 用 select 标签 生成 列表 选择 框 
7. radio 标签 


radio 标签 的 用 法 与 checkboxlist 的 用 法 几乎 完全 相同 , 一 样 可 以 指定 label \list\listKey 和 listValue 
等 属性 。 与 checkboxlist 唯一 不 同 的 是 ，checkboxlist 生成 多 个 复 选 框 ， 而 radio 生成 多 个 单 选 钮 。 
看 下 面 的 使 用 radio 标签 的 代码 示例 。 
程序 清单 : codes\03\3.11\formTag\s-radio.jsp 
<s: form> 
<!-- 使 用 简单 集合 来 生成 多 个 单 选 框 --> 
<s:radio name="a"” 1abel=" 请 选择 您 喜欢 的 图 书 ” labelposition="top"” 
list="{ ' 狼 狂 Java 讲义 '，' 轻 量 级 Java EE 企业 应 用 实战 ' ， 
,经 典 Java EE 企业 应 用 实战 "1 "1> 
<4=- 使 用 简单 Map 对 象 来 生成 多 个 单 选 框 -> 
<s:radio name="b"” label=" 请 选择 您 想 选 择 出 版 日 期 ”labelposition="top" 
list="#{' 首 狂 Java 讲义 ':'2008 年 9 月 ' 
,' 轻 量 级 Java EE 企业 应 用 实战 ' : '2008 月 12 月" 
,，' 经 典 Java EE 企业 应 用 实战 ': '2010 年 8 月 '}" 
listKey="key" 
listValue="value"/> 
<!-- 创建 一 个 JavaBean 实例 --> 
<s:bean name="org.crazyit.app.service.BookService" id="bs"/> 
<!-- 使 用 集合 里 放 多 个 JavaBean 实例 来 生成 多 个 单 选 框 --> 
<s:radio name="c"” label=" 请 选择 您 喜欢 的 图 书 ”labelposition="top” 
list="#bs.books" 
listKey="author" 
listValue="name"/> 
</s:form> 


上 面 的 示例 代码 与 之 前 使 用 checkboxlist 的 示例 代码 几乎 完全 相似 , 只 是 此 处 使 用 的 是 radio 标签 ， 
所 以 上 面 代码 会 生成 一 系列 的 单 选 钮 。 浏 览 该 页 面 ， 将 可 以 看 到 如 图 3.59 所 示 的 页 面 。 

8. optgroup 标签 

optgroup 标签 用 于 生成 一 个 下 拉 列 表 框 的 选项 组 ， 因 此 ， 该 标签 必须 放 在 <s:select .. 人 标签 中 使 用 。 一 
个 下 拉 列表 框 中 可 以 包含 多 个 选项 组 ， 因 此 可 以 在 一 个 <s:select . 伺 标 签 中 使 用 多 个 <s:optgroup .… 户 标签 。 
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使 用 optgroup 标签 时 ， 与 使 用 select 标签 类 似 ,一 样 需要 指定 list、listKey 和 listValue 等 属性 ， 而 
且 这 些 属性 的 含义 也 与 使 用 select 标签 时 指定 这 些 属性 的 含义 相同 。 
除 此 之 外 ， 使 用 optgroup 标签 也 可 以 指定 label 属性 ， 但 这 个 label 属性 不 是 下 拉 列 表 框 的 label, 
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图 3.59 使 用 radio 标签 生成 系列 单 选 钮 


看 如 下 代码 示例 。 
程序 清单 ，codes\03\3.11\formTag\s-optgroup.jsp 
<s:form> 
<!-- 直接 使 用 Map 为 列表 框 生成 选项 --> 
<s:select 1abel=" 选 择 您 喜欢 的 图 书 ” name="book”size="7" 
list="#{ "疯狂 Java 讲义 '; "李刚 
，" 轻 量 级 Java EE 企业 应 用 实战 ': "李刚 ' 
，" 经 典 Java EE 企业 应 用 实战 ': 李刚 "}” 
listKey="value" 
listValue="key"> 
<!-- 使 用 Map 对 象 来 生成 选择 框 的 选项 组 --> 
<s:optgroup label="Rod Johnson" 
list="#{'Expert One-on-One J2EE Design and Development':'Johnson'}" 
listKey="value" 
listValue="key"/> 
<s:optgroup label="David Flanagan" 
list="#{"'Javascript: The Definitive Guide':'David'}" 


</s:select> 
</s:form> 


上 面 的 粗 体 字 代码 在 select 标签 内 定义 了 两 个 optgroup 标签 ， 用 于 生成 两 个 选项 组 。 两 个 选项 组 
都 指定 了 label 属性 ， 并 且 通 过 一 个 Map 设置 选项 组 里 包含 的 选项 。 程 序 斜 体 字 代 码 直 接 使 用 Map 为 
列表 框 生成 多 个 选项 。 在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.60 所 示 的 页 面 。 


图 3.60 使 用 optgroup 标签 生成 选项 组 
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从 如 图 3.60 所 示 的 页 面 中 可 以 看 到 : 直接 通过 select 标签 的 list 属性 生成 的 选项 ， 是 单独 的 选项 ; 
但 通过 optgroup 标签 的 list 属性 生成 的 选项 ， 则 形成 一 个 选项 组 。 浏 览 者 无 法 选中 选项 组 的 label。 

9. token 标签 

这 是 一 个 用 于 防止 多 次 提交 表单 的 标签 , token 标签 能 阻止 多 次 提交 表单 的 问题 (避免 刷新 页 面 导 
致 的 多 次 提交 )。 如果 需要 该 标签 起 作用 , 则 应 该 在 Struts 2 的 配置 文件 中 启用 Tokenlnterceptor 拦截 器 
或 TokenSessionStoreInterceptor 拦截 器 。 

token 标签 的 实现 原理 是 在 表单 中 增加 一 个 隐藏 域 ， 每 次 加 载 该 页 面 时 ， 该 隐藏 域 的 值 都 不 相同 。 
而 TokenInterceptor 拦截 器 则 拦截 所 有 用 户 请 求 ， 如 果 两 次 请 求 时 该 token 对 应 隐藏 域 的 值 相同 (前 一 
次 提交 时 token 隐藏 域 的 值 保存 在 session 里 )， 则 阻止 表单 提交 。 

通过 上 面 的 介绍 可 以 看 出 ， 这 个 标签 无 须 在 页 面 上 生成 任何 输出 ， 也 无 须 开发 者 手动 控制 ， 因 此 
使 用 该 标签 无 须 指 定 任何 属性 。 


默认 情况 下 ，token 标签 生成 的 隐藏 域 的 name 为 struts.token. 


另外 再 定义 一 个 名 为 struts.token 的 表单 域 . 


使 用 token 标签 的 代码 示例 如 下 

<!-- 使 用 token 标签 生成 一 个 阻止 重复 提交 的 隐藏 域 --> 

<s:token/> 

当 在 浏览 器 中 浏览 该 页 面 时 ,看 不 到 任何 输出 , 通过 查看 源 代码 可 以 发 现 该 <s:token/> 标 签 生 成 了 
如 下 代码 ; 


<!--~ 每 次 生成 不 同 的 值 来 阻止 重复 提交 --> 
<input type="hidden" 
name="struts.token" value="71M960FWDZW2M2BTGVQHT807J4XAV6CQ"/> 


为 了 让 读者 掌握 使 用 token 标签 防 刷新 的 用 法 ， 下 面 提供 一 个 提交 请 求 的 JSP 页 面 ,页 面 代码 
如 下 。 
程序 清单 : codes\03\3.11\formTag\s-token.jsp 
<h3> 使 用 s: token 防止 重复 提交 </h3> 


<s:form action="pro"> 
<!1-- 普通 表单 域 --> 
<s:textfield name="book" key="book"/> 
<!-- 用 于 防 刷新 的 token --> 
<s:token/> 
<s:submit value=" 提 交 "/> 
</s:form> 
从 上 面 页 面 中 可 以 看 出 ， 使 用 token 标签 非常 简单 ， 无 须 指定 太 多 额外 的 属性 。 上 面 的 form 标签 
定义 的 表单 会 向 pro Action 提交 请 求 ， 该 Action 对 应 的 处 理 类 代码 如 下 。 
程序 清单 : codes\03\3.11\formTag\WEB-INF\src\org\crazyit\app\action\ProAction.java 


public class ProAction extends ActionSopport 


{ 
private String book; 
// 省 略 book 属性 的 setter 和 getter 方法 


} 


上 面 的 Action 非常 简单 ， 从 该 Action 中 看 不 出 任何 防 刷新 的 代码 ， 但 通过 在 页 面 中 使 用 token 标 
签 ， 并 启用 Struts 2 的 token 拦截 器 即 可 完成 防 刷新 功能 。 在 stmts.xml 文件 中 采用 如 下 片段 来 配置 pro 
Action 。 

程序 清单 : codes\03\3.11\formTag\WEB-INF\src\struts.xml 
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<!-- 定义 名 为 pro 的 Action， 其 实现 类 为 lee.ProAction --> 


<action name="pro" class="org.crazyit.app.action.ProAction"> 
<!- 使 用 系统 默认 的 拦截 器 栈 --> 
<interceptor-ref name="defaultSstack"/> 
<!-- 使 用 防 刷新 的 token 拦截 器 一 > 
<interceptor-ref name="token"/> 
<!-- 定义 重复 提交 转向 的 视图 ， 该 逻辑 视图 名 必须 是 invalid. token --> 
<result name="invalid.token">/refresh.jsp</result> 
<!-- 如 果 处 理 结果 返回 success， 对 应 /show.jsp 视图 资源 --> 
<result name="success">/show.jsp</result> 

</action> 


上 面 配置 文件 的 第 一 行 粗 体 字 代 码 启用 了 Struts 2 的 token 拦截 器 ， 第 二 行 粗 体 字 代码 则 为 
“invalid.token” 人 逻辑 视图 指定 了 物理 资源 ， 这 个 逻辑 视图 名 就 是 用 户 刷 新 页 面 后 系统 返回 的 逻辑 视图 
名 。 只 需 注意 如 上 2 个 步骤 (1. 页 面 中 加 toke 标签 ;2. 配 置 Action 时 启动 token 拦截 器 , 并 为 invalid.token 
逻辑 视图 指定 物理 资源 )， 该 Action 就 可 以 实现 防 刷新 功能 ， 如 果 用 户 通过 刷新 向 pro.action 提交 两 次 
请 求 ， 将 看 到 系统 自动 转 入 refresh.jsp 页 面 。 


EE 


上 面 配置 文件 中 使 用 了 2 个 拦截 器 ,其 中 defaultStack 是 系统 默认 的 拦截 器 栈 . 看 似 | 
前 面 Struts 2 应 用 都 没有 使 用 该 拦截 器 ， 实 际 上 该 拦截 器 默认 会 生效 ， 此 处 因为 显 式 使 | 
用 了 token 拦截 器 ， 所 以 必须 显 式 配置 使 用 defaultStack 拦截 器 ， 否 则 它 不 会 默认 生效 ， | 
关于 拦截 器 介绍 请 看 下 一 章 内 容 。 另 :如 果 表单 页 没有 使 用 <s:token/> 标 签 ， 则 千 万 不 要 < 
器 ， 否 则 它 将 导致 无 法 提交 表单 。 3 


10. updownselect 标签 

updownselect 标签 的 用 法 非常 类 似 于 select 标签 的 用 法 ， 区 别 是 该 标签 生成 的 列表 框 可 以 上 下 移 
动 选项 。 因 此 使 用 该 标签 时 ， 一 样 可 以 指定 list、listKey 和 listValue 等 属性 ， 这 些 属性 的 作用 与 使 用 
select 标签 时 指定 的 list、listKey 和 listValue 等 属性 完全 相同 。 

除 此 之 外 ， 它 还 支持 如 下 几 个 属性 。 

> allowMoveUp: 是 否 显 示 “ 上 移 ” 按 钮 ， 默 认 是 true。 
allowMoveDown: 是 否 显示 “下 移 ” 按 钮 ， 默 认 是 true。 
allowSelectAll 是 否 显 示 “ 全 选 ”按钮 ， 默 认 是 true。 
moveUpLabel: 设置 “上 移 ” 按 钮 上 的 文本 ， 默 认 是 ^ 符 号 。 
moveDownLabel: 设置 “下 移 ” 按钮 上 的 文本 ， 默 认 是 v 符 号 。 
selectAllLabel: 设置 “全 选 ” 按 钮 上 的 文本 ， 默 认 是 * 符 号 。 

下 面 是 使 用 updownselect 标签 的 示例 ， 本 示例 中 分 别 使 用 了 简单 集合 、 简 单 Map 对 象 、 集 合 里 封 
装 Person 实例 来 创建 下 拉 列 表 框 的 选项 ， 并 且 分 别 指定 了 moveUpLabel 、moveDownLabel 和 
selectAllLabel 属性 ， 改 变 三 个 按钮 上 的 文本 。 

下 面 的 页 面 使 用 updownselect 标签 定义 了 三 个 列表 框 ， 代 码 如 下 。 

程序 清单 : codes\033.11\formTag\s-updownselect.jsp 


<s:form> 

<!-~ 使 用 简单 集合 来 生成 可 上 下 移动 选项 的 下 拉 选 择 框 --> 

<s:updownselect name="a”1abel=" 请 选择 您 喜欢 的 图 书 " 
labelposition="top" 


vvvyv 


mp 


实战 
， “经典 Java EE 企业 应 用 实战 ' }"/> 
<!-- 使 用 简单 Map 对 象 来 生成 可 上 下 移动 选项 的 下 拉 选 择 杠 
且 使 用 emptyoption="true" 增 加 一 个 空 选项 --> 


269 


http://52pdf.taobao.com 
蒋 旺 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


<s:updownselect name="b"” label=" 请 选择 您 想 选择 出 版 日 期 " 
labelposition="top" 
moveDownLabel=" 向 下 移动 " 
list="#{' 首 狂 Java 讲义 ': '2008 年 9 月 ' 
，' 轻 量 级 Java EE 企业 应 用 实 底 ' :'2008 月 12 月 " 
，' 经 典 Java EE 企业 应 用 实战 ' : '2010 年 5 月 ')" 
listKey="key" 
emptyOption="true" 


listValue="value"/> 
<s:bean name="org.crazyit.app.service.BookService" id="bs"/> 
<!-- 使 用 集合 里 放 多 个 JavaBean 实例 来 可 上 下 移动 选项 的 生成 下 拉 选 择 框 -> 
<s:updownselect name="c" 1abel=" 请 选择 您 喜欢 的 图 书 的 作者 ” 
labelposition="top” selectAllLabel=" 全 部 选择 ”multiple="true" 
list="#bs.books" 
listKey="author" 
listValue="name"/> 
</s:form> 


在 浏览 器 中 浏览 该 页 面 ， 将 看 到 如 图 3.61 所 示 的 页 面 。 


使 用 s:updownselect 生 成 可 上 下 移动 选项 的 下 拉 选 择 杠 
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图 3.61 使 用 updownselect 生成 可 移动 选项 的 下 拉 列 表 框 


从 如 图 3.61 所 示 的 页 面 中 可 以 看 到 ， 我 们 可 以 通过 列表 框 下 面 的 按钮 来 上 下 移动 列表 框 中 选项 。 
在 第 二 个 列表 框 中 ， 可 以 看 到 有 一 个 空 选项 ， 这 是 因为 指定 了 emptyOption="true" 属 性 ， 因 此 会 为 该 列 
表 框 增加 一 个 空 选 项 。 


>>3.11.12 非 表 单 标签 


非 表 单 标签 主要 用 于 在 页 面 中 生成 一 些 非 表单 的 可 视 化 元 素 , 例如 Tab 页 面 、 输 出 HTML 页 面 的 
树 形 结构 等 。 当然 , 非 表 单 标签 也 包含 在 页 面 中 显示 Action 里 封装 的 信息 。 非 表 单 标签 主要 有 如 下 几 个 。 

> actionerror: 如 果 Action 实例 的 getActionErrors() 方 法 返回 不 为 null， 则 该 标签 负责 输出 该 
方法 返回 的 系列 错误 。 

> actionmessage: 如 果 Action 实例 的 getActionMessages() 方 法 返回 不 为 null, 则 该 标签 负责 
输出 该 方法 返回 的 系列 消息 。 

> ”component: 使 用 此 标签 可 以 生成 一 个 自 定义 组 件 。 

> “fielderror: 如 果 Action 实例 存在 表单 域 的 类 型 转换 错误 、 校 验 错误 ， 该 标签 则 负责 输出 这 些 
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上 面 标签 中 的 fielderror 将 会 在 类 型 转换 、 数 据 校 验 部 分 有 更 详细 介绍 ， 此 处 不 再 蒙 述 。 这 里 仅 介 
绍 其 余 的 几 个 标签 。 

1，actionerror 和 actionmessage 标签 

actionerror 和 actionmessage 这 两 个 标签 用 法 完全 一 样 , 作用 也 几乎 完全 一 样 , 都 是 负责 输出 Action 
实例 里 封装 的 信息 ; 区 别 是 actionerror 标签 负责 输出 Action 实例 的 getActionErrors0 方 法 的 返回 值 , 而 
actionmessage 标签 负责 输出 Action 实例 的 getActionMessages() 方 法 的 返回 值 。 

对 于 这 两 个 标签 而 言 ， 几 乎 没有 自己 的 专 有 属性 ， 故 使 用 起 来 非常 简单 。 

下 面 是 本 示例 应 用 中 的 Action 类 ， 这 个 Action 类 仅仅 添加 了 两 条 ActionError 和 ActionMessage， 
并 没有 做 过 多 处 理 。 

程序 清单 : codes\03\3.11\non-formTag\WEB-INF\src\org\crazyit\app\action\DemoAction.java 


public class DemoAction extends RctionSupport 


{ 
public String execute() 


{ 
// 添 加 两 条 Error 信息 
addActionError ("第 一 条 错误 消息 ! “) 7 
addActionError ("第 二 条 错误 消息 ! ") ; 
// 添 加 两 条 普通 信息 
addActionMessage (" 第 一 条 普通 消息 ! ") ; 
addActionMessage ("第 二 条 普通 消息 ! ") ; 
return SUCCESS; 

} 

} 


上 面 的 Action 的 execute 方法 仅仅 在 添加 了 4 条 消息 后 ， 直 接 返 回 success 字符 串 ，success 字符 
串 对 应 的 JSP 页 面 中 使 用 <s:actionerror/> 和 <s:actionmessage/> 来 输出 ActionError 和 ActionMessage 信 
息 。 下 面 是 该 JSP 页 面 中 使 用 这 两 个 标签 的 示例 代码 。 


<!-- 输出 gethctionError() 方 法 返回 值 --> 
<s:actionerror/> 

<!-- 输出 getActionMessage() 方 法 返回 值 --> 
<a:actionmessage /> 


在 另 一 个 页 面 中 使 用 <s:action .…/> 标 签 来 调用 上 面 的 Action， 调 用 Action 的 标签 代码 片段 如 下 : 
<s:action name="demo" executeResult="true"/> 
从 上 面 的 <s:action … 亿 标签 中 可 以 看 出 ， 上 面 代码 将 demoAction 的 处 理 结果 包含 到 本 页 面 中 来 。 
在 浏览 器 中 浏览 该 页 面 ,或 者 直接 向 demo.action 发 送 请 求 , 都 可 看 到 页 面 中 显示 了 Action 里 actionError 
和 actionMessage 信息 。 
2. component 标签 
component 标签 可 用 于 创建 自 定义 视图 组 件 ， 这 是 一 个 非常 灵活 的 用 法 。 如 果 开发 者 经 常 需要 使 
用 某 个 效果 片段 ， 就 可 以 考虑 将 这 个 效果 片段 定义 成 一 个 视图 组 件 ， 然 后 在 页 面 中 使 用 component 标 
签 来 使 用 该 自 定 义 组 件 。 
因为 使 用 自 定义 组 件 还 是 基于 主题 、 模板 管理 的 , 因此 在 使 用 component 标签 时 , 可 以 指定 如 下 三 个 属性 。 
> theme: 自 定义 组 件 所 使 用 的 主题 ， 如 果 不 指定 该 属性 ， 则 默认 使 用 xhtml 主题 。 
> templateDir: 指定 自 定义 组 件 的 主题 目录 ， 如 果 不 指 定 ， 则 默认 使 用 系统 的 主题 目录 ， 即 
template 目录 。 
> template: 指定 自 定义 组 件 所 使 用 的 模板 。 
除 此 之 外 ， 还 可 以 在 cmponent 标签 内 使 用 param 子 标签 ， 子 标签 表示 向 该 标签 模板 中 传 入 额外 的 参 
数 。 如 果 希 望 在 模板 中 取得 该 参数 , 总 是 采用 : Sparameters.paramName 或 者 Sparameters[paramName'] 形 式 。 
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-三 - 注意: … 
自 定义 的 模板 文件 可 以 采用 FreeMarker、JSP 和 Velocity 三 种 技术 来 书写 . 


如 下 JSP 页 面 多 次 通过 <s:component .人 > 标签 来 使 用 自 定义 组 件 。 下 面 是 该 页 面 使 用 


<s:component .人 > 标 签 的 代码 片段 。 
程序 清单 : codes\03W3.11\non-formTag\s-component.jsp 


<h3> 使 用 s:component 标签 </h3> 

使 用 默认 主题 (xhtml) ， 默 认 主题 目录 (template) <br/> 

使 用 mytemplate.jsp 作为 视图 组 件 

<s:component template="mytemplate. jsp"> 
<s:param name="list"” value="{' 托 狂 Java 讲义 ' 
,，' 轻 最 级 Java EE 企业 应 用 实战 ' 
,，' 经 典 Java EE 企业 应 用 实战 "}"/> 

</s:component> 

<hr/> 

使 用 自 定义 主题 ， 自 定义 主题 目录 <br/> 

使 用 myAnotherTemplate.jsp 作为 视图 组 件 


<s:component 


template="myAnotherTemplate .jsp"> 
<s:param name="list" value="{' 狐 狂 Java 讲义 ' 
，' 轻 量 级 Java EE 企业 应 用 实战 ' 
1，' 经 典 Java EE 企业 应 用 实战 '}” /> 
</s:component> 
上 面 的 页 面 中 通过 component 标签 插入 了 两 个 页 面 组 件 ， 从 上 面 粗 体 字 代 码 中 可 以 看 出 ， 第 一 个 
component 标签 将 输出 myteamplate.jsp 页 面 内 容 ， 因 为 标签 没有 指定 templateDir 和 theme 属性 ， 将 从 
默认 路 径 下 加 载 mytemplate.jsp 模板 ; 第 二 个 component 标签 将 输出 myAnotherTemplate.jsp 页 面 内 容 ， 
并 从 ${TemplateDir}\${theme} 路 径 下 加 载 该 页 面 模板 。 
第 一 个 页 面 模板 myteamplate.jsp 位 于 template/xhtml 路 径 下 ， 文 件 内 容 如 下 。 
程序 清单 : codes\03\3.11\non-formTag\templatexhtml\myteamplate.jsp 
<%@ page contentType="text/html; charset=GBK" language="java"$> 
<%@taglib prefix="s" uri="/struts-tags" $> 
<div style="background-color:#eeeeee;"> 
<b>JsP 自 定义 模板 <br> 
请 选择 您 喜欢 的 图 书 <br></b> 
<s:select 1ist="Paramaters.Iistn/> 
</div> 


第 二 个 页 面 模板 myAnotherTemplatejsp 位 于 myTemplateDirmyTheme 路 径 下 ， 文 件 内 容 如 下 。 
程序 清单 :codes\03\3.11\non-formTag\myTemplateDirmyTheme\myAnotherTemplate.jsp 


<%@ page contentType="text/html; charset=GBK" language="java"$> 
<%@taglib prefix="s" uri="/struts-tags" $> 

<div style="background-color:#bbbbbb;"> 

JSP 自 定义 模板 <br> 

请 选择 您 喜欢 的 图 书 <br> 

<aelect> 


<a:iterator value="${top.parameters.1ist}"> 


</div> 

这 两 个 页 面 要 实现 的 效果 完全 相同 ,但 myAnotherTemplatejsp 页 面 需 要 手动 兴 代 集合 ， 并 利用 这 
些 集合 元 素来 创建 列表 框 的 选项 ， 而 前 一 个 页 面 则 直接 使 用 select 标签 来 将 集合 元 素 转换 成 列表 框 的 
列表 项 。 
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当 使 用 Struts 2.0 时 ， 即 使 我 们 自行 指定 了 templateDir、theme 属性 ( 即 从 自 定义 路 
径 下 加 载 视图 模板 ), 一 样 可 以 在 自 定义 视图 模板 中 使 用 select 等 UI 标签 ;但 在 Struts2.1 | 
中 ， 如 果 指定 了 templateDir、theme 属性 后 ， 系 统 将 不 再 从 默认 的 模板 目录 下 加 载 视图 本 


模板 ， 这 就 导 至 无 法 在 自 定义 视图 模板 中 使 用 select 等 UI 标签. 


使 用 s:component 标 签 
RV heey, BR eelere) 


使 用 mytenplate. jap 作 为 视图 
到 
[EJ ER 


使 用 自 定义 主题 ， 自 定义 主题 目录 
ec Tele | 


图 3.62 使 用 scomponent 标签 输出 视图 组 件 


从 图 3.62 中 可 以 看 出 ， 我 们 只 在 JSP 页 面 中 使 用 了 简单 的 <s:component .… 记 标签 ， 而 页 面 上 可 以 
生成 大 量 内 容 ， 这 都 是 因为 模板 的 作用 。 


3.12 ”本 章 小 结 


相对 于 Strutsl 而 言 , Struts 2 的 功能 更 加 强大 , 提供 了 更 多 组 件 化 开发 、 模块 化 开发 方式 , 但 Struts 
2 也 更 加 庞大 、 复杂。 本 章 详细 介绍 了 Struts 2 的 相关 知识 ， 本章 从 MVC 思想 讲 起 ， 大 致 介绍 了 MVC 
各 组 件 之 间 的 调用 关系 及 MVC 方式 的 优势 。 本 章 详细 介绍 了 Struts 2 框架 的 基本 功能 ， 包 括 为 Web 
应 用 增加 Struts 2 支持 ， 在 Eclipse 工具 中 开发 Struts 2 应 用 等 。 

本 章 详细 介绍 了 Struts 应 用 的 运行 流程 和 开发 流程 ， 详 细 讲 解 了 如 何 定义 Action 处 理 类 ， 以 及 如 
何在 Action 中 访问 Servlet API。 并 详细 讲解 了 struts.xmls 文件 中 的 常量 配置 、 命 名 空间 配置 、Action 
配置 和 结果 映射 配置 等 。 本 章 还 通过 示例 介绍 了 Struts 2 Convention 插件 的 “约定 ”支持 。 本 章 最 后 介 
绍 了 Struts 2 的 国际 化 支持 和 标签 库 。Struts 2.2 标签 库 和 Struts 2.0 标签 库 有 一 定 差异 ， 有 Struts 2.0 使 
用 经 验 的 读者 务必 要 注意 。 
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本 章 要 点 


和 理解 类 型 转换 器 对 MVC 框架 的 意义 
各 Struts 2 内 建 的 类 型 转换 器 

各 开发 自 定义 类 型 转换 器 

苗 类 型 转换 中 的 错误 处 理 

尝 输 入 校 验 对 MVC kn 


节 Stmuts 2 支持 的 文件 上 传 

节 使 用 拦 蕉 器 过 滤 文件 类 型 ri 
节理 解 stream 的 结果 类 型 Wt : 
他 使 用 stream 结果 类 型 实现 文件 下 载 入 
节理 解 拦截 器 对 Struts 2 框架 的 意义 

3aStmuts 2 内 建 的 拦截 器 

和 配置 拦截 器 

和 配置 拦截 器 栈 

他 开 发 用 户 自 定 义 的 拦截 器 

3aStmuts 2 的 Ajax 支持 

节 使 用 JSON 插件 进行 Ajax 交互 

节 配 置 文件 下 载 的 Action 
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上 一 章 已 经 介绍 了 Struts 2 框架 的 基本 知识 , 包括 Struts 2 框架 的 核心 知识 、 常规 配 置 、Convention 
插件 提供 的 约定 支持 、 异 常 配置 、 国 际 化 和 标签 库 内 容 ， 这 些 内 容 也 是 所 有 MVC 框架 都 应 提供 的 基 
本 功能 。 

与 所 有 MVC 框架 类 似 , Struts 2 也 提供 了 类 型 转换 和 输入 校 验 支持 ，Struts 2 提供 了 非常 强大 的 类 
型 转换 支持 ， 它 既 提供 了 大 量 内 建 类 型 转换 器 ， 用 以 满足 常规 的 Web 开发 ; 也 允许 开发 者 实现 自己 的 
类 型 转换 器 ，Struts 2 提供 了 非常 强大 的 输入 校 验 功能 ， 开 发 者 既 可 通过 XML 文件 来 配置 检验 规则 ， 
也 可 通过 重 写 validate( 方 法 来 进行 更 复杂 的 校 验 。 

本 章 将 详细 介绍 Struts 2 的 拦截 器 机 制 ， 拦 截 器 是 Struts 2 框架 的 灵魂 ， 拦 截 器 完成 了 Struts 2 框 
架 的 绝 大 部 分 功能 ， 本 章 不 会 详细 介绍 Struts 2 内 建 拦截 器 的 功能 一 一 因为 这 属于 开发 Struts 2 框架 的 
知识 。 本 章 主要 介绍 如 何 开发 、 配 置 自己 的 拦截 器 ， 以 及 配置 和 使 用 拦截 器 链 。 本 书 最 后 一 章 示范 了 
如 何 利用 拦截 器 进行 权限 控制 。 

Struts 2 致力 于 成 为 一 个 完备 的 MVC 框架, 因此 期 望 整合 完备 的 Ajax 支持 一 一 Struts 2 整合 了 Dojo 
库 ， 但 Dojo 库 庞 大 而 且 版 本 不 稳定 ， 从 而 导致 Struts 2 的 Ajax 支持 也 不 太 稳定 。 本 书 将 会 介绍 Struts 
2 的 另 一 种 Ajax 支持 : 利用 JSON 插件 实现 Ajax 交互 。 

Struts 2 框架 还 提供 了 简单 、 易 用 的 上 传 、 下 载 支持 ， 这 也 是 本 章 所 要 介绍 的 知识 。 


4.1 详解 Struts 2 的 类 型 转换 


所 有 的 MVC 框架 ， 都 需要 负责 解析 HTTP 请 求 参数 ， 并 将 请 求 参 数 传 给 控制 器 组 件 。 此 时 问题 
出 现 了 : HTTP 请 求 参数 都 是 字符 串 类 型 ， 但 Java 是 强 类 型 的 语言 ， 因 此 MVC 框架 必须 将 这 些 字符 
串 参数 转换 成 相应 的 数据 类 型 一 这 个 工作 是 所 有 的 MVC 框架 都 应 该 提供 的 功能 。 

表现 层 数据 的 流向 以 及 所 需 的 类 型 转换 如 图 4.1 所 示 。 


图 4.1 ”表现 层 数据 的 流向 和 类 型 转换 


Struts 2 提供 了 非常 强大 的 类 型 转换 机 制 ，Struts 2 的 类 型 转换 可 以 基于 OGNL 表达 式 ， 只 要 我 们 
把 HTTP 参数 〈 表 单元 素 和 其 他 GET/POST 的 参数 ) 命名 为 合法 的 OGNL 表达 式 ， 就 可 以 充分 利用 
Struts 2 的 类 型 转换 机 制 。 

除 此 之 外 ，Struts 2 提供 了 很 好 的 扩展 性 ， 开 发 者 可 以 非常 简单 地 开发 出 自己 的 类 型 转换 器 ， 完 成 
字符 串 和 自 定义 复合 类 型 之 间 的 转换 〔 例 如， 完成 字符 串 到 Person 实例 的 转换 )， 如 果 类 型 转换 中 出 
现 未 知 异 常 ， 类 型 转换 器 开发 者 无 须 关 心 异常 处 理 逻 辑 ，Struts 2 的 conversionError 拦截 器 会 自动 处 理 
该 异常 并且 在 页 面 上 生成 提示 信息 。 总 之 ，Struts 2 的 类 型 转换 器 提供 了 非常 强大 的 表现 层 数据 处 理 
机 制 ， 开 发 者 可 以 利用 Struts 2 的 类 型 转换 机 制 来 完成 任意 的 类 型 转换 。 

表现 层 另 一 个 数据 处 理 是 数据 校 验 ， 数 据 校 验 可 分 为 客户 端 校 验 和 服务 器 端 校 验 两 种 。 客 户 端 校 
验 和 服务 器 端 校 验 都 是 必 不 可 少 的， 二 者 分 别 完成 不 同 的 过 滤 。 

客户 端 校 验 进 行 基本 校 验 ， 如 检验 非 空 字段 是 否 为 空 ， 数 字 格 式 是 否 正确 等 。 客 户 端 校 验 主要 用 
来 过 滤 用 户 的 误 操作 。 客户 端 校 验 的 作用 是 : 拒绝 误 操作 输入 提交 到 服务 器 处 理 ， 降 低 服 务 器 端 负担 。 

服务 器 端 校 验 也 必 不 可 少 ， 服 务 器 端 校 验 防止 非法 数据 进入 程序 ， 导 致 程序 异常 、 底 层 数据 库 异 
常 。 服 务 器 端 校 验 是 保证 程序 有 效 运行 及 数据 完整 的 手段 。 

下 一 节 将 会 详细 介绍 输入 校 验 的 知识 。 
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>>4.1.1 Struts 2 内 建 的 类 型 转换 儒 


对 于 大 部 分 的 常用 类 型 ， 开 发 者 无 须 理会 类 型 转换 ，Struts 2 可 以 完成 大 多 数 常用 的 类 型 转换 。 这 
些 常用 的 类 型 转换 是 通过 Struts 2 内 建 的 类 型 转换 器 完成 的 ，Struts 2 已 经 内 建 了 字符 串 类 型 和 如 下 类 
型 之 间 相 互 转换 的 转换 器 。 


> 


vv 


注意 :w  … 


boolean 和 Boolean: 完成 字符 串 和 布尔 值 之 间 的 转换 。 

char 和 Character: 完成 字符 串 和 字符 之 间 的 转换 。 

int 和 Integer: 完成 字符 串 和 整 型 值 之 间 的 转换 。 

long 和 Long: 完成 字符 串 和 长 整 型 值 之 间 的 转换 。 

float 和 Float: 完成 字符 串 和 单 精度 浮 点 值 之 间 的 转换 。 

double 和 Double: 完成 字符 串 和 双 精 度 浮 点 值 之 间 的 转换 。 

Date， 完 成 字符 串 和 日 期 类 型 之 间 的 转换 ， 日 期 格式 使 用 用 户 请 求 所 在 Locale 的 SHORT 
格式 。 

数组 ， 在 默认 情况 下 ， 数 组 元 素 是 字符 串 ， 如 果 用 户 提供 了 自 定义 类 型 转换 器 ， 也 可 以 是 其 
他 复合 类 型 的 数组 。 

集合 : 在 默认 情况 下 ， 假 定 集合 元 素 类 型 为 String， 并 创建 一 个 新 的 ArrayList 封装 所 有 的 字 
人 


对 于 数组 的 类 型 转换 将 按照 效 组 元 素 的 类 型 来 单 儿 转 换 每 一 个 元 素 ， 但 如 果 数组 元 


素 的 类 型 转换 本 身 无 法 完成 ， 系 统 将 出 现 类 型 转换 错误 . 


因为 Struts 2 提供 了 些 类 型 转换 器 ， 如 果 需 要 把 HTTP 请 求 参数 转换 成 上 面 这 


无 须 开发 者 进行 任何 特殊 的 处 理 。 因 此 大 部 分 实际 开发 中 ， 开 发 人 员 无 须 自己 进行 类 型 转换 。 
>>4.1.2 基于 OGNL 的 类 型 转换 


殿 助 于 内 置 的 类 型 转换 器 ，Struts 2 可 以 完成 字符 串 和 基本 类 型 之 间 的 类 型 转换 。 除 此 之 外 ， 借 助 
于 OGNL 表达 式 的 支持 ，Struts 2 允许 以 另 一 种 简单 方式 将 请 求 参数 转换 成 复合 类 型 。 系 统 的 Action 
类 代码 片段 如 下 。 
程序 清单 :codes\04\4.1\ognlConvert\WEB-INF\src\org\crazyitapp\domain\LoginAction.java 
es class LoginAction implements Action 
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Private User user; 
Private String tip; 
省略 再 个 属性 的 setter 和 getter 方法 


public String execute() throws Exception 


{ 
// 通 过 user 属性 的 name 属性 和 pass 属性 来 判断 控制 逻辑 
if (getUser().getName().equals("crazyit.org") 
&5& getUser() .getPass() .equals("leegang") ) 


setTip ("转换 成 功 ") ; 
return SUCCESS; 


{ 


else 


setTip ("转换 失败 ") 7 
return ERROR; 
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从 上 面 Action 的 粗 体 字 代 码 可 以 看 出 ， 该 Action 里 包含 了 一 个 User 类 型 的 属性 一 一 这 个 属性 需 
要 进行 类 型 转换 ，Struts 2 框架 接受 到 HTTP 请 求 参数 后 ， 需 要 将 这 些 请 求 参数 封装 成 User 对 象 。 

但 Struts 2 提供 的 OGNL 表达 式 允 许 开发 者 无 须 任何 特殊 处 理 ,只 需要 在 定义 表单 域 时 使 用 OGNL 
表达 式 来 定义 表单 域 的 name 属性 。JSP 页 面 的 表单 代码 如 下 。 

程序 清单 : codes\044.1\ognlConvert\input.jsp 


<s:form action="login"> 


2 的 湖 玉 雪 委 各 罗 ye ere 
ld 


<td colspan="2"><s:submit value=" 转 换 ”theme="simple"/> 
<s:reset value=" 重 填 "”theme="simple"/></td> 
</tr> 
</s:form> 
上 面 的 表单 定义 中 粗 体 字 代码 定义 了 两 个 单行 文本 框 ， 对 应 两 个 请 求 参数 ， 请 求 参 数 名 并 不 是 普 


2 会 把 username 


参数 的 值 赋值 给 Action 实例 的 user 属性 的 name 属性 ， 并 将 userpass 参数 的 值 赋值 给 Action 实例 的 


user 属性 的 pass 属性 。 
通过 这 种 方式 ，Struts 2 可 以 将 普通 请 求 参数 转换 成 复合 类 型 对 象 , 但 在 使 用 这 种 方式 时 有 如 下 几 
点 需要 注意 : 
> ”因为 Struts 2 将 通过 反射 来 创建 一 个 复合 类 (User 类 ) 的 实例 ， 因 此 系统 必须 为 该 复合 类 提 
供 无 参数 的 构造 器 。 


> ”如 果 希 望 使 用 user.name 请 求 参 数 的 形式 为 Action 实例 的 user 属性 的 name 属性 赋值 ， 则 
必须 为 user 属性 对 应 的 复合 类 〈User 类 ) 提供 setName() 方 法 ， 因 为 Struts 2 是 通过 调用 
该 方法 来 为 该 属性 赋值 的 。 当 然 Action 类 中 还 应 该 包含 getUser() 方 法 。 
更 极端 的 情况 是 ， 我 们 甚至 可 以 直接 生成 Collection， 或 者 Map 实例 。 看 如 下 的 Action 类 片段 。 
程序 清单 : codes\04\4.1\ognlObjectMap\WEB-INF\src\org\crazyit\app\action\LoginAction.java 
public class LoginAction implements Action 
{ 
//Action 类 里 包含 一 个 Map 类 型 的 参数 
//Map 的 value 类 型 为 User 类 型 
private Map<string, User> users; 
private String tip; 
//users 属性 的 setter 和 getter 方法 
Public void setUsers (Map<string , User> users) 


{ 
this.users = users; » an 


pds Map<string, User> getUsers() et 
return this.users; 
7 外 tip 属性 的 setter 和 getter 方法 
Pablie String execute() throws Exception 
, // 在 控制 台 输出 Struts 2 封装 产生 的 List 对 象 
System-out .printlnfgetUsers())7 


// 根 据 Map 集合 中 key 为 cne 的 User 实例 来 决定 控制 逻辑 
if (getUsers() .get("one") .getName() .equals ("crazyit.org") 
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56 getUsers() .get("one") .getPass() .equals ("leegang") ) 


setTip(" 登 录 成 功 ! ") 7 
return SUCCESS; 


setTip(" 登 录 失败 !! ") ; 
return ERROR; 


上 面 Action 的 粗 体 字 代码 部 分 定义 了 一 个 users 属性 ， 该 属性 的 类 型 为 Map<String , User>， 只 要 

我 们 在 定义 表单 域 的 name 属性 时 使 用 OGNL 表达 式 语法 , Struts 2 一 样 可 以 将 请 求 参数 直接 封装 成 这 
种 users 属性 。 例 如 如 下 表单 定义 代码 。 

程序 清单 : codes\04\4.1\ognlObjectMap\input.jsp 

<s:form action="login"> 
label=" 第 one 个 用 户 名 "/> 
label=" 第 one 个 密码 "/> 
<a: textfield name="users['two'] .name" label=" 第 two 个 用 户 名 "/> 
<a:textfield name="users['two!] .pass” label=" 第 two 个 密码 "/> 
<tr> 


<td colspan="2"><s:submit value=" 转 换 " theme="simple"/> 
<s:reset value=" 重 填 "theme="simple"/></td> 
</tr> 二 
</s:form> 
上 面 的 粗 体 字 代 码 示 范 了 如 何 利 用 OGNL 表达 式 来 定义 表单 域 的 name 属性 : 将 表单 域 的 name 
属性 设置 为 “Action 属性 名 [key 值 ]. 属 性 名 ”的 形式 ， 其 中 “Action 属性 名 ”是 Action 类 里 包含 的 
Map 类 型 属性 ， 后 一 个 属性 名 则 是 Map 对 象 里 复合 类 型 对 象 的 属性 名 。 通 过 这 种 方式 ，Struts 2 可 以 
将 HTTP 请 求 参 数 转 换 成 Map 属性 。 
类 似 地 ， 如 果 我 们 需要 访问 Action 的 Map 类 型 的 属性 ， 也 可 以 使 用 OGNL 表达 式 ， 如 下 面 的 代 
码 所 示 : 
key 为 one 的 用 户 名 为 :<s:Property value="users['one'] .name"/><br/> 
key 为 one 的 密码 为 ，<s :Property value="users['one'] .pass"/><br/> 
key 为 two 的 用 户 名 为 :<s:property value="users['two'] .name"/><br/> 
key 为 two 的 密码 为 :<s:property value="users['two'] .pass"/><br/> 
如 果 把 LoginAction 中 的 users 属性 改 为 List<User>， 也 就 是 如 果 需 要 Struts 2 将 用 户 请 求 参数 封 
装 成 List 属性 ， 一 样 可 以 利用 OGNL 表达 式 做 到 一 一 我 们 通过 索引 来 指定 要 将 请 求 参数 转换 成 List 
的 哪个 元 素 。 下 面 的 JSP 页 面 里 的 表单 元 素 的 name 属性 可 实现 将 HTTP 请 求 参数 转换 成 List 属性 。 
程序 清单 :codes\04\4.1\ognlObjectList\inputjsp 
<s:form action="login"> 
<s:textfield name="users[0] .name" label=" 第 一 个 用 户 名 "/> 
<s:textfield name="users[0] .pass" label=" 第 一 个 密码 "/> 
<s:textfield name="users[1] .name" label=" 第 二 个 用 户 名 "/> 
<s:textfield name="users[1] .pass" label=" 第 二 个 密码 "/> 
<tr> 
a colspan="2"><s:submit value=" 转 换 ”theme="simple"/> 
<s:reset value=" 重 填 ”theme="simple”/></td> 
</tr> 
</s:form> 
上 面 的 JSP 页 面 中 定义 表单 域 时 指定 第 一 个 文本 域 的 name 为 users[0].name，Struts 2 将 会 把 该 文 
本 域 所 代表 的 请 求 参数 转换 成 users 集合 第 一 个 元 素 的 name 属性 。 
类 似 地 ， 如 果 想 输 出 Action 中 List 属性 里 各 集合 元 素 的 属性 值 ， 则 可 通过 在 集合 属性 后 增加 索引 
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4 


来 访问 ， 如 下 面 的 代码 片段 所 示 : 


第 一 个 User 实例 的 用 户 名 为 :<s:property value="users[0] .name"/><br/> 
第 一 个 User 实例 的 密码 为 : <s :property value="users[0] .Pass"/><br/> 
第 二 个 User 实例 的 用 户 名 roperty value="users[1] .name"/><br/> 
第 二 个 User 实例 的 密码 为 : <s:property value="users[1] .pass"/><br/> 


> >4.2.3 ”指定 集合 元 素 的 类 型 


前 面 我 们 使 用 集合 时 都 使 用 了 泛 型 ， 这 种 泛 型 可 以 让 Struts 2 了 解 集合 元 素 的 类 型 ，Struts 2 就 可 
通过 反射 来 创建 对 应 类 的 对 象 ， 并 将 这 些 对 象 添加 到 List 中 。 
问题 是 ， 如 果 不 使 用 泛 型 ，Struts 2 还 知道 使 用 类 型 转换 器 来 处 理 该 users 属性 吗 ? Struts 2 当然 不 
知道 ! 但 Struts 2 允许 开发 者 通过 局 部 类 型 转换 文件 来 指定 集合 元 素 的 类 型 。 类 型 转换 文件 就 是 一 个 
普通 的 Properties 〈*.properties) 文件 ， 类 型 转换 文件 里 提供 了 类 型 转换 的 相关 配置 信息 。 
将 上 面 的 Action 类 代码 中 关于 users 属性 的 泛 型 定义 取消 ， 修 改 后 的 Action 类 代码 片段 如 下 。 
程序 清单 :codes\04\4.1\noGenericList\WEB-INF\src\org\crazyit\app\action\LoginAction.java 
public class LoginAction implements Action 
//Action 类 里 包含 一 个 List 类 型 的 参数 
//List 集合 元 素 为 User 类 型 
private List users; 
private String tip; 
//users 属性 的 setter 和 getter 方法 


public void setUsers(List users) 
by 


this.users = users; 
} 
public List getUsers() 
{ 

return this.users; 


} 
// 省 略 tip 属性 的 setter 和 getter 方法 
public String execute() throws Exception 


// 在 控制 台 输出 Struts 2 封装 产生 的 List 对 象 
System.out.println(getUsers())7 


// 因 为 没有 使 用 泛 型 ， 所 以 要 进行 强制 类 型 转换 

User firstUser = (User)getUsers().get(0); 

//users 属性 的 第 一 个 User 实例 来 决定 控制 逻辑 

if (firstUser.getNane() .equals ("crazyit.org") 
56 firstUser.getPass() .equals("leegang") ) 

{ 


setTip ("登录 成 功 ! "); 
return SUCCESS; 


setTip{" 登 录 失 败 1! "); 
return ERROR; 


} 
} 


如 果 仅 仅 通 过 上 面 Action 类 的 代码 ，Struts 2 无 法 知道 该 Action 的 users 属性 里 集合 元 素 的 类 型 ， 
所 以 我 们 要 通过 局 部 类 型 转换 文件 来 指定 集合 元 素 的 类 型 。 

局 部 类 型 转换 文件 的 文件 名 应 为 ActionName-conversion.properties 形式 ， 其 中 ActionName 是 需要 
Action 的 类 名 ， 后 面 的 -conversion.properties 字符 串 则 是 固定 部 分 。 类 型 转换 文件 应 该 放 在 和 Action 
类 文件 相同 的 位 置 ， 后 面 的 内 容 还 会 涉及 局 部 类 型 转换 文件 。 
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为 了 指定 List 集 合 里 元 素 的 数据 类 型 ， 需 要 指定 两 个 部 分 : 
> ”List 集合 属性 的 名 称 。 
> List 集合 里 元 素 的 类 型 。 
通过 在 局 部 类 型 转换 文件 中 指定 如 下 key-value 对 即 可 : 
Element_<ListPropName>=<ElementType> 
将 上 面 的 key-value 对 中 <ListPropName> 替 换 成 List 集合 属性 的 名 称 、<ElementType> 替 换 成 集合 
元 素 的 类 型 即 可 。 以 本 应 用 为 例 ， 我 们 定义 了 如 下 的 局 部 类 型 转换 文件 : 
Element_users=org.crazyit.app.domain.User 
增加 上 面 的 局 部 类 型 转换 文件 后 ， 系 统 将 可 以 识别 到 users 集合 属性 的 集合 元 素 是 org.crazyit.app. 
domain.User 类 型 ， 这 样 Struts 2 的 类 型 转换 器 又 可 以 正常 工作 了 。 
如 果 对 于 Map 类 型 的 属性 ， 则 需要 同时 指定 Map 的 key 类 型 和 value 类 型 。 为 了 指定 Map 类 型 
属性 的 key 类 型 ， 应 该 在 局 部 类 型 转换 文件 增加 如 下 项 ， 
Key_<MapPropName>=<KeyType> 
其 中 Key 是 固定 的 ，<MapPropName> 是 Map 类 型 属性 的 属性 名 ， 复 合 类 型 指定 的 是 Map 的 key 
值 的 全 限定 类 名 。 
为 了 指定 Map 属性 里 的 value 类 型 ， 应 该 在 局 部 类 型 转换 文件 中 增加 如 下 项 : 
Element_<MapPropName>=<ValueType> 
其 中 Element 是 固定 的 ，<MapPropName> 是 Map 类 型 属性 的 属性 名 ， 复 合 类 型 指定 的 是 Map 属 
性 的 value 类 型 的 全 限定 类 名 。 在 codes\04W4.1 路 径 下 的 noGenericMap 应 用 就 是 这 种 用 法 的 示例 。 


为 了 让 Struts 2 能 了 解 集合 属性 中 元 素 的 类 型 ， 可 以 使 用 如 下 两 种 方式 : 
性 通过 为 集合 属性 指定 泛 型 | 
| 性 通过 在 Action 的 局 部 类 型 转换 文件 中 指定 集合 元 素 类 型 。 j 


>>4.1.4 自 定义 类 型 转换 器 


大 部 分 时 候 ， 我 们 使 用 Struts 2 提供 的 类 型 转换 器 ， 以 及 基于 OGNL 的 类 型 转换 机 制 ， 就 能 满足 
大 部 分 类 型 转换 需求 。 但 在 有 些 特殊 的 情形 下 , 例如 需要 把 一 个 字符 串 转 换 成 一 个 复合 对 象 (例如 User 
对 象 ) 时 ， 这 就 需要 使 用 自 定 义 类 型 转换 器 。 例 如 ， 用 户 输入 一 个 abc,xyz 字符 串 ， 我 们 需要 将 其 转 
换 成 一 个 User 类 型 实例 ， 其 中 abc 作为 User 实例 的 name 属性 值 ， 而 xyz 作为 User 实例 的 pass 属 
性 值 。 

假设 本 系统 有 一 个 如 图 4.2 所 示 的 表单 输入 页 面 。 


图 4.2 输入 字符 串 的 页 面 


如 图 4.2 所 示 的 页 面包 含 一 个 名 为 user 的 表单 域 ， 这 将 产生 一 个 名 为 user 的 请 求 参数 ， 该 请 求 对 
应 的 Action 类 代码 如 下 。 
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程序 清单 : codes\04\4.1\LocalConverter\WEB- Ra es) java 


public class LoginAction implements Action 
{ 
private User user; 
private String tip; 
//user 属性 的 setter 和 getter 方法 
public void setUser (User user) 
{ 
this.user = user; 
1 
public User getUser() 
{ 
return this.user; 


} 
// 省 略 tip 属性 的 setter 和 getter 方法 
public String execute() throws Exception 


if (getUser() .getName() .equals ("crazyit.org") 
55 getUser() .getPass() .equals ("leegang") ) 


setTip(" 登 录 成 功 ! "); 
return SUCCESS; 


setTip ("登录 失败 1! ") ; 
return ERROR; 


从 上 面 的 代码 中 可 以 看 出 ， 该 Action 的 user 属性 是 User 类 型 ， 而 对 应 表单 页 发 送 的 user 请 求 参 
数 则 只 能 是 字符 串 类 型 。Struts 2 功能 虽然 强大 ， 但 它 依然 不 知道 如 何 完成 字符 串 和 User 对 象 之 间 的 

User 类 就 是 一 个 普通 的 JavaBean 类 ， 关 于 此 类 代码 读者 请 参考 光盘 中 的 程序 清单 : 
codes\04\4.1\LocalConverter\WEB-INF\src\org\crazyit\app\domain\User.java。 

Struts 2 的 类 型 转换 器 实际 上 依然 是 基于 OGNL 框架 的 ， 在 OGNL 项 目 中 有 一 个 TypeConverter 
接口 ， 这 个 接口 就 是 自 定义 类 型 转换 器 必须 实现 的 接口 。 该 接口 的 定义 代码 如 下 ; 


//OGNL 提供 的 类 型 转换 器 接口 
public interface TypeConverter 
{ 
public Object convertValue(Map context, Object target, 
Member member, String propertyName, Object value, Class toType); 
} 


实现 类 型 转换 器 必须 实现 上 面 的 TypeConverter， 不 过 上 面 接口 里 的 方法 太 过 复杂 ， 所 以 OGNL 
项 目 还 为 该 接口 提供 了 一 个 实现 类 : DefaultTypeConverter， 通 常 都 采用 扩展 该 类 来 实现 自 定义 类 型 转 
换 器 。 实 现 自 定义 类 型 转换 器 需要 重 写 DefaultTypeConverter 类 的 convertValue 方法 。 

下 面 是 本 应 用 所 使 用 的 类 型 转换 器 的 代码 。 


程序 清单 ，codes\04\4.1\LocalConverter\WEB- NPerdiorg oray tapp oonveriodiUierG onyerter java 
public class UserConverter extends DefaultTypeConverter 


// 类 型 转换 器 必须 重 写 convertValue 方法 ， 该 方法 需要 完成 双向 转换 
public Object convertValue (Map context 
, Object value, Class toType) 


// 当 需要 将 字符 串 向 U0ser 类 型 转换 时 
if (toType =— User.class ) 
{ 


{ 
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// 系 统 的 请 求 参数 是 一 个 字符 店 数 组 
String[] params = (String[])value; 
// 创 建 一 个 User 实例 


只 处 理 请 求 参数 数组 第 - 
// 并 将 该 字符 串 以 英文 逗号 分 割 成 两 个 字符 率 
String[] userValues = Params[0] .split(","); 
// 为 User 实例 赋值 
user.setName (userValues[0]); 
user. setPass (userValues [1]); 
// 返 回转 换 来 的 User 实例 
return user; 


else if (toType == String.class ) 


// 将 需要 转换 的 值 强制 类 型 转换 为 0ser 实例 

User user = (User) value; 

return "<" + user.getName() + "," 
+ user.getPass() + ">"; 


return null; 
} 
} 


上 面 的 程序 的 粗 体 字 代 码 是 实现 类 型 转换 的 关键 ， 第 一 段 粗 体 字 代 码 实 现 将 字符 串 转换 成 User 
对 象 , 第 二 段 粗 体 字 代 码 实现 将 User 对 象 转换 成 字符 串 。 读 者 可 能 对 上 面 实现 的 类 型 转换 器 感到 有 一 
些 迷 惑 ， 下 面 是 关于 上 面 的 类 型 转换 器 的 几 点 说 明 。 

1，convertValue 方法 的 作用 

convertValue 方法 的 作用 最 简单 ， 该 方法 负责 完成 类 型 的 转换 ， 不 过 这 种 转换 是 双向 的 ， 当 需要 把 
字符 串 转换 成 User 实例 时 ， 是 通过 该 方法 实现 的 ， 当 需要 把 User 实例 转换 成 字符 串 时 ， 也 是 通过 该 


方法 实现 的 。 
5 上 为 了 让 该 方法 实现 双向 转换 ， 我们 通过 判断 toType 的 类 型 即 可 判 
a 断 转 换 的 方向 。toType 类 型 是 需要 转换 的 目标 类 型 ， 当 toType 类 型 是 
& 和 User 类 型 时 ， 表 明 需 要 将 字符 串 转换 成 User 欠 当 toType 类 型 是 
~ String 类 型 时 ， 表 明 需 要 把 User 实例 转换 成 字符 串 类 型 。 图 4.8 显示 
wpoNsmro% “了 这 种 toType 参数 和 转换 方向 之 间 的 关系 。 
\E -是 通过 toType 类 型 判断 了 类 型 转换 的 方向 后 ， 我 们 就 可 以 分 别 
实现 两 个 方向 的 转换 逻辑 了 。 
图 43 toType 参数 和 转换 2. convertValue 方法 参数 和 返回 值 的 意义 
才情 罗 迪 和 通过 上 面 的 介绍 可 以 看 出 ， 实 现 类 型 转换 器 的 关键 就 是 实现 


convertValue 方法 ， 该 方法 有 如 下 三 个 参数 。 
> 第 一 个 参数 ，context 是 类 型 转换 环境 的 上 下 文 。 
> ”第 二 个 参数 : value 是 需要 转换 的 参数 。 随 着 转换 方向 的 不 同 , value 参数 的 值 也 是 不 一 样 的 ， 
当 把 字符 串 类 型 向 User 类 型 转换 时 ，value 是 原始 字符 串 数组 ， 当 需要 把 User 类 型 向 字符 
串 类 型 转换 时 ，value 是 User 实例 。 

> 第 三 个 参数 ，toType 是 转换 后 的 目标 类 型 ， 这 个 参数 前 面 已 经 介绍 了 。 

该 方法 的 返回 值 就 是 类 型 转换 后 的 值 ， 该 值 的 类 型 也 会 随 转换 方向 的 不 同 而 不 同 ， 当 把 字符 串 向 
User 类 型 转换 时 ， 返 回 值 类 型 就 是 User 类 型 ， 当 需要 把 User 类 型 向 字符 串 类 型 转换 时 ， 返 回 值 类 型 
就 是 字符 串 类 型 。 

由 此 可 见 ， 转 换 器 的 convertValue 方法 ， 接 收 需要 转换 的 值 ， 需 要 转换 的 目标 类 型 为 参数 ， 然 后 
返回 转换 后 的 目标 值 。 
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3. 当 把 字符 串 向 User 类 型 转换 时 ， 为 什么 value 是 一 个 字符 串 数组 ， 而 不 是 一 个 字符 串 

很 多 读者 会 感到 疑惑 : 当 我 们 需要 把 字符 串 转换 成 User 类 型 时 , 为 什么 value 的 值 是 字符 串 数组 ， 
而 不 是 一 个 字符 串 。 因 为 在 前 面 的 介绍 中 ， 我 们 总 是 说 浏览 器 发 送 的 请 求 参数 类 型 是 字符 串 ， 而 不 是 
字符 串 数组 。 

在 如 图 4.4 所 示 的 页 面 中 ， 姓 名 输入 框 的 值 只 能 是 一 个 普通 字符 串 。 但 选择 课程 的 列表 框 的 值 则 
可 以 同时 选择 多 个 值 。 因 此 ， 浏 览 者 向 服务 器 发 送 请 求 时 ， 该 下 拉 列 表 框 对 应 的 请 求 参 数 则 是 字符 串 
数组 。 


天 输入 筷 的 姓名 : 


' 
至 重奖 弹 程 ， _ 
E33 


巴 
图 4.4 包含 字符 串 数组 请 求 参数 的 表单 页 
对 于 DefaultTypeConverter 转换 器 而 言 $ 须 考虑 到 最 通用 的 情形 , 因此 它 把 所 有 的 请 求 参数 者 
视 为 字符 串 数组 ， 而 不 是 字符 串 。 对 字符 串 请 求 参数 而 言 〈 例 如 姓名 请 求 参 数 )， 转 换 器 把 该 请 求 参数 
值 当成 长 度 为 1 的 数组 。 


提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
Fg 可 以 认为 DefaultTypeConverter 是 通过 HttpServletRequest 的 getParameter Values(name) : 
方法 来 获取 请 求 参数 值 的。 因此 它 获 取 的 请 求 参数 总 是 字符 囊 数组 ， 如 果 请 求 参数 只 包含 

| 一 个 单个 的 值 ， 则 该 请 求 参 数 的 值 是 一 个 长 度 为 1 的 字符 囊 数组 . 


4.1.5 注册 类 型 转换 器 


仅仅 为 该 应 用 提供 类 型 转换 器 还 不 够 ， 因 为 Struts 2 依然 不 知道 何 时 使 用 这 些 类 型 转换 器 ， 所 以 
我 们 必须 将 类 型 转换 器 注册 在 Web 应 用 中 ，Struts 2 框架 才 可 以 正常 使 用 该 类 型 转换 器 。 

Struts 2 支持 如 下 三 种 注册 类 型 转换 器 的 方式 。 

> ”注册 局 部 类 型 转换 器 : 局 部 类 型 转换 器 仅仅 对 某 个 Action 的 属性 起 作用 。 

> ”注册 全 局 类 型 转换 器 全 局 类 型 转换 器 对 所 有 Action 的 特定 类 型 的 属性 都 会 生效 。 

> ”使 用 JDK 1.5 的 注释 来 注册 类 型 转换 器 : 通过 注释 方式 来 注册 类 型 转换 器 。 

1. 局 部 类 型 转换 器 

与 前 面 完 全 相似 的 是 ， 注 册 局 部 类 型 转换 器 使 用 局 部 类 型 转换 文件 指定 ， 只 要 在 局 部 类 型 转换 文 
件 中 增加 如 下 一 行 即 可 : 

<propName>=<ConverterClass> 

将 上 面 的 <propName> 蔡 换 成 需要 进行 类 型 转换 的 属性 、 -Converexclass> 葵 换 成 类 型 转换 器 的 上 

现 类 即 可 。 下 面 是 本 应 用 中 局 部 类 型 转换 文件 的 内 容 。 

程序 清单 : codes\04\4.1\LocalConverter\WEB-INF\src\org\crazyit\app\action\LoginAction-conversion. 

properties 


# 指 定 user 属性 需要 使 用 Userconverter 类 来 完成 类 型 转换 
user=org.crazyit.app.converter.UserConverter 
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至 此 ， 局 部 类 型 转换 器 注册 成 功 。 当 浏览 者 提交 请 求 时 ， 请 求 中 的 user 请 求 参数 将 被 该 类 型 转换 
器 处 理 ， 即 使 用 convertValue0 方 法 将 字符 串 转换 成 User 实例 。 

局 部 类 型 转换 器 只 对 指定 Action 的 特定 属性 起 作用 , 这 具有 很 大 的 局 限 性 一 一 我 们 花费 了 大 量 时 
间 完 成 了 一 个 类 型 转换 器 ， 却 只 能 一 次 使 用 〈 对 一 个 Action 有 效 )， 这 太 浪 费 了 。 通 常 我 们 会 将 类 型 
转换 器 注册 成 全 局 类 型 转换 器 ， 让 该 类 型 转换 器 对 该 类 型 的 所 有 属性 起 作用 。 

2. 全 局 类 型 转换 器 

局 部 类 型 转换 器 的 局 限 性 太 明 显 了 ， 它 只 能 对 指定 Action、 指 定 属性 起 作用 。 但 如 果 应 用 中 有 多 
个 Action 都 包含 了 User 类 型 的 属性 , 或 者 一 个 Action 中 包含 了 多 个 User 类 型 的 属性 ， 使 用 全 局 类 型 
转换 器 将 更 合适 。 

全 局 类 型 转换 器 不 是 对 指定 Action 的 指定 属性 起 作用 ， 而 是 对 指定 类 型 起 作用 ， 例 如 对 所 有 类 型 
为 org.crazyit.app.domain.User 类 型 的 属性 起 作用 。 

注册 全 局 类 型 转换 器 应 该 提供 一 个 xwork-conversion.properties 文件 ， 该 文件 也 是 Properties 文件 ， 
该 文件 就 是 全 局 类 型 转换 文件 ， 该 文件 直接 放 在 Web 应 用 的 WEB-INF/classes 路 径 下 即 可 。 

全 局 类 型 转换 文件 内 容 由 多 项 “<propType>=<ConvertClass>” 项 组 成 ， 将 <propType> 替 换 成 需要 
进行 类 型 转换 的 类 型 、 将 <ConvertClass> 替 换 成 类 型 转换 器 的 实现 类 即 可 。 

下 面 是 本 应 用 中 注册 全 局 类 型 转换 器 的 注册 文件 代码 。 

程序 清单 : codes\04\4.1\GlobalConverte\WEB-INF\srcxwork-conversion.properties 


4 指定 org.crazyit.app.domain.User 类 型 需要 
# 使 用 UserConverter 类 来 完成 类 型 转换 
org.crazyit.app.domain.User=org. crazyit.app.converter.UserConverter 


一 旦 注册 了 上 面 的 全 局 类 型 转换 器 ， 该 全 局 类 型 转换 器 就 会 对 所 有 类 型 为 lee.User 类 型 的 属性 起 
作用 。 关 于 使 用 全 局 类 型 转换 器 的 示例 ， 请 参考 codes\04W.1\ 路 径 下 的 GlobalConverter 应 用 。 

局 部 类 型 转换 器 只 对 指定 Action 的 指定 属性 生效 ,全 局 类 型 转换 器 对 指定 类 型 的 全 部 属性 起 作用 。 

3， 关于 局 部 类 型 转换 器 和 全 局 类 型 转换 器 的 说 明 

局 部 类 型 转换 器 是 对 指定 Action 的 指定 属性 进行 转换 ， 不 管 该 Action 的 该 属性 是 数组 也 好 ， 是 
List 集合 也 好 ， 该 转换 器 的 转换 方法 对 该 属性 只 转换 一 次 ;假如 某 个 Action 有 个 List<User> 类 型 的 属 
性 users， 那 么 局 部 类 型 转换 器 将 只 调用 一 次 convertValue0 方 法 ， 该 方法 把 users 请 求 参数 一 次 性 地 转 
换 为 一 个 List<User> 集 合 对 象 。 

全 局 类 型 转换 器 会 对 所 有 Action 的 特定 类 型 进行 转换 , 如 果 一 个 Action 的 某 个 属性 是 数组 或 集合 
属性 ， 而 数组 或 集合 元 素 是 需要 该 转换 器 转换 的 方法 ， 那 么 全 局 类 型 转换 将 不 是 对 该 集合 属性 整体 进 
行 转换 ， 而 是 对 该 集合 属性 的 每 个 元 素 进行 转换 。 


Fg 局 部 类 型 转换 器 对 指定 Action 的 指定 属性 起 作用 , 一 个 属性 只 调用 convertValue() 方 法 | 
一 次 。 全 局 类 型 转换 器 对 所 有 Action 的 特定 类 型 起 作用 ， 因 此 可 能 对 一 个 属性 多 次 调用 : 
| ”convert Value() 方 法 进行 转换 一 一 当 该 属性 是 一 个 数组 或 集合 时 ， 该 数组 或 集合 中 包含 几 个 ! 

该 类 型 的 元 素 ， 那 么 就 会 调用 convertValue() 方 法 几 次 。 


>>4.1.6 基于 Struts 2 的 自 定义 类 型 转换 器 
如 果 上 面 的 类 型 转换 器 都 是 基于 DefaultTypeConverter 类 实现 的 ， 基 于 该 类 实现 类 型 转换 器 时 ， 将 字 


符 串 转换 成 复合 类 型 要 通过 convertValue 方法 实现 ， 将 复合 类 型 转换 成 字符 串 也 是 通过 convertValue 方法 
实现 的 ， 因 此 我 们 必须 先 通过 toType 参数 来 判断 转换 的 方向 ， 然 后 分 别 实现 不 同 转换 方向 的 转换 逻辑 。 
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为 了 简化 类 型 转换 器 的 实现 ，Struts 2 提供 了 一 个 StrutsTypeConverter 抽象 类 ， 这 个 抽象 类 是 
DefaultTypeConverter 类 的 子 类 。StrutsTypeConverter 类 简化 了 类 型 转换 器 的 实现 ， 该 类 已 经 实现 了 
DefaultTypeConverter 的 convertValue 方法 。 实 现 该 方法 时 ， 它 将 两 个 不 同 转换 方向 替换 成 不 同方 法 一 
一 当 需 要 把 字符 串 转 换 成 复合 类 型 时 ， 调 用 convertFromString 
抽象 方法 ; 当 需 要 把 复合 类 型 转换 成 字符 串 时 ， 调 用 7 
convertToString 抽象 方法 。 图 4.5 显示 了 转换 方向 和 方法 之 间 的 ee 


理解 了 上 面 转换 方向 和 方法 之 间 的 对 应 关系 ， 我 们 可 以 更 ; 
法 


简单 地 实现 自己 的 类 型 转换 器 ， 让 自己 的 类 型 转换 器 继承 arvenfromsmng "io 
StrutsTypeConverter 类 ， 并 重 写 convertFromString 方法 和 


convertToString 方法 。 | 本 
下 面 是 基于 StrutsTypeConverter 实现 的 类 型 转换 器 代码 。 。 图 45 转换 方 向 和 方法 之 间 的 对 应 关系 


程序 清单 : codes\04\4.1\StrutsTypeConverte\WEB-INP\src\org\crazyit\app\converter\UserConverterjava 
public class UserConverter extends StrutsTypeConverter 


// 实 现 将 字符 串 类 型 转换 成 复合 类 型 的 方法 
public Object convertFromstring (Map context 
, String[] values , Class toClass) 


// 创 建 一 个 User 实例 

User user ~ new User(); 

// 只 处 理 请 求 参数 数组 第 一 个 数组 元 素 

// 并 将 该 字符 串 以 英文 到 号 分 割 成 两 个 字符 串 

String[] userValues = values[0] .split(”,"); 
// 为 User 实例 赋值 

user. setName (userValues[0]); 

user. setPass (userValues[1] ); 

// 返 回转 换 来 的 User 实例 

return user; 


{ 


和 人流 
Public String convertToString (Map context, Object o) 
// 将 需要 转换 的 值 强制 类 型 转换 为 User 实例 tn 


User user = (User) of 
return "<" + 


} 
} 


通过 继承 StrutsTypeConverter 类 来 实现 类 型 转换 器 ,分别 实现 convertFromString 和 convertToString 
方法 , 这 两 个 方法 分 别 代表 不 同 的 转换 逻辑 一 一 程序 逻辑 更 加 清晰 。 实际 上 就 是 将 原来 的 convertValue 
方法 拆 分 成 两 个 方法 。convertFromString 方法 参数 与 DefaultTypeConverter 类 中 convertValue 方法 参数 
意义 相同 ， 注 册 该 类 型 转换 器 的 方法 也 和 前 面 完全 相同 ， 此 处 不 再 袭 述 。 


》>>4.1.7 处 理 Set 集合 


笔者 不 建议 在 Action 中 使 用 Set 集合 属性 ， 因 为 Set 集合 里 元 素 处 于 无 序 状态 ， 所 以 Struts 2 不 能 
准确 地 将 请 求 参 数 转换 成 Set 元 素 。 不 仅 如 此 ， 由 于 Set 集合 里 元 素 的 无 序 性 ， 所 以 Struts 2 也 不 能 准 
确 读 取 Set 集合 里 的 元 素 。 

除非 Set 集合 里 的 元 素 有 一 个 标识 属性 ， 这 个 标识 属性 可 以 唯一 地 表示 集合 元 素 ,这 样 Struts 2 就 
可 以 根据 该 标识 属性 来 存 取 集合 元 素 了 。 

程序 清单 : codes\04\4.1\SetSupport\WEB-INF\src\org\crazyit\app\action\LoginAction.java 

public class LoginAction extends ActionSupport 
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Private Set users; 
private Date birth; 
//user 属性 的 setter 和 getter 方法 
public void setUsers (Set users) 
{ 
this.users = users; 
} 
Public Set getUsers() 
{ 
return this.users; 


} 
// 省 略 birth 属性 的 setter 和 getter 方法 


7/7 没有 提供 execute (方法 ， 
// 将 直接 使 用 ActionSupport 的 execute() 方 法 
) 


上 面 LoginAction 的 users 属性 的 类 型 是 Set， 为 了 让 Struts 2 能 将 请 求 参数 转换 成 Set 集合 对 象 ， 
我 们 提供 如 下 类 型 转换 器 。 
程序 清单 : codes\04W4.1\SetSupport\WEB-INF\src\org\crazyit\app\converter\UserConverterjava 


public class UserConverter extends StrutsTypeconverter 
{ 
public Object convertFromstring (Map context 
, String[] values, Class toClass) 
{ 
Set result = new Hashset(); 
for (int 1 = 0; i < values.length ; i++ ) 


{ 
// 创 建 一 个 User 实例 
User user = new User(); 
// 只 处 理 请 求 参数 数组 第 一 个 数组 元 素 ， 
// 并 将 读 字 符 申 以 英文 带 号 分 割 成 两 个 字符 囊 
String[] userValues = values[i] .split(","); 
// 为 User 实例 的 属性 赋值 
user. setNane (userValues [0]); 
user. setpass (userValues [1]); 
// 将 User 实例 添加 到 set 集合 中 
result .add (user) ; 
} 
return result; 
} 
public string convertTostring (Map context, Object o) 
{ 
/7 如 果 待 转换 对 象 的 类 型 是 Set 
if (0.getClass() == Set.class) 
{ 


Set users = (Set)o; 
String result = "("; 
for (Object obj : users ) 
{ 

User user = (User)obj; 

result += "<" + user.getName() 

+ ww” + user.getpass() + ">"; 

站 
return result + "J]"; 


return ""; 
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上 面 的 粗 体 字 代码 实现 了 将 字符 串 数组 转换 成 Set 集合 的 转换 处 理 。 除 此 之 外 , 为 了 让 Struts 2 能 
准确 地 存 取 Set 集合 元 素 ， 我 们 还 必须 让 Sturts 2 明白 Set 集合 元 素 的 标识 属性 ， 指 定 Stmts 2 根据 该 
标识 属性 来 存 取 Set 集合 元 素 。 

本 应 用 中 users 属性 所 包含 的 集合 元 素 为 User 类 ， 该 类 的 代码 如 下 。 
程序 清单 : codes\04W4.1\SetSupport\WEB-INF\src\org\crazyit\app\domain\Userjava 


public class User 
Wl 


private String name; 
private String pass; 
// 省 略 name 和 Pass 的 setter 和 getter 方 法 


public boolean equals (Object obj) 


// 特 比较 的 两 个 对 象 是 同一 个 对 象 ， 直 接 返 回 true 
if(this == obj) 
{ 

return true; 


} 
// 只 有 当 obj 是 User 对 象 
if (obj != null 65 obj.getClass() 一 User.class) 
{ 
User user = (User)obj; 
// 两 个 对 象 的 name 属性 相等 即 认为 二 者 相等 
if (this.getName() .equals (user.getNane())) 
{ 
return true; 
) 
} 
return false; 


} 
// 根 据 name 属性 来 计算 hashCode 
， ”public int hashCode() 
{ 
return name .hashCode () 7 
} 
} 


从 User 类 的 粗 体 字 代 码 ( 重 写 了 equals 和 hashCode 两 个 方法 ) 可 以 看 出 ,该 User 类 的 标识 属性 
是 name， 当 两 个 User 的 name 相等 时 即 可 认为 它们 相等 。 

Struts 2 允许 通过 局 部 类 型 转换 文件 来 指定 Set 集合 元 素 的 标识 属性 ， 在 局 部 类 型 转换 文件 中 增加 
如 下 一 行 即 可 指定 Set 集合 元 素 的 标识 属性 。 

KeyProperty_<SetPropName>=<keyPropName> 

将 上 面 的 <SetPropName> 替 换 成 集合 属性 名 ， 将 <keyPropName> 替 换 成 集合 元 素 的 标识 属性 即 
可 。 由 于 本 应 用 的 局 部 类 型 转换 文件 还 需要 指出 Set 集合 元 素 的 类 型 ， 所 以 该 局 部 类 型 转换 文件 的 
代码 如 下 。 

程序 清单 ，codes\04W4.1\SetSupport\WEB-INF\src\org\crazyit\app\action\LoginAction-conversion.properties 

4 指定 users 属性 的 类 型 转换 器 是 lee.UserConverter 


users=lee.UserConverter 
# 指 定 users 集合 属性 里 集合 元 素 的 索引 属性 是 name 


KeyProperty_users=name 
- 旦 指定 了 集合 元 素 的 索引 属性 后 ，Struts 2 就 可 以 通过 该 索引 属性 来 存 取 Set 集合 元 素 了 。 下 面 

是 在 JSP 页 面 中 通过 索引 属性 直接 访问 Set 元 素 的 代码 片段 。 

<!-- 访问 user 集合 属性 里 索引 属性 值 为 crazyit*org 的 元 素 的 name 属性 -> 

用 户 crazyit.org 的 用 户 名 为 : <s:property value="users('crazyit.org') .name"/><br/> 

<!-- 访问 user 集合 属性 里 索引 属性 值 为 crazyit .org 的 元 素 的 Pass 属性 -一 > 

用 户 crazyit .org 的 密码 为 ， <s:property value="users('crazyit.org') .pass"/><br/> 

<1-- 访问 user 集合 属性 里 索引 属性 值 为 b 的 元 素 的 name 属性 --> 
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用 户 b 的 用 户 名 为 : <s:property value="users('b') .name"/><br/> 
<!-- 访问 user 集合 属性 里 索引 属性 值 为 b 的 元 素 的 pass 属性 --> 

用 户 b 的 密码 为 : <s:property value="users('b') .pass"/><br/> 
生日 为 : <s:property value="birth"/><br/> 


通过 代码 可 以 看 出 ， 直 接 访问 Set 元 素 的 方式 是 : <SetPropName>('<indexPropValue>') 一 一 该 方式 
访问 的 是 索引 属性 为 指定 值 的 集合 元 素 。 上 面 代码 将 会 输出 Set 属 性 里 的 两 个 User 实 例 的 name 和 pass， 
MT User 实例 的 标识 属性 (name 属性 ) 值 分 别 为 scott 和 yeeku。 


浅 - i 
上 面 访问 Set 元 素 用 的 是 国 括 号 ， 而 不 是 方 括号 。 但 对 于 数组 、 List 和 Map 属性 ， 本 


| 。 则 通过 方 括号 来 访问 指定 集合 元 素 - 


[ 


>>4.1.8 类 型 转换 中 的 锚 误 处 理 


表现 层 数据 是 由 用 户 输入 的 ， 用 户 输入 则 是 非常 复杂 的 ， 正 常用 户 的 偶然 错误 ， 还 有 Cracker ( 破 
坏 者 ) 的 恶意 输入 ， 都 可 能 导致 系统 出 现 非 正常 情况 。 例 如 ， 在 如 图 4.2 所 示 的 输入 页 面 中 ， 我 们 希 
望 用 户 输入 crazyit.org,leegang 模式 的 字符 串 ， 希 望 用 户 输入 的 字符 串 包 含 一 个 英文 逗号 (,) 作为 用 户 
名 和 密码 的 分 隔 符 ， 如 果 用 户 输入 多 于 一 个 的 英文 逗号 ， 或 者 没有 输入 英文 逗号 ， 都 将 引起 系统 
异常 一 一 因为 上 面 的 类 型 转换 器 将 无 法 正常 分 解 出 用 户 名 和 密码 。 

实际 上 ， 表 现 层 数 据 涉及 的 两 个 处 理 : 数据 校 验 和 类 型 转换 是 紧密 相关 的 ， 只 有 当 输 入 数据 是 有 
效 数据 时 ， 系 统 才 可 以 进行 有 效 的 类 型 转换 一 一 当然 ， 有 时 候 即 使 用 户 输 入 的 数据 能 进行 有 效 转换 ， 
但 依然 是 非法 数据 (假设 需要 输入 一 个 人 的 年 龄 ， 输入 200 则 肯定 是 非法 数据 )。 因 此 ， 可 以 进行 有 效 
的 类 型 转换 是 基础 ， 只 有 当 数 据 完成 了 有 效 的 类 型 转换 后 ， 下 一 步 才 去 做 数据 校 验 。 

Struts 2 提供 了 一 个 名 为 conversionError 的 拦截 器 ， 这 个 拦截 器 被 注册 在 默认 的 拦截 器 栈 中 。 我们 
查看 Struts 2 框架 的 默认 配置 文件 struts-default.xml， 该 文件 中 有 如 下 配置 片段 : 

<interceptor-stack name="defaultStack"> 


<!-- 省 略 其 他 拦 地 器 引用 --> 
<1-- 处 理 类 型 转换 错误 的 拦截 器 --> 


<interceptor-ref name="conversionError"/> 
<!-- 处 理 数据 校 验 的 拦截 器 --> 
<interceptor-ref name="validation"> 
<param name="excludeMethods">input,back,cancel,browse</param> 
</interceptor-ref> 
<!-- 省 咯 其 他 拦截 器 -> 
二 
在 上 面 的 默认 拦截 器 栈 中 包含 了 conversionError 拦截 器 的 引用 ， 如 果 Struts 2 的 类 型 转换 器 执行 
类 型 转换 时 出 现 错误 ， 该 拦截 器 将 负责 将 对 应 错误 封装 成 表单 域 错 误 〈FieldError)， 并 将 这 些 错误 信 
息 放 入 ActionContext 中 。 
显然 ，conversionError 拦截 器 实际 上 是 AOP 中 的 Throws 处 理 〈 关 于 各 种 处 理 类 型 的 定义 和 深入 
介绍 ， 请 参阅 本 书 关于 Spring 的 介绍 )。Throws 处 理 当 系统 抛 出 异常 时 启动 ， 负 责 处 理 异常 。 通 过 这 
种 方式 ，Struts 2 的 类 型 转换 器 中 只 完成 类 型 转换 逻辑 ， 而 无 须 关 心 异常 处 理 逻 辑 。 因 此 ,我们 看 到 上 
面 的 类 型 转换 器 无 须 进 行 任何 异常 处 理 逻辑 。 
图 4.6 显示 了 Struts 2 类 型 转换 中 的 错误 处 理 流程 。 
图 4.6 只 显示 了 类 型 转换 器 、conversionError 拦截 器 和 控制 器 之 间 的 顺序 图 ， 并 未 完全 刻画 出 系 
统 中 的 其 他 成 员 。 当 conversionError 拦截 器 对 转换 异常 进行 处 理 后 ,系统 会 跳 转 到 名 为 input 的 逻辑 
视图 。 
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第 4 章 4 


六 运 关 型 和 所 结 后 的 请 求 参 娄 


图 4.6 ”Struts 2 类 型 转换 中 的 错误 处 理 流程 


为 了 让 Struts 2 框架 处 理 类 型 转换 的 错误 ， 以 及 使 用 后 面 的 数据 校 验 机 制 ， 系统 的 
Action 类 都 应 该 通过 继承 ActionSupport 类 来 实现 .ActionSupport 类 为 完成 类 型 转换 错误 y 


处 理 ， 履 据 校 验 实现 了 许多 基础 工作 


1.， 处理 类 型 转换 错误 


下 面 将 以 最 简单 的 局 部 类 型 转换 器 为 例 ， 介 绍 如 何 处 理 类 型 转换 错误 。 

我 们 重新 改写 系统 的 Action 类 ， 让 系统 的 Action 类 继承 Struts 2 的 ActionSupport 类 。 修 改 后 的 
Action 类 代码 片段 如 下 。 

程序 清单 : codes\04\4.1\errorHandler\WEB-INF\src\org\crazyit\app\action\LoginAction.java 


// 为 了 正常 使 用 系统 的 类 型 转换 错误 处 理 机 制 ， 让 Action 类 继承 ActionSupport 类 
public class LoginAction 


extends ActionSupport 

{ 
// 该 类 包含 一 个 User 类 型 属性 ， 该 属性 用 于 封装 名 为 usex 的 请 求 儿 至 
private User user; 


private String tip; 
7/ 省 略 该 类 的 其 他 成 分 2 Tree 


和 
著 - 注意 :w 
为 了 让 Struts 2 类 型 转换 的 错误 处 理 机 制 生效 ， 包 括 下 一 节 的 输入 校 验 生效 ， 须 
让 Action 继承 Struts 2 的 ActionSupport 基 类 , 因为 Struts 2 的 ActionSupport 负责 收集 类 型 
转换 错误 、 输 入 校 验 错误 ， 并 将 它 们 封装 成 FieldError 对 象 ， 添 加 到 ActionContext 中 。 


前 面 已 经 提 到 , 当 类 型 转换 出 现 异 常 时 , conversionError 拦截 器 会 处 理 该 异常 , 然后 转 入 名 为 input 
的 逻辑 视图 , 因此 应 该 为 该 Action 增加 名 为 input 的 逻辑 视图 定义 。 修改 后 的 struts.xml 文件 代码 如 下 。 
程序 清单 : codes\04\4.1\errorHandler WEB-INF\src\struts.xml 
<?xml version="1.0" éncoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1. 可 


"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 


<!-- 配置 国际 化 资源 文件 -> 


<constant name="struts.custom.il8n.resources" value="mess"/> 
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<package name="lee" extends="struts-default"> 
<action name="login" class="org.crazyit.app.action.LoginAction"> 
<!-- 配置 名 为 input 的 逻辑 视图 ， 
当 转 换 失 败 后 转 入 该 逻辑 视图 一 > 
<result name="input">/input.jsp</result> 
<result name="success">/welcome.jsp</result> 
<result name="error">/welcome.jsp</result> 
</action> 
<action name=""> 
<result>.</result> 
</action> 
</package> 
</struts> 


上 面 的 粗 体 字 代码 为 input 逻辑 视图 指定 了 物理 视图 资源 ，inputjsp。 经 过 上 面 配 置 ， 如 果 用 户 输 
入 不 能 成 功 转换 成 User 对 象 ， 系 统 将 转 入 inputjsp 页 面 ， 等 待 用 户 再 次 输入 。 

前 面 已 经 讲述 过 ，Struts 2 会 负责 将 转换 错误 封装 成 FieldError， 并 将 其 放 在 ActionContext 中 ， 这 
样 就 可 以 在 对 应 视图 中 输出 转换 错误 ， 在 页 面 中 使 用 <s:fielderror/> 标 签 即 可 输出 类 型 转换 错误 信息 。 

在 默认 情况 下 , 使 用 <s:fielderror/> 标 签 会 输出 形 如 Invalid field value for field xxx 的 错误 提示 信息 ， 
其 中 xxx 是 Action 中 属性 名 ， 也 是 该 属性 对 应 的 请 求 参数 的 名 。 

对 于 中 文 环境 而 言 ， 用 户 通常 希望 看 到 中 文 的 提示 信息 ， 因 此 应 该 改变 默认 的 提示 信息 。 只 需 在 
应 用 的 国际 化 资源 文件 中 增加 如 下 一 行 代码 ， 即 可 改变 默认 的 类 型 转换 错误 的 提示 信息 。 


# 改 变 默认 的 类 型 转换 失败 后 的 提示 信息 
xwork ,default.invalid.fieldvalue={0} 字 段 类 型 转换 失败 ! 


因为 上 面 的 资源 文件 中 包含 了 非 西欧 字符 ， 因 此 必须 使 用 native2ascii 命令 来 处 理 该 文件 。 
也 就 是 说 ，Struts 2 使 用 key 为 xwork.default.invalid.fieldvalue 的 消息 作为 标准 的 提示 信息 ， 并 在 
inputjsp 页 面 中 增加 如 下 代码 : 


<!-- 输出 类 型 转换 错误 、 输 入 校 验 提示 -> 
<s:fielderror/> 


改变 了 默认 提示 信息 后 ， 如 果 再 次 提交 包含 不 能 合理 转换 的 请 求 参 数 ， 将 看 到 如 图 4.7 所 示 的 
页 面 。 


类 型 转换 的 错误 处 理 
输入 的 用 户 名 、 灾 码 以 到 号 〔, ) 贿 开 


aer 字 科 类 型 转 扫 和 失 数 | 
用 户 :ee 
Co 
证 


提示 :;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
Fr 当 我 们 使 用 Struts 2 提供 的 表单 标签 来 生成 表单 时 ,这 些 表单 标签 不 仅 可 以 为 我 们 增加 ， 
额外 的 布局 功能 ， 还 可 以 自动 输出 类 型 转换 失败 的 和 输入 校 验 失败 的 提示 信息 。 | 


在 某 些 时 候 ， 可 能 还 需要 对 特定 字段 指定 特别 的 提示 信息 ， 此 时 可 通过 Action 的 局 部 资源 文件 来 
实现 ， 在 文件 中 增加 如 下 一 项 : 


invalid. fieldvalue. <propName>=<tipMsg> 
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将 其 中 <propName> 替 换 成 需要 进行 类 型 转换 的 属性 名 (此 处 的 propName 可 以 支持 OGNL 表达 式 ， 
例如 userbirth 代表 Action 里 user 属性 的 birth 属性 ), <tipMsg> 替 换 成 转换 失败 后 的 提示 信息 , 上面 的 
转换 错误 提示 就 会 发 挥 作用 了 。 

对 于 如 图 4.8 所 示 的 请 求 页 面 ， 其 中 包含 了 用 户 姓名 、 用 户 年 龄 和 用 户 生 日 三 个 表单 域 ， 它 们 代 
表 三 个 请 求 参数 ， 这 三 个 请 求 参 数 由 Struts 2 采用 字符 串 、 整 数 型 和 日 期 类 型 属性 封装 ， 因 此 必须 涉 
及 到 类 型 转换 ! 本 应 用 的 类 型 转换 是 基于 OGNL 表达 式 的 类 型 转换 。 


类 型 转换 的 错误 处 理 


清 答 入 用 户 信息 
NPE: 
a] 
革 : 
Ea 
E23 


图 4.8 输入 用 户 信息 的 输入 页 面 


处 理 上 面 请 求 的 Action 类 代码 如 下 。 
程序 清单 : codes\04\4.1\errorHandler2\WWEB-INF\src\org\crazyit\app\action\LoginAction.java 
public class LoginAction extends Actionsupport 
{ 
Private User user; 
/Vuser 属性 的 setter 和 getter 方法 
Public void setUser (User user) 
{ 


this.user = User; 
上 
public User getUser() 
{ 

return user; 


) 
// 没 有 execute 方法 ， 直 接 使 用 ActionSupport 的 execute 方法 
} 


因为 要 改变 birth 属性 的 类 型 转换 失败 的 提示 信息 ， 所 以 我 们 为 该 Action 提供 一 个 局 部 资源 文件 ， 
该 文件 内 只 包含 如 下 一 行 代码 。 
程序 清单 : codes\04W4.1\errorHandler2\WEB-| -INF\sre\org\erazyitiapplaction\LoginAction. properties 


# 改 变 上 面 的 Action 中 user 属性 的 birth 属性 类 型 转换 后 的 提示 信息 L 
invalid.fieldvalue.user.birth= 生 日 信息 必须 满足 yyyy-MM-dd 格式 “， 


该 文件 的 文件 名 为 LoginAction.properties (用 native2ascii 处 理 后 新 文件 名 为 LoginAction_zh_CN. 
properties), 将 该 文件 放 在 与 LoginAction.class 相同 的 位 置 ( 例 如 WEB-INF\classes\org\crazyit\app\action 
路 径 下 )。 如 果 我 们 在 如 图 4.8 所 示 的 输入 页 面 中 输入 了 不 能 成 功 进行 类 型 转换 的 字符 串 ,将 看 到 如 图 
4.9 所 示 的 页 面 。 

在 图 4.9 中 可 以 看 到 ， 输 入 的 年 龄 参数 无 法 正常 转换 ， 生 日 参数 也 无 法 正常 转换 ， 其 中 “age 
字段 无 效 ” 是 全 局 的 转换 错误 提示 ， 由 xwork.default.invalid.fieldvalue 消息 提供 ， 后 面 的 生日 字 
段 的 转换 错误 提示 则 是 单独 指定 的 。 

| 上 面 的 转换 错误 信息 是 红色 的 ， 而 不 是 黑色 的 ， 仅 仅 是 因为 笔者 增加 了 一 个 <s:head/> 。 
标签 ， 该 标签 可 以 导入 xhtml 主题 所 需要 的 一 些 CSS 样式 。 | 
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。 生 日 信息 世 须 满足 rryy 8-dd 格 式 


类 型 转换 的 错误 处 理 


图 4.9 输出 类 型 转换 的 错误 提示 
2， 处 理 集合 属性 的 转换 错误 


如 果 Action 里 包含 一 个 集合 属性 ， 只 要 Struts 2 能 检测 到 集合 里 元 素 的 类 型 〈 可 以 通过 局 部 类 型 
转换 文件 指定 ， 也 可 通过 泛 型 方式 指定 )， 类 型 转换 器 就 可 以 正常 起 作用 。 当 类 型 转换 器 在 执行 类 型 转 
换 过 程 中 出 现 异常 时 ， 系 统 的 conversionError 拦截 器 就 会 处 理 该 异常 ， 处 理 结束 后 返回 名 为 input 的 
逻辑 视图 。 

假设 有 如 下 Action 处 理 类 ， 该 处 理 类 里 包含 一 个 List 集合 属性 。 


程序 清单 ，codes\04\4.1\ListErrorHandler\WEB-INF\src\org\crazyit\app\action\LoginAction.java 
// 使 用 Struts 2 的 类 型 转换 的 错误 机 制 ， 应 该 继承 ActionSupport 
public class LoginAction extends ActionSupport 
{ 


private List<User> users; 


//users 属性 的 setter 和 getter 方法 


public void setUsers (List<User> users) 
{ 


this.users = users; 


} 
public List<User> getUsers() 
{ 
return users; 
} 
1 


对 于 上 面 的 Action， 该 Action 需要 的 users 属性 是 一 个 List 集合 ， 我 们 有 两 种 方式 来 传 入 请 求 参数 : 
> ”只 传 入 一 个 users 请 求 参数 ， 该 请 求 参 数 的 值 是 字符 串 数组 的 形式 ; 


> ”分 别传 入 多 个 users[0]、users[1]… 形 式 的 请 求 参 数 ， 这 种 形式 将 会 充分 利用 OGNL 表达 式 
类 型 转换 机 制 。 


对 于 第 一 种 形式 ， 因 为 只 有 一 个 请 求 参 数 ， 请 求 参数 名 为 users， 只 要 任何 一 个 users 请 求 参数 不 
能 成 功 转换 成 User 对 象 ，Struts 2 都 会 提示 users 字段 无 效 ， 如 图 4.10 所 示 。 


如 果 将 三 个 请 求 参 数 的 名 字 设 为 users[0]、users[1]… 的 形式 ，Struts 2 将 可 以 区 分 每 个 请 求 参数 ， 
从 而 显示 更 友好 的 转换 错误 提示 。 例 如 ， 我 们 将 表单 页 的 代码 改 为 如 下 。 
程序 清单 : codes\04\4.1\ListErrorHandler\ognlInput.jsp 
<s:form action="login"> 
<s:iterator value="{0, 1, 2}" status="stat"> 
<!-- 将 会 依次 生成 多 个 请 求 参数 --> 
<s:textfield name="users[%{#stat.index}]" 
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uaers 宁 眉 关 型 转 扫 和 数 1 
和 0 司 六 县: 
sers 字 肌 半 型 特 扫 失 败 | 
1 
uscrs 字 眉 类 型 转换 失 数 1 
疡 7 小 出 户 认 息 :ee 


EE 
六 


图 4.10 集合 属性 类 型 转换 失败 


label=" 第 41#stat.index) 个 用 户 信息 "/> 
</s:iterator> 
<tr> 
<td colspan="2"><s:submit value=" 转 换 ”theme="simple"/> 
<s:reset value-" 重 填 "”theme="simple"/></td> 
</tr> 
</s:form> 


上 面 的 页 面 代码 我 们 使 用 了 选 代 器 标签 来 指定 三 个 表单 域 的 name， 三 个 表单 域 的 name 将 分 别 是 
users[0]、users[1]、users[2]， 在 这 种 情况 下 如 果 任 一 个 表单 域 类 型 转换 失败 ， 将 看 到 如 图 4.11 所 示 的 
页 面 。 


* users[2]): 机 特 换 失 败 | 
hi 


类 型 转换 的 错误 处 理 


PONMPME: aromit ont, oe) 
users[1] 字 段 类 型 针 折 失 数 ! 

i eee 
wmerw[2] 字 筑 类 型 转换 失 败 1 

3 届 户 信永 -ts 

CI 


图 4.11 集合 属性 类 型 转换 失败 


4.2 使 用 Struts 2 的 输入 校 验 


输入 校 验 也 是 所 有 Web 应 用 必须 处 理 的 问题 ， 因 为 Web 应 用 的 开放 性 ， 网 络 上 所 有 的 浏览 者 都 
可 以 自由 使 用 该 应 用 ， 因 此 该 应 用 通过 输入 页 面 收集 的 数据 是 非常 复杂 的 ， 不 仅 会 包含 正常 用 户 的 误 
输入 ， 还 可 能 包含 恶意 用 户 的 恶意 输入 。 一 个 健壮 的 应 用 系统 必须 将 这 些 非法 输入 阻止 在 应 用 之 外 ， 
防止 这 些 非法 输入 进入 系统 ， 这 样 才 可 以 保证 系统 不 受 影 响 。 

异常 的 输入 ， 轻 则 导致 系统 非 正常 中 断 ， 重 则 导致 系统 崩溃 。 应 用 程序 必须 能 正常 处 理 表 现 层 接 
收 的 各 种 数据 ， 通 常 的 做 法 是 遇 到 异常 输入 时 应 用 程序 直接 返回 ， 提 示 浏览 者 必须 重新 输入 ， 也 就 是 
将 那些 异常 输入 过 滤 掉 。 对 异常 输入 的 过 滤 ， 就 是 输入 校 验 ， 也 称 为 数据 校 验 。 

输入 校 验 分 为 客户 端 校 验 和 服务 器 校 验 ， 客 户 端 校 验 主要 是 过 滤 正 常用 户 的 误 操 作 ， 主 要 通过 
JavaScript 代码 完成 ; 服务 器 端 校 验 是 整个 应 用 阻止 非法 数据 的 最 后 防线 , 主要 通过 在 应 用 中 编程 实现 。 
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客户 端 校 验 的 主要 作用 是 防止 正常 浏览 者 的 误 输入 ， 仅 能 对 输入 进行 初步 过 滤 ， 对 于 恶意 用 户 的 
恶意 行为 ， 客 户 端 校 验 将 无 能 为 力 。 因 此 ， 客 户 端 校 验 绝 不 可 代替 服务 器 端 校 验 。 当 然 ， 客 户 端 校 验 
也 绝 不 可 少 ， 因 为 Web 应 用 大 部 分 浏览 者 都 是 正常 的 浏览 者 ， 他 们 的 输入 可 能 包含 了 大 量 的 误 输入 ， 
客户 端 校 验 把 这 些 误 输入 阻止 在 客户 端 ， 从 而 降低 了 服务 器 的 负载 。 

Struts 2 框架 提供 了 强大 的 类 型 转换 机 制 ， 也 提供 了 强大 的 输入 校 验 功能 ，Struts 2 的 输入 校 验 既 
包括 服务 器 端 校 验 ， 也 包括 客户 端 校 验 。 


> 和 4.2.1 编写 校 验 规 则 文件 


Struts 2 提供 了 基于 验证 框架 的 输入 校 验 , 在 这 种 校 验方 式 下 ,所 有 的 输入 校 验 只 需要 编写 简单 的 
配置 文件 ，Struts 2 的 验证 框架 将 会 负责 进行 服务 器 校 验 和 客户 端 校 验 。 

下 面 应 用 将 会 示范 如 何 利用 Struts 2 的 校 验 框架 进行 输入 校 验 。 使 用 Struts 2 的 校 验 框架 进行 校 验 
无 须 对 程序 代码 进行 任何 改变 ， 只 需 编写 校 验 规则 文件 即 可 ， 校 验 规则 文件 指定 每 个 表单 域 应 该 满足 
怎样 的 规则 。 

本 应 用 所 使 用 的 表单 代码 如 下 。 

程序 清单 :codes\04\4.2\basicValidate\regist.jsp 


<s:form action="regist"> 
<s:textfield name="name" label=" 用 户 名 "/> 
<s:textfield name="Pass”1abel=" 密 码 "/> 
<s:textfield name="age” label=" 年 龄 "/> 
<s:textfield name="birth” label=" 生 日 "/> 
<s:submit value=" 注 册 "/> 

</s:form> 


上 面 粗 体 字 代码 定义 了 4 个 表单 域 ， 这 4 个 表单 域 分 别 对 应 name、pass、age 和 birth 4 个 请 求 参 
数 ， 假 设 本 应 用 要 求 这 4 个 请 求 参数 满足 如 下 规则 : 
> name 和 pass 只 能 是 字母 和 数组 ， 且 长 度 必 须 在 4 到 25 之 间 。 
> ”年龄 必须 是 1 到 150 之 间 的 整数 。 
> ”生日 必须 在 1900-01-01 和 2050-02-21 之 间 。 
下 面 是 该 请 求 对 应 的 Action 代码 。 
程序 清单 ;codes\04\4.2\basicValidate\WEB-INF\src\org\crazyit\app\action\RegistAction.java 
public class RegistAction extends ActionSupport 
{ 
// 该 请 求 包含 的 4 个 请 求 参数 
private String name; 
private String pass; 
private int age; 


private Date birth; 
// 此 处 省 略 了 4 个 属性 的 setter 和 getter 方法 


) 


在 上 面 的 Action 中 ,我 们 仅 提 供 了 4 个 属性 来 封装 用 户 的 请 求 参 数 ， 并 为 这 4 个 参数 提供 了 对 应 
的 setter 和 getter 方法 。 该 Action 继承 了 ActionSupport 类 ， 因 此 它 也 包含 了 一 个 execute 方法 ， 且 该 
方法 直接 返回 success 字符 串 ， 这 个 Action 不 具备 任何 输入 校 验 的 功能 。 
但 通过 为 该 Action 指定 一 个 校 验 规则 文件 后 ， 即 可 利用 Struts 2 的 输入 校 验 功能 对 该 Action 进行 
校 验 。 下 面 是 本 应 用 所 使 用 的 输入 校 验 文件 。 
程序 清单 : codes\04\4.2\basicValidate\WEB-INF\src\org\crazyit\app\action\RegistAction-validation.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 校 验 配 置 文件 的 DTD 信息 一 > 
<!DOCTYPE validators PUBLIC 
"-//Opensymphony Group//XWork Validator 1.0.3//EN" 
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"http://www. opensymphony. com/xwork/xwork-validator-1.0.3.dtd"> 
<!-- 校 验 文件 的 根 元 素 --> 
<validators> 
<!-- 校 验 Action 的 name 属性 --> 
<field name="name"> 
<!-- 指定 name 属性 必须 满足 必 填 规则 --: 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message> 必 须 输 入 名 字 </message> 
</field-validator> 
<!-- 指定 name 属性 必须 匹配 正则 表达 式 一 
<field-validator type="regex"> 
<param name="expression"><![CDRTRI(\wf4,25})]]></Param> 
<message> 您 输入 的 用 户 名 只 能 是 字母 和 数字 
上 且 长 度 必 须 在 4 到 25 之 间 </message> 
</field-validator> 
</field> 
<!-- 校 验 Action 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 pass 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<message> 必 须 输入 密码 </message> 
</field-validator> 
<!-- 指定 pass 属性 必须 满足 匹配 指定 的 正则 表达 式 ~- 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message> 您 输入 的 密码 只 能 是 字母 和 数字 
， 且 长 度 必 须 在 4 到 25 之 间 </message> 
</field-validator> 
</field> 
<!-- 指定 age 属性 必须 在 指定 范围 内 --> 
<field name="age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">150</param> 
<message> 年 纪 必 须 在 1 到 150 之 间 </message> 
</field-validator> 
</field> 
<!-- 指定 birth 属性 必须 在 指定 范围 内 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 下 面 指定 日 期 字符 串 时 ， 必 须 使 用 本 Locale 的 日 期 格式 > 
<param name="min">1900-01-01</param> 
<param name="max">2050-02-21</param> 
<message> 生 日 必须 在 ${fmin) 到 $ {max} 之 间 </message> 
</field-validator> 
</field> 
</validators> 


校 验 规 则 文件 的 根 元 素 是 <validators.…> 元 素 ，<validators.… 记 元素 可 包含 多 个 <field. 户 或 
<validator.. 人 > 元 它们 都 用 于 配置 校 验 规则 ， 区 别 是 : <field-validator..> 是 字段 校 验 器 的 配置 风格 ， 
而 <validator.. 人 是 非 字 段 校 验 器 的 配置 风格 。 关 于 这 两 个 元 素 配置 方式 后 面 还 有 更 详细 的 介绍 。 

Struts 2 的 校 验 文件 规则 与 Struts 1 的 校 验 文件 设计 方式 不 同 , Struts 2 中 每 个 Action 都 有 一 个 校 验 
文件 ， 因 此 该 文件 的 文件 名 应 该 遵守 如 下 规则 : 

<Action 名 字 >-validation.xml 

前 面 的 Action 名 是 可 以 改变 的 ， 后 面 的 -validation .xml 部 分 总 是 固定 的 ， 且 该 文件 应 该 被 保存 在 
与 Action class 文件 相同 的 路 径 下 .例如 ,本 应 用 的 Action class 文件 保存 在 WEB-INF/classes/org/crazyit/ 
app/action 路 径 下 ， 故 该 校 验 文件 也 应 该 保存 在 该 路 径 下 。 

与 类 型 转换 失败 相似 的 是 ， 当 输入 校 验 失败 后 ，Struts 2 也 是 自动 返回 名 为 “input” 的 Result， 因 
此 需要 在 struts.xml 文件 中 配置 名 为 “input” 的 Result。 下 面 是 本 应 用 的 struts.xml 文件 中 Action 的 配 
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置 片段 。 
程序 清单 : codes\04\4.2\basicValidate\WEB-INF\src\struts.xml 


<!-- 用 户 注册 的 Action --> 

<action name="regist" class="org.crazyit.app.action.RegistAction"> 
<!-- 类 型 转换 失败 、 输 入 校 验 失败 ， 转 入 该 页 面 --> 
<result name="input">/regist.jsp</result> 
<result>/show.jsp</result> 

</action> 


增加 了 上 面 的 修改 之 后 ， 这 样 就 为 该 Action 对 应 的 各 字段 添加 了 校 验 规则 ， 而 且 指 定 了 校 验 失败 
后 应 用 会 跳 转 到 registjsp 页 面 ， 接 下 来 可 以 在 registjsp 页 面 中 添加 <s:fielderror> 来 输出 错误 提示 。 

剩 下 部 分 无 须 任何 修改 ， 系 统 自动 会 加 载 该 文件 ， 当 用 户 提交 请 求 时 ，Struts 2 的 校 验 框架 会 根据 
该 文件 对 用 户 请 求 进行 校 验 。 如 果 浏 览 者 的 输入 不 满足 校 验 规则 ， 将 可 以 看 到 如 图 4.12 所 示 的 界面 。 


请 输入 您 的 注册 信息 


1 入 交 人 的 居 语 名 只 能 是 字号 和 数字 ， 旧 攻 度 必须 在 4 到 25 之 亲 
。 芭 也 和 锭 入 密码 
， 年 名 和 和 须 在 1 到 150 之 间 


你 答 入 的 用 户 名 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 
万 各: 四 
ET 


年 妮 匈 须 在 1 到 150 之 间 


图 4.12 使 用 校 验 框架 的 效果 


从 图 4.12 中 可 以 看 出 ， 这 种 基于 Struts 2 校 验 框架 的 校 验方 式 完全 可 以 替代 手动 校 验 ， 而 且 这 种 
校 验方 式 的 可 重用 性 非常 高 ， 只 需要 在 配置 文件 中 配置 校 验 规则 ， 即 可 完成 数据 校 验 ， 无 须 用 户 书写 
任何 的 数据 校 验 代码 。 


Ci 类 型 转换 失败 的 提示 信息 、 输 入 校 验 失败 的 提示 信息 都 被 封装 成 FieldError, 并 被 放 入 | 
Action Context 中 ， 而 且 校 验 失败 时 都 将 返回 input 逻辑 视图 名 ， 且 都 使 用 <s:fielderror/> 标 : 

| ”和 俭 来 输出 错误 提示 信息 。 如果 开 发 者 使 用 了 Struts 2 的 表单 标签 来 生成 表单 ， 那 么 表单 标 | 
签 会 自动 输出 错误 提示 ， 如 图 4.12 所 示 . 


>》>4.2.2 国际 化 提示 信息 


在 上 面 的 数据 校 验 中 ， 所 有 的 提示 信息 都 是 通过 硬 编码 的 方式 写 在 配置 文件 中 的 ， 这 种 方式 显然 
不 利于 程序 国际 化 。 

当 查 看 每 个 校 验 文件 时 ， 发 现 每 个 <field-validator .… 人 元 素 都 包含 了 一 个 必 填 的 <message … 人 > 子 元 
素 ， 这 个 子 元 素 中 的 内 容 就 是 校 验 失败 后 的 提示 信息 。 为 了 国际 化 该 提示 信息 ， 为 message 元 素 指定 
key 属性 ， 该 key 属性 指定 是 国际 化 提示 信息 对 应 的 key。 

例如 ， 我 们 将 前 面 的 birth 字段 的 校 验 规则 改 为 如 下 配置 。 

程序 清单 : codes\04\4.2\118NValidate\WEB-INF\src\org\crazyit\app\action\RegistAction-validation.xml 

<?xml version="1.0" encoding="GBK"?> 
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<!-- 指定 校 验 配置 文件 的 DTD 信息 --> 
<!DOCTYPE validators PUBLIC 
"-//Opensymphony Group//XWork Validator 1.0.3//EN" 
"http: //www.opensymphony. com/xwork/xwork-validator-1. 
<!-- 校 验 文件 的 根 元 素 --> 
<validators> 
<!-- 校 验 Action 的 name 属性 -> 
<field name="name"> 
<!-- 指定 name 属性 必须 满足 必 填 规则 一 -> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
‘<message key="name. requried"/> 
</field-validator> 
<!-- 指定 name 属性 必须 匹配 正则 表达 式 -- 
<field-validator type="regex"> 
<param name="expression"><![CDATAL (\w{4,25})]]></param> 
‘<message key="name.regex"/> 
</field-validator> 
</field> 
<!-- 校 验 Action 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 pass 属性 必须 满足 必 填 规则 一 -> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
‘<message key="pass.requried"/> 
</field-validator> 
<!-- 指定 pass 属性 必须 满足 匹配 指定 的 正则 表达 式 一 > 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
‘<message key="pass.regex"/> 
</field-validator> 
</field> 
<!-- 指定 age 属性 必须 在 指定 范围 内 -> 
<field name="age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">150</param> 
‘<message key="age.range"/> 
</field-validator> 
</field> 
<!-- 指定 birth 属性 必须 在 指定 范围 内 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 下 面 指定 日 期 字符 串 时 ， 必 须 使 用 本 Locale 的 日 期 格式 -> 
<param name="min">1900-01-01</param> 
<param name="max">2050-02-21</param> 
<message key="birth. range"/> 
</field-validator> 
</field> 
</validators> 


上 面 的 粗 体 字 代码 并 未 直接 给 出 message 的 内 容 ， 而 是 指定 了 一 个 key 属性 ,表明 当 birth 字段 违 
反 该 校 验 规则 时 ， 对 应 的 提示 信息 是 key 为 birth.range 的 国际 化 消息 。 

本 应 用 的 校 验 文件 中 指定 了 许多 国际 化 信息 的 key， 所 以 必须 在 国际 化 资源 文件 中 增加 对 应 的 
key， 即 在 国际 化 资源 文件 中 增加 如 下 Entry。 

程序 清单 : codes\04\4.2\118NValidate\WEB-INF\srcmess.properties 


# 违 反 用 户 名 必须 输入 的 提示 信息 

name . requried= 您 必须 输入 用 户 名 ! 

# 违 反 用 户 名 必须 匹配 正则 表达 式 的 提示 信息 

name . regex= 您 输入 的 用 户 名 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 ! 
# 违 反 密码 必须 输入 的 提示 信息 

Pass.requried= 您 必须 输入 密码 ! 

# 违 反 密 码 必须 匹配 正则 表达 式 的 提示 信息 

pass. regex= 您 输入 的 密码 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 ! 
# 违 反 年 龄 必须 在 指定 范围 的 提示 信息 
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age. op tt 
# 违 反 生 日 必须 在 指定 范围 的 提示 信 
birth, i 


运行 上 面 的 程序 ， 即 可 看 到 输入 校 验 的 提示 信息 变 为 国际 化 资源 文件 提供 的 消息 ， 这 就 实现 了 错 
误 提 示 消息 的 国际 化 。 


》>》>4.2.3 使 用 客户 端 校 验 


在 Struts 2 应 用 中 使 用 客户 端 校 验 非常 简单 ， 只 需 改 变 如 下 两 个 地 方 即 可 。 

> ”将 输入 页 面 的 表单 元 素 改 为 使 用 Struts 2 标签 来 生成 表单 。 

> “为 该 <s:form,../> 元 素 增加 validate="true" 属 性 。 

修改 前 面 应 用 的 registjsp 页 面 ， 将 页 面 代码 改 为 如 下 形式 。 

程序 清单 : codes\04\4.2\clientValidate\regist.jsp 

<h2> 请 输入 您 的 注册 信息 </h2> 

<s:fielderror/> 

<s:form action="regist" validate="true"> 
<s:textfield name="name" label=" 用 户 名 "/> 
<s:textfield name="passw label=" 密 码 "/> 
<s:textfield name="age"” label=" 年 铃 "/> 
<s:textfield name="birth" label=" 生 日 "/> 
<sisubmit value=" 注 册 "/> 

</s:form> 

根据 Struts 2 的 官方 文档 所 说 的 ， 只 要 将 JSP 页 面 改 成 如 上 的 形式 ， 就 应 该 可 以 完成 客户 端 校 验 。 
但 当 笔 者 在 浏览 器 中 浏览 该 registjsp 页 面 时 ， 看 到 如 图 4.13 所 示 的 页 面 。 


请 输入 您 的 注册 信息 


Mp 
Eo 


Fp 
E32 
区 
FreeMarker template error 


Nethod publie era wthl. Let ort seoche rtruta2 ccapenents Porn getrVali dators (jo 


图 4.13 使 用 客户 端 校 验 中 出 现 的 异常 
图 4.13 显示 了 FreeMarker 模板 的 详细 出 错 信息 。 当然, 在 Tomcat 控制 台 也 可 看 到 系列 的 异常 信息 。 
出 现 这 种 错误 的 原因 是 因为 ， 如 果 我 们 希望 Struts 2 的 客户 端 校 验 能 发 生 作用 ， 那 我 们 进入 该 
registjsp 页 面 之 前 必 先 经 过 Struts 2 的 核心 Filter， 而 上 面 我 们 直接 请 求 了 registjsp 页 面 ， 并 未 经 过 
pan 有 


三- 注意 : :等 

前 面 我 们 介绍 的 应 用 都 是 直接 将 SP 页 面 族 在 Web 应 用 的 根 夫 径 下 了 ,实际 上 这 种 。 
做 法 与 MVC 思想 是 违背 的 ， 因 为 在 纯粹 的 MVC 思想 中 ，JSP 页 面 只 是 简单 的 视图 , 用 | 
户 请 求 不 应 该 直接 向 视图 页 面 发 送 请 求 ， 而 是 应 该 向 控制 器 发 送 请 求 ， 由 控制 器 来 调用 < 
视图 页 面向 浏览 者 旦 现 数据 。 
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为 了 避免 这 种 情况 ， 我 们 把 上 面 应 用 中 所 有 JSP 页 面 都 移 到 WEB-INF/content 目录 下 ， 这 样 就 可 
以 避免 浏览 者 直接 向 指定 页 面 发 送 请 求 。 接 下 来 我 们 在 struts.xml 文件 中 配置 一 个 通用 的 action, 配置 


片段 如 下 : 
<!-- 可 以 匹配 任何 请 求 ， 直 接 转向 对 应 的 页 面 
例如 abc 请 求 ， 那 么 就 会 跳 转 到 /WEB-INF/content/abc.jsp --> 
<action name="*"> 
<result>/WEB-INF/content/{1} .jsp</result> 
</action> 
增加 上 面 的 配置 之 后 , 浏览 者 不 应 该 直接 向 registjsp 页 面 发 送 请求 , 而 是 应 该 向 regist 发 送 请 求 ， 
这 个 请 求 将 会 先 经 过 StrutsPrepareAndExecuteFilter， 然 后 再 由 该 Filter forward 到 /WEB-INF/content/ 


regist.jsp 页 面 。 
此 时 ， 如 果 浏览 者 的 输入 不 再 符合 校 验 规则 ， 将 看 到 如 图 4.14 所 示 的 页 面 。 


请 输入 您 的 注册 信息 
企 输 入 的 用 户 名 只 能 是 字母 和 数组 ， 且 长 度 多 基 在 4 到 25 之 间 ! 
WP: [en 


全 各 策 往 入 可 到 : 
各 给 入 的 杰 码 只 能 是 字母 和 数 得， 且 长 度 冯 须 在 4 对 25 之 问 ， 
站 
息 的 年 前 名 项 在 1 和 150 之 间 ! 
a 


¥8:e 


图 4.14 客户 端 校 验 的 效果 
从 图 4.14 中 可 以 看 出 ， 虽 然 使 用 客户 端 校 验 ， 却 看 不 到 弹出 JavaScript 的 警告 框 ， 这 种 效果 看 起 


来 与 服务 器 端 校 验 几 乎 完全 相同 ， 但 读者 可 以 仔细 看 图 4.14 中 的 地 址 栏 ， 该 页 面 的 地 址 依然 停留 在 原 
来 的 页 面 ， 并 未 提交 到 对 应 的 Action。 这 就 表明 : 上 面 的 数据 校 验 过 程 是 客户 端 完成 的 。 


沁 
注意 :和 ] 
| 客户 端 校 验 依然 是 基于 JavaScript 完成 的 ， 因 为 JavaScript 脚本 本 身 的 限制 ， 有 些 服 | 


务 器 端 校 验 不 能 转换 成 客户 端 校 验 。 也 就 是 说 ， 并 不 是 所 有 的 服务 器 端 校 验 都 可 以 转换 本 


> required validator ( 必 填 校 验 器 ) 。 

requiredstring validator ( 必 填 字符 串 校 验 器 ) 。 

stringlength validator (字符 串 长 度 校 验 器 ) 。 

regex validator (表达 式 校 验 器 ) 。 

email validator (邮件 校 验 器 ) 。 

url validator〈 网 址 校 验 器 ) 。 

int validator (整数 校 验 器 ) 。 

> ”double validator ( 双 精 度数 校 验 器 ) 。 

客户 端 校 验 有 三 个 值得 注意 的 地 方 : 

> ”Struts 2 的 <s:form .…/> 元 素 有 一 个 theme 属性 ， 不 要 将 该 属性 指定 为 simple。 


YE EY 
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> ”浏览 者 不 能 直接 访问 启用 客户 端 校 验 的 表单 页 ， 这 样 会 引发 异常 。 我 们 可 以 把 启用 客户 端 校 
验 的 表单 页 放 到 WEB-INF 路 径 下 去 ， 让 浏览 者 访问 所 有 资源 之 前 都 先 经 过 它 的 核心 Filter。 

> ”启用 客户 端 校 验 的 表单 页 面 的 action 和 namespace 要 分 开 写 ， 例 如 我 们 向 namespace 为 
/lee，name 为 registPro 的 Action 请 求 ， 应 写成 <s:form action="registPro”namespace= 
wee">， 而 不 应 该 写成 <s:form action="lee/registPro" >。 


正如 前 面 提 到 的 ， 一 旦 我 们 使 用 了 MVC 框架 ， 就 应 该 严格 遵守 MVC 思想 ， 应 该 尽 | 
量 避 免 让 浏览 者 直接 访问 Web 应 用 的 视图 页 面 ， 而 是 应 该 让 浏览 者 向 控制 器 发 送 请 求 ， 由， 

| 。 控制 器 调用 视图 页 面向 浏览 者 呈现 数据 。 所 以 我 们 后 面 的 全 部 示例 的 JSP 页 面 都 会 放 入 | 
WEB-INF/content 目录 下 ， 这 一 点 希望 读者 能 注意 ， 不 要 轻率 地 认为 示例 程序 不 完整 。 


> >4.2.4 字段 校 验 器 配置 风格 


Struts 2 提供 了 两 种 方式 来 配置 校 验 规则 : 字段 校 验 器 风格 和 非 字 段 校 验 器 风格 。 这 两 种 风格 其 实 
并 没有 本 质 的 不 同 ， 只 是 组 织 校 验 规则 的 方式 不 同 : 一 种 是 字段 优先 ， 称 为 字段 校 验 器 风格 ;另外 一 
种 是 校 验 器 优先 ， 称 为 非 字段 校 验 器 风格 。 

前 面 应 用 中 校 验 规则 文件 都 是 采用 字段 校 验 器 风格 配置 的 ， 采 用 字段 校 验 器 配置 风格 时 ， 校 验 文 
件 里 以 <field .人 > 元 素 为 基本 子 元 素 。 我们 查看 xwork-validator-1.0.3.dtd 文件 ( 校 验 规则 的 DTD 文件 )， 
就 可 以 发 现 如 下 定义 代码 : 


# 在 validators 元 素 的 field 或 validator 中 都 可 以 出 现 一 次 或 无 限 多 次 
<!ELEMENT validators (fieldlvalidator)+> 


上 面 的 元 素 定义 片段 中 的 <validators... 人 > 是 校 验 规则 文件 的 根 元 素 ， 该 根 元 素 下 可 以 出 现 两 个 元 
素 : <field.… 人 元素 和 <validator .… 人 元素， 出 现 第 一 种 元 素 时 就 是 字段 优先 ， 就 是 字段 校 验 器 配置 风格 ， 
出 现 第 二 种 元 素 时 ， 就 是 校 验 器 优先 ， 就 是 非 字段 校 验 器 配置 风格 。 

使 用 字段 校 验 器 配置 风格 时 ， 每 个 字段 校 验 规则 大 致 遵守 如 下 形式 : 


<field name=" 被 校 验 的 字段 "> 
<field-validator type=" 校 验 器 名 "> 
<!-- 此 处 需要 为 不 同 校 验 器 指定 数量 不 等 的 校 验 参数 --> 
<param name=" 参 数 名 "> 参数 值 </Param> 


<!-- 核验 失败 后 的 提示 信息 ， 其 中 key 指定 国际 化 信息 的 key -> 
<message key="I18Nkey"> 校 验 失败 后 的 提示 信息 </message> 
</ field-validator > 
<!-- 如 果 该 字段 需 要 满足 多 个 规则 ， 下 面 可 以 配置 多 个 校 验 器 -> 
</field> 
从 上 面 的 配置 片段 中 可 以 看 出 , 采用 字段 校 验 器 风格 时 ，<field .人 元 素 是 校 验 规则 文件 的 基本 组 
成 单位 ， 每 个 <field .人 元素 指定 一 个 Action 属性 必须 遵守 的 规则 ， 该 元 素 的 name 属性 指定 了 被 校 验 
的 字段 ， 如 果 该 属性 需要 满足 多 个 规则 ， 则 在 该 <field .… 户 元 素 下 增加 多 个 <field-validator .…. 人 > 元 素 。 
每 个 <field-validator .人 元 素 指定 一 个 校 验 规则 ,该 元 素 的 type 属性 指定 了 校 验 器 名 称 ， 该 元 素 可 
以 包含 多 个 <param .人 > 子 元 素 ， 用 于 指定 该 校 验 器 的 参数 ， 除 此 之 外 ， 每 个 <field-validator .. 人 元 素 都 
有 一 个 必需 的 <message .… 人 元素， 该 元 素 确定 校 验 失败 后 的 提示 信息 。 
<message .元 素 的 key 属性 指定 了 校 验 失败 后 提示 国际 化 信息 对 应 的 key, 该 元 素 的 内 容 是 校 验 
失败 后 的 默认 提示 信息 。 
因为 前 面 已 经 提供 了 大 量 的 字段 校 验 器 配置 风格 的 配置 文件 ， 故 此 处 不 再 给 出 示范 。 
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》>>4.2.5 非 字 段 校 验 器 配置 风格 


对 于 非 字 段 校 验 器 配置 风格 ， 这 是 一 种 以 校 验 器 优先 的 配置 方式 。 在 这 种 配置 方式 下 ， 校 验 规则 
文件 的 根 元 素 下 包含 了 多 个 <validator .…. 亿 元素 ， 每 个 <validator ... 记 元 素 定 义 了 一 个 校 验 规则 。 
对 于 采用 非 字 段 校 验 器 配置 风格 的 校 验 规 则 文件 ，<validators .… 户 元 素 下 有 多 个 <validator .… 人 > 元 
素 ， 每 个 <validators .… 人 元 素 都 有 如 下 格式 : 
<validator type=" 校 验 器 名 "> 
<param name="fieldName"> 需 要 被 校 验 的 字段 </Param> 


<!-- 此 处 需要 为 不 同 校 验 器 指定 数量 不 等 的 校 验 参数 -~-> 
<param name=" 参 数 名 "> 参数 值 </Param> 


< 上 ~ 校 验 失 败 后 的 提示 信息 ， 其 中 key 指定 国际 化 信息 的 key --> 
<message key="I18Nkey"> 校 验 失败 后 的 提示 信息 </message> 
</validator > 


每 个 <validator .…/> 元 素 定义 了 一 个 校 验 规则 ,该 元 素 需 要 一 个 ype 属性 , 该 ype 属性 指定 了 该 校 
验 器 的 名 字 

使 用 非 字段 校 验 器 的 配置 风格 时 ， 采 用 的 是 校 验 器 优先 的 方式 ， 故 必须 为 <validator …> 配 置 一 个 
fieldName 参数 , 该 参数 的 值 就 是 被 校 验 的 Action 属性 名 。 除 此 之 外 ,还 需要 指定 数量 不 等 的 <param .…/> 
元 素 ， 这 些 都 是 指定 校 验 器 所 需 的 参数 。 

F 面 采用 非 字 段 校 验 器 风格 改写 前 面 的 校 验 规则 文件 。 

程序 清单 ，codes\04\4.2\nonField\WEB-INF\src\org\crazyit\app\action\RegistAction-validation.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Struts 2 数据 校 验 的 规则 文件 的 DTD 信息 --> 
<!DOCTYPE validators PUBLIC 
*"-//OpenSymphony Group//XWork Validator 1.0.3//EN" 
"http://www. opensymphony. com/xwork/xwork~validator-1.0.3.dtd"> 
<!-- Struts 2 校 验 文件 的 根 元 素 --> 
<validators> 
<!-- 配置 指定 必 填 字符 串 的 校 验 器 --> 
<validator type="requiredstring"> 
<!-- 使 用 该 校 验 器 校 验 name 属性 --> 
<param name="fieldName">name</param> 
<param name="trim">true</param> 
<!-- 指定 校 验 失败 后 输出 name . required 对 应 的 国际 化 信息 --> 
‘<message key="name.requried"/> 
</validator> 
<!-- 配置 指定 正则 表达 式 的 校 验 器 --> 
<validator type="regex"> 
<!-- 使 用 该 校 验 器 校 验 name 属性 --> 
<param name="fieldName">name</param> 
<param name="trim">true</param> 
<param name="expression"><! [CDATAL (\w{4,25})] ]></param> 
<!-- 指定 校 验 失 败 后 输出 name . required 对 应 的 国际 化 信息 --> 
‘<message key="name.regex"/> 
</validator> 
<!-- 配置 指定 必 填 字符 串 的 校 验 器 -> 
<validator type="requiredstring"> 
<!-- 使 用 该 校 验 器 校 验 Pass 属性 -> 
<param name="fieldName">pass</param> 
<param name="trim">true</param> 
<!-- 指定 校 验 失败 后 输出 pass .required 对 应 的 国际 化 信息 --> 
‘<message key="pass:requried"/> 
</validator> 
<!-- 配置 指定 正则 表达 式 的 校 验 器 --> 
<validator type="regex"> 
<!-- 使 用 该 校 验 器 校 验 pass 属性 --> 
<param name="fieldName">pass</param> 
<param name="trim">true</param> 
<param name="expression"><! [CDATAT (\w{4,25}})]]></param> 
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<!-- 指定 校 验 失败 后 输出 pass . required 对 应 的 国际 化 信息 --> 
<message key="pass.regex"/> 

</validator> 

<!-- 配置 指定 整数 校 验 器 --> 

<validator type="int"> 
<!-- 使 用 该 校 验 器 校 验 age 属性 --> 


<param name="fieldName">age</param> 
<!-- 指定 整数 校 验 器 的 范围 ~-> 
<param name="min">1</param> 
<param name="max">150</param> 
<!-- 指定 校 验 失败 后 输出 age- range 对 应 的 国际 化 信息 --> 
<message key="age. range"/> 

</validator> 

<!-- 配置 指定 日 期 校 验 器 --> 

<validator type="date"> 
<!-- 使 用 该 校 验 器 校 验 birth 属性 --> 
<param name="fieldName">birth</param> 
<!-- 指定 日 期 校 验 器 的 范围 ~-> 
<param name="min">1900-01-01</param> 
<param name="max">2050-02-21</param> 
<!-- 指定 校 验 失败 后 输出 birth. range 对 应 的 国际 化 信息 --> 
<message key="birth.range"/> 

</validator> 

</validators> 


这 份 文件 与 前 面 的 校 验 规则 文件 的 效果 完全 一 样 ， 所 以 开发 者 可 以 自由 选择 配置 风格 。 但 值得 指 
出 的 是 , 并 不 是 所 有 的 校 验 器 都 支持 两 种 配置 风格 。 关 于 各 校 验 器 的 具体 用 法 后 面 会 有 更 详细 的 介绍 。 


》>》4.2.6 短路 校 验 器 


从 xwork-validator-1.0.3.dtd 文件 中 可 以 看 到 ， 校 验 规则 文件 的 <validator .… 人 元素 和 
<field-validator .… 人 > 元 素 可 以 指定 一 个 可 选 的 short-circuit 属性 ， 这 个 属性 指定 该 校 验 器 是 否 是 短路 校 
验 器 ， 该 属性 的 默认 值 是 false， 即 默认 是 非 短路 校 验 器 。 

短路 校 验 器 其 实 是 非常 有 用 的 ， 读 者 朋友 可 以 翻 回去 看 如 图 4.14 所 示 的 页 面 ， 在 密码 输入 框 的 上 
面 看 到 两 行 校 验 提示 信息 : 

您 必须 输入 密码 ! 
您 输入 的 密码 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 ! 

这 种 提示 信息 是 多 么 的 不 友好 啊 ， 浏 览 者 此 时 完全 没有 输入 密码 ， 而 我 们 的 应 用 一 下 子 就 显示 了 
两 条 提示 信息 (而 且 , 第 二 条 校 验 提示 完全 是 多 余 的 , 完全 没有 输入 密码 , 当然 长 度 不 在 4 到 25 之 间 )。 
通常 的 做 法 是 ， 如果 浏 览 者 完全 没有 为 某 个 输入 框 输入 任何 内 容 ， 系 统 应 该 仅 输出 第 一 行 提示 信息 ， 
而 不 是 一 次 输出 所 有 的 校 验 提 志 

为 了 达到 这 种 效果 ， 我 们 应 该 采用 短路 校 验 器 。 采 用 短路 校 验 器 只 需要 在 <validator .… 人 > 元 素 或 
<field-validator .广元 素 中 增加 short-cireuit="true" 即 可 。 . 

修改 上 面 的 配置 文件 ， 对 于 采用 字段 校 验 器 的 校 验 规则 文件 ， 将 用 户 名 必 填 和 密码 必 填 校 验 规则 
配置 成 短路 校 验 器 。 修 改 后 的 校 验 文件 片段 如 下 。 

程序 清单 : codes\04\4.2\short-cut\WEB-INF\src\org\crazyit\app\action\RegistAction-validation.xml 

<!-- 校 验 Action 的 name 属性 --> 


<field name="name"> 

<!-- 指定 name 属性 必须 满足 必 填 规则 -> 

<field-validator type="requiredstring" short-circuit="true"> 
<param name="trim">true</param> 
<message key="name. requried"/> 

</field-validator> 

<!-- 指定 name 属性 必须 匹配 正则 表达 式 -~-> 

<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message key="name.regex"/> 
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</field-validator> 
</field> 
<!-- 校 验 Action 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 Pass 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring" short-circuit="true"> 
<param name="trim">true</param> 
<message key="pass.requried"/> 
</field-validator> 
<!-- 指定 pass 属性 必须 满足 匹配 指定 的 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! ICDATAL (\w{4,25})]]></param> 
<message key-"pass.regex"/> 
</field-validator> 
</field> 


在 上 面 的 配置 文件 中 , 将 user 和 pass 的 必 填 校 验 器 配置 成 短路 校 验 器 。 对 于 同一 个 字段 内 的 多 个 
校 验 器 ， 如 果 一 个 短路 校 验 器 校 验 失败 ， 其 他 校 验 器 都 根本 不 会 继续 校 验 。 

将 校 验 规则 文件 修改 成 上 面 文件 所 示 的 样式 后 , 如 果 依然 不 输入 用 户 名 和 密码 , 直接 提交 该 请 求 ， 
将 看 到 如 图 4.15 所 示 的 页 面 。 


请 输入 侈 的 注册 信息 


Es Css 
您 蕊 须 输入 宅 码 ! 
Ek 


婚 的 年 枪 帮 项 在 1 和 150 之 间 ! 
PC 
竺 6 


-3 
图 4.15 短路 校 验 器 的 效果 


相 比 之 下 ， 在 一 个 <field .… 记 元素 内 定义 字段 校 验 器 ， 比 使 用 带 有 一 个 fieldName 参数 的 
<validator .…/> 元 素 好 得 多 ， 而 且 XML 代码 本 身 也 清晰 得 多 (字段 分 组 更 清晰 了 )。 因 此 ， 笔 者 更 倾向 
于 使 用 字段 校 验 器 风格 。 

图 4.15 所 使 用 的 是 服务 器 端 短路 校 验 器 风格 ， 如 果 使 用 客户 端 短路 校 验 器 风格 〈 修 改 表单 页 的 
s:form 标签 ， 增 加 validate="true")， 将 看 到 如 图 4.16 所 示 的 效果 。 

从 图 4.16 中 可 以 看 出 ， 当 在 客户 端 校 验 中 使 用 短路 特性 时 ， 第 一 个 表单 域 校 验 失败 时 将 导致 系统 
不 会 校 验 其 他 表单 域 。 


请 输入 人 千 的 注册 信息 


图 4.16 客户 端 校 验 中 使 用 短路 特性 
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》>>4.2.7 校 验 文件 的 搜索 规则 


Struts 2 的 一 个 Action 中 可 能 包含 了 多 个 处 理 逻 辑 , 当 一 个 Action 类 中 包含 多 个 类 似 于 execute 的 
方法 时 ， 每 个 方法 都 是 一 个 处 理 逻 辑 。 不 同 的 处 理 逻 辑 可 能 需要 不 同 的 校 验 规则 ，Struts 2 允许 为 不 同 
控制 逻辑 指定 不 同 校 验 规则 的 支持 。 

当 需 要 让 一 个 Action 可 以 处 理 多 个 请 求 时 ， 应 该 在 配置 该 Action 时 指定 method 属性 。 通 过 这 种 
方式 ， 就 可 以 将 一 个 Action 处 理 类 配置 成 多 个 逻辑 Action。 

在 上 面 的 Action 类 中 增加 一 个 login 方法 ， 该 login 方法 不 做 任何 处 理 ， 只 是 简单 地 返回 success 
字符 串 。 下 面 在 struts.xml 文件 中 将 该 Action 类 配置 成 两 个 逻辑 Action。 配 置 这 两 个 逻辑 Action 的 配 
置 片段 如 下 。 

程序 清单 ，codes\04V4.2vVoverrideRule\WEB-INF\srcvstruts xml 


<!-- 配 置 一 个 名 为 *Pro 的 Rctiony 
对 应 的 处 理 逻 辑 为 RegistAction 的 {11 方 法 --> 

<action name="*Pro" class="org.crazyit.app.action.RegistAction" 
method="{1}"> 
<result name="input">/WEB-INF/content/form.jsp</result> 
<result>/WEB-INF/content/show.jsp</result> 


假设 上 面 两 个 Action 的 校 验 规则 不 同 ,注册 时 的 校 验 规则 还 是 之 前 的 校 验 规则 ,但 登录 的 校 验 规 
则 需要 增加 的 用 户 名 和 密码 相同 (这 只 是 假设 ， 实 际 应 用 中 可 能 需要 密码 和 重复 密码 相同 ， 但 不 会 要 
求 用 户 名 和 密码 相同 )。 

如 果 按 之 前 的 方式 来 指定 校 验 规则 文件 ， 这 个 校 验 规则 文件 肯定 分 不 清楚 到 底 要 校 验 哪个 处 理 好 
辑 。 为 了 能 精确 控制 每 个 校 验 逻 辑 ，Struts 2 允许 通过 为 校 验 规则 文件 名 增加 Action 别名 来 指定 具体 
需要 校 验 的 处 理 逻 辑 。 即 采用 如 下 的 形式 : 

<ActionClassName>-<ActionAliasName>-validation. xml 

其 中 ActionClassName 是 Action 处 理 类 的 类 名 ， 而 ActionAliasName 就 是 在 struts.xml 中 配置 该 
Action 时 所 指定 的 name 属性。 例如， 如果 我 们 需要 为 loginPro 逻辑 Action 单独 指定 校 验 规则 ， 则 校 
验 文件 的 文件 名 为 RegistAction-loginPro-validation xml 〈 该 文件 也 需要 与 RegistAction 的 class 文件 放 
在 同一 路 径 下 )， 该 文件 的 内 容 如 下 。 

程序 清单 : codes\044.2\overrideRule\WEB-INF\src\org\crazyitapp\action\RegistAction-loginPro-validation.xml 

<2xml version="1.0" encoding="GBK"?> 

<!-- 指定 Struts 2 配置 文件 的 DTD 信息 --> 

<!4DOCTYPE validators PUBLIC 

"-//openSymphony Group//XWork Validator 1.0.3//EN" 


"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd"> 
<!-- 校 验 规则 文件 的 根 元 素 -> 


<validators> 
<!-- 校 验 name 属性 --> 
<field name="name"> 
<!-- 使 用 表达 式 校 验 器 校 验 name 属性 -> 
<field-validator type="fieldexpression"> 
<!-- 指定 name 属性 和 pass 属性 必须 相等 -> 
<Param name="expression"><! [CDATA[ (user 一 pass)]]></param> 
<message key="nameexp"/> 
</field-validator> 
</field> 
</validators> 


上 面 的 校 验 规则 文件 仅仅 指定 了 Action 的 name 属性 必须 和 pass 属性 相同 ， 那 么 系统 中 原 有 的 校 
验 规则 对 loginPro Action 是 否 依然 有 效 呢 ? 

上 面 使 用 了 表达 式 校 验 器 ， 关 于 各 校 验 器 的 具体 用 法 ， 请 参阅 下 一 节 的 介绍 。 

本 应 用 原来 的 表单 页 稍 作 修改 , 让 该 表单 页 具有 两 个 按钮 , 一 个 “登录 ”提交 按钮 提交 到 loginPro， 
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另 一 个 “注册 ”提交 按钮 提交 到 registPro。 如 果 用 户 单 击 “ 登 录 ” 提 交 按 钮 , 该 表单 将 会 提交 到 loginPro 
Action， 那 么 上 面 指定 的 RegistAction-loginPro-validation.xml 校 验 规则 就 会 起 作用 了 。 如 果 校 验 失败 ， 
看 到 如 图 4.17 所 示 的 校 验 失败 页 面 。 


请 输入 告 的 用 户 信息 
用 户 名 和 赦 码 各 须 相同 


PE es 
BN 

您 的 年 零 多 基 在 1 和 150 之 间 : 
:0 


EE 
颈 


图 4.17 增加 校 验 规则 


从 图 4.17 中 可 以 看 出 ，RegistAction-validation.xml 文件 中 的 校 验 规则 ， 依 然 会 对 名 为 loginPro 的 
Action 起 作用 。 实 际 上 ， 名 为 loginPro 的 Action 中 包含 的 校 验 规则 是 RegistAction-validation.xml 和 
RegistAction- loginPro-validation.xml 两 个 文件 中 规则 的 总 和 。 

除 此 之 外 ， 还 有 一 种 情形 一 一 如 果 系 统 中 包含 了 两 个 Action: BaseAction 和 RegistAction， 其 中 
RegistAction 继承 了 BaseAction， 且 两 个 Action 都 指定 了 对 应 的 配置 文件 ， 则 RegistAction 对 应 Action 
的 校 验 规则 实际 上 是 RegistAction-validation.xml 和 BaseAction-validation.xml 两 个 文件 中 规则 的 总 和 。 

假设 系统 有 两 个 Action: BaseAction 和 RegistAction， 则 系统 搜索 规则 文件 顺序 如 下 : 

(1) BaseAction-validation.xml 

(2) BaseAction- 别 名 -validation.xml 

(3) RegistAction-validation.xml 

(4) RegistAction- 别 名 -validation.xml 

这 种 搜索 与 其 他 搜索 不 同 的 是 ， 即 使 找到 第 一 个 校 验 规则 ， 系 统 还 会 继续 搜索 ， 不 管 有 没有 这 4 
份 文件 ， 也 不 管 是 否 找到 配置 文件 ， 系 统 总 是 按 固定 顺序 搜索 。 

假如 系统 的 struts.xml 文件 中 有 如 下 配置 片段 : 


<!-- 将 RegistAction 的 login 方法 配置 成 一 个 运 辑 Action --> 
<action name="loginPro" class="org.crazyit.app.action.RegistAction" method="login"> 


</action> 

如 果 上 面 的 RegistAction 类 还 继承 了 BaseAction 类 ， 那 么 上 面 这 个 名 为 login 的 Action 的 校 验 规 
则 是 BaseAction-validation.xml 、BaseAction-loginPro-validation.xml 、 RegistAction-validation.xml 和 
RA loginPro-validation.xml 4 份 规则 文件 里 规则 的 总 和 。 


i 
: Struts 2 搜索 规则 文件 是 从 上 而 下 的 ， 实际 用 的 校 验 规则 是 所 有 校 验 规则 的 和 和 如 可 


果 两 个 校 验 文件 中 指定 的 校 验 规则 冲突 ， 则 后 面 文件 中 的 校 验 规则 取胜 . 


>>4.2.8 校 验 顺序 和 短路 


校 验 器 增加 了 短路 的 特性 后 ， 校 验 器 的 执行 顺序 就 变 得 非常 重要 了 。 因 为 前 面 执行 的 校 验 器 可 能 
阻止 后 面 校 验 器 的 执行 。 
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校 验 器 的 执行 顺序 有 如 下 原则 : 


> 


所 有 非 字 段 风格 的 校 验 器 优先 于 字段 风格 的 校 验 器 。 


> ”所 有 非 字 段 风格 的 校 验 器 中 ， 排 在 前 面 的 会 先 执行 。 

> ”所 有 字段 风格 的 校 验 器 中 ， 排 在 前 面 的 会 先 执行 。 

校 验 器 短路 的 原则 是 : 

> ”所 有 非 字段 校 验 器 是 最 优先 执行 ， 如 果 某 个 非 字段 校 验 器 校 验 失 败 了 ， 则 该 字段 上 所 有 字段 
校 验 器 都 不 会 获得 校 验 的 机 会 。 

> 。 非 字 段 校 验 器 的 校 验 失败 ， 不 会 阻止 其 他 非 字 段 校 验 的 执行 。 

> ”如 果 一 个 字段 校 验 器 校 验 失败 后 ， 则 该 字段 下 且 排 在 该 校 验 失败 的 校 验 器 之 后 的 其 他 字段 校 
验 器 不 会 获得 校 验 的 机 会 。 

> ”字段 校 验 器 永远 都 不 会 阻止 非 字段 校 验 器 的 执行 。 


如 果 应 用 中 所 需 的 校 验 规则 非常 复杂 , 用 户 可 以 有 两 个 选择 : 开发 自己 的 校 验 器 , 或 者 重 写 Action 


的 validate 方法 。 此 时 ， 用 户 完全 可 以 按 应 用 需求 进行 输入 校 验 。 
4.2.9 内 建 校 验 器 


Struts 2 提供 了 大 量 的 内 建 校 验 器 ， 这些 内 建 的 校 验 器 可 以 满足 大 部 分 应 用 的 校 验 需求 ， 开 发 者 只 
需要 使 用 这 些 校 验 器 即 可 。 如 果 应 用 有 一 个 特别 复杂 的 校 验 需求 ， 而 且 该 校 验 有 很 好 的 复 用 性 ， 开 发 


者 可 以 开发 自己 的 校 验 器 。 


使 用 WinRAR 打开 Struts 2 发 布 包 的 解压 缩 文件 中 的 xwork-2.2.1jar 文件 ， 在 该 压缩 文件 的 
comvopensymphony\xwork2\validator\validators 路 径 下 找到 一 个 default.xml 文件 ， 这 个 文件 就 是 Struts 2 


默认 的 校 验 器 注册 文件 。 该 文件 的 代码 如 下 : 


<validators> 
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<!-- 必 填 校 验 器 --> 

<validator name="required" class="com,opensymphony.xwork 
.validator.validators.RequiredFieldValidator"/> 

<!-- 必 填 字符 品 校 验 器 --> 

<validator name="requiredstring" class="com.opensymphony.xwork 
.validator.validators. RequiredstringValidator"/> 

《<!-- 整数 校 验 器 --> 

<validator name="int" class="com.opensymphony.xwork 
.validator.validators.IntRangeFieldvalidator"/> 

<!-- 长 整数 校 验 器 --> 

<validator name="long" class="com.opensymphony.xwork2 
.validator.validators.LongRangeFieldValidator"/> 

<!-- 短 整数 校 验 器 --> 

<validator name="short" class="com.opensymphony.xwork2 
.validator.validators. ShortRangeFieldValidator"/> 

<!-- 双 精 度 浮 点 数 校 验 器 --> 

<validator name="double" class="com.opensymphony.xwork 
.validator.validators.DoubleRangeFieldValidator"/> 

<!-- 日 期 校 验 器 =-> 

<validator name="date" class="com.opensymphony.xwork 
.validator.validators. DateRangeFieldValidator"/S 

<!-- 表达 式 校 验 器 --> 

<validator name="expression" class="com.opensymphony.xwork 
.validator.validators. ExpressionValidator"/> 

<!-- 字段 表达 式 校 验 器 --> 

<validator name="fieldexpression" class="com.opensymphony.xwork 
-validator.validators。 FieldExpressionValidator"/> 

<! 一 电子 邮件 校 验 器 -> 

<validator name="email" class="com.opensymphony.xwork 
‘validator.validators. EmailValidator"/> 

<!-- 网 址 校 验 器 --> 


<validator name="url" class="com.opensymphony.xwork 
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.validator.validators.URLValidator"/> 

<!-- Visitor 校 验 器 一 > 

<validator name="visitor" class="com.opensymphony.xwork 
.validator.validators.VisitorFieldValidator"/> 


<!-- 转换 校 验 器 --> 
<validator name="conversion" class="com.opensymphony.xwork 
.validator.validators. ConversionErrorFieldValidator"/> 


<!-- 字符 串 长 度 校 验 器 一 > 
<validator name="stringlength" class="com.opensymphony.xwork 
.validator.validators.StringLengthFieldValidator"/> 


<!-- 正则 表达 式 校 验 器 --> 
<validator name="regex" class="com.opensymphony.xwork 
.validator.validators. RegexFieldValidator"/> 


</validators> 

上 面 的 粗 体 字 代码 标 出 的 校 验 器 名 称 ， 就 是 Struts 2 所 支持 的 全 部 校 验 器 。 

通过 上 面 的 代码 可 以 看 出 ， 注 册 一 个 校 验 器 是 如 此 简单 : 通过 一 个 <validator .…/> 元 素 即 可 注册 
-个 校 验 器 ， 每 个 <validator .…/> 元 素 的 name 属性 指定 该 校 验 器 的 名 字 ，class 属性 指定 该 校 验 器 的 
实现 类 。 

如 果 开发 者 开发 了 一 个 自己 的 校 验 器 ， 则 可 以 通过 添加 一 个 validators.xml 文件 (该 文件 应 该 放 在 
WEB-INF/classes 路 径 下 ) 来 注册 校 验 器 。validators.xml 文件 的 内 容 也 是 由 多 个 <validator .…/> 元 素 组 成 
的 ， Se . 户 元 素 注册 一 个 校 验 器 。 


全 - By 各 :A 
如 果 Struts 2 系统 在 WEB-INF/classes 路 径 下 找到 一 个 validators.xml 文件 ， 则 不 会 | 


再 加 载 系统 默认 的 defaultxml 文件 。 因 此， 如 果 开发 者 提供 了 自己 的 校 验 器 注册 文件 可 


(validators.xml 文件 ) 一 定 要 把 defaultxml 文件 里 的 全 部 内 容 复制 到 validators.xml 文件 中 。 


1. 必 填 校 验 器 
必 填 校 验 器 的 名 字 是 required， 该 校 验 器 要 求 指定 的 字段 必须 有 值 〈 非 空 )， 该 校 验 器 可 以 接受 如 
下 参数 。 
> ”fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
fv 全 用意 字 眉 校 难 天 风 格 来 汪汪 帮 演 入 台独 re 
<validator type=" 
<l-- 指 站 过 要 讽 昌 的 于 届 各 
<param name="fieldName' 
<!-~ 指定 校 验 失败 的 提示 信息 --> 


<message>username must not be null</message> 
</validator> 


iparam> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 
Se; ed 校 验 username 属性 --> 
‘<field name=" 
<field-validator required"> 
<!-- 指定 校 验 失败 的 提示 信息 -> 
<message>username must not be null</message> 
</ field-validator> 


</field> 


<validators> 
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2. 必 填 字符 串 校 验 器 


必 填 字符 串 校 验 器 的 名 字 是 requiredstring， 该 校 验 器 要 求 字段 值 必须 非 空 且 长 度 大 于 0， 即 该 字 
符 串 不 能 是 "。 该 校 验 器 可 以 接受 如 下 参数 。 
> fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
> ”trim: 是 否 在 校 验 前 截断 被 校 验 属性 值 前 后 的 空白 ， 该 属性 是 可 选 的 ， 默 认 是 true。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
二 使 用 闪 池 役 校 对 如 风格 来 于 可 作 境 守 符 曲 术 答 用 人 
<validator type="requiredstr: 
<!-- 指定 需要 校 验 的 字段 名 --> 
<param name="FieldMamen">username</ 
rt eed > 
<param name="trim">true</param> 
<!- 指定 校 验 失败 的 提示 信息 一 > 
‘<message>username is required</message> 
</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 

<!-~ 使 用 字段 校 验 器 风格 米 配 置 必 填 字符 串 校 验 器 ， 校 验 username 属性 --> 

<field name="username"> 

<field-validator type="requiredstring"> 
!-~ 指定 截断 被 校 验 属性 值 前 后 的 空白 ~-> 

name="trim">true</param> 
!-- 指定 校 验 失败 的 提示 信息 --> 

<message>username is required</message> 
</ field-validator> 


</field> 
<validators> 
3. 整数 校 验 器 


整数 校 验 器 包括 int、long、short， 该 校 验 器 要 求 字段 的 整数 值 必须 在 指定 范围 内 。 该 校 验 器 可 以 
接受 如 下 参数 。 
> ”fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
> ”min: 指定 该 属性 的 最 小 值 ， 该 参数 可 选 ， 如 果 没 有 指定 ， 则 不 检查 最 小 值 。 
> max 指定 该 属性 的 最 大 值 ， 该 参数 可 选 ， 如 果 没 有 指定 ， 则 不 检查 最 大 值 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-- 使 用 非 字段 校 验 器 风格 来 配置 整数 校 验 器 -> 
<validator type="int"> 
<!-~ 指定 需要 校 验 的 字段 名 --> 
<param name="fieldName": 
<!-- 指定 age 属性 的 最 小 值 -> 
<param name="min">20</param> 
<!-- 指定 age 属性 的 最 大 值 --> 
<param name="max">50</param> 
<!-- 指定 校 验 失 败 的 提示 信息 --> 
‘<message>Age needs to be between ${min} and ${max}</message> 
</validator> 


<validators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 


<!-- 使 用 字段 校 验 器 风格 来 配置 整数 校 验 器 ， 校 验 age 属性 --> 
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‘<field name="age"> 
<field-validator type="int"> 
<!-- 指定 age 属性 的 最 小 值 --> 
<param name="min">20</] 
<!-- 指定 age 属性 的 最 大 值 --> 
<param name="max">50</param> 
<!-- 指定 校 验 失败 的 提示 信息 -> 
<message>hge needs to be between ${min} and ${max}</message> 
</ field-validator> 
</field> 
<validators> 


与 整数 校 验 器 用 法 几乎 相同 的 是 双 精 度 浮 点 数 校 验 器 , 唯一 的 区 别 是 它 要 求 被 校 验 的 Action 属性 
是 双 精度 浮 点 数 。 


4. 日 期 校 验 器 


日 期 校 验 器 的 名 字 是 date， 该 校 验 器 要 求 字段 的 日 期 值 必须 在 指定 范围 内 。 该 校 验 器 可 以 接受 如 
下 参数 。 

> ”fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
> min: 指定 该 属性 的 最 小 值 ， 该 参数 可 选 ， 如 果 没 有 指定 ， 则 不 检查 最 小 值 。 

> max 指定 该 属性 的 最 大 值 ， 该 参数 可 选 ， 如 果 没 有 指定 ， 则 不 检查 最 大 值 。 


味 
“注意 :如 
如 果 系统 没有 指定 日 期 转换 器 ， 则 默认 使 用 XWorkBasicConverter 完成 日 期 转换 。 

进行 日 期 转换 时 ， 默 认 使 用 struts.properties 里 指定 的 Locale， 或 者 系统 默认 的 Locale 的 


Date.SHORT 格式 来 进行 日 期 转换 。 守 
用 非 字段 校 验 器 配置 风格 时 ， 校 用 器 的 配置 示例 如 下 下 : 
<validators> 


Siem Rien et er 
<validator type="dat 
< byt 失策 们 入 字 下 名 (ag 
<param name="fieldName">birth</param> 
<!-- 指定 birth 属性 的 最 小 值 --> 
<param name="min">1990-01-01</param> 
<!-- 指定 birth 属性 的 最 大 值 一 > 
<param name="max">2010-01-01</param> 
<!-- 指定 校 验 失败 的 提示 信息 --> 


<message> Birthday must be within ${min} and ${max} </message> 
</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-- 使 用 字段 校 验 器 风格 来 配置 日 期 校 验 器 ， 校 验 birth 属性 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 指定 birth 属性 的 最 小 值 --> 
<param name="min">1990-01-01</param> 
<!-- 指定 birth 属性 的 最 大 值 --> 
<param name="max">2010-01-01</param> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
‘<message> Birthday must be within ${min} and ${max} </message> 
</ field-validator> 


</field> 
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<validators> 


5 表达 式 校 验 器 


表达 式 校 验 器 的 名 字 是 expression， 它 是 一 个 非 字段 校 验 器 ， 不 可 在 字段 校 验 器 的 配置 风格 中 使 
用 。 该 表达 式 校 验 器 要 求 OGNL 表达 式 返 回 tue， 当 返回 tue 时 ， 该 校 验 通 过 ， 和 否则 校 验 没有 通过 。 
该 校 验 器 可 以 接受 如 下 一 个 参数 。 


> ”expression: 该 参数 指定 一 个 逻辑 表达 式 ， 该 逻辑 表达 式 基于 ValueStack 进行 求 值 ， 最 后 返 
回 一 个 Boolean 值 ， 当 返回 true 时 ， 校 验 通过 ; 否则 校 验 失 败 。 
该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-- 使 用 表达 式 校 验 器 --> 
<validator type="expression"> 
<!-- 指定 校 验 表 达 式 --> 
<param name="expression"> .... </param> 
<!-- 指定 校 验 失败 的 提示 信息 -> 


<message>Failed to meet Ognl Expression 
</validator> 


</validators> 


6. 字段 表 达 式 校 验 器 


.</message> 


字段 表达 式 校 验 器 的 名 字 是 fieldexpression， 它 要 求 指定 字段 满足 一 个 逻辑 表达 式 。 该 校 验 器 可 以 
接受 如 下 两 个 参数 。 


> fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
> ”expression: 该 参数 指定 一 个 逻辑 表达 式 ， 该 逻辑 表达 式 基于 ValueStack 进行 求 值 ， 最 后 返 
回 一 个 Boolean 值 ， 当 返回 true 时 ， 校 验 通过 :否则 校 验 失败 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-~ 使 用 非 字段 校 验 器 风格 来 配置 字段 表达 式 校 验 器 --> 
<validator type="fieldexpression"> 
<!-- 指定 需要 校 验 的 字段 名 :pass --> 
<param name="fieldNane">pass</param> 
<!-- 指定 好 辑 表 达 式 -> 
<param 


ion "><![CDATA[ (pass 一 rpass)]]</param> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 密 码 必须 和 确认 密码 相等 </message> 

</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 


<!-- 使 用 字段 校 验 器 风格 来 配置 字段 表达 式 校 验 器 ， 校 验 pass 属性 --> 
<field name="pass"> 


<field-validator type="fieldexpression"> 
<!-- 指定 逻辑 表达 式 --> 
,<param name=" expression "><![CDATA[ (pass 一 rpass)]]</param> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 密 码 必 须 和 确认 密码 相等 </message> 
</ field-validator> 
</sield> 
<validators> 


7. 邮件 地 址 校 验 器 


邮件 地 址 校 验 器 的 名 称 是 email， 它 要 求 被 检查 字段 的 字符 如 果 非 空 ， 则 必须 是 合法 的 邮件 地 址 。 
不 过 这 个 校 验 器 其 实 就 是 基于 正则 表达 式 进行 校 验 的 ， 系 统 的 邮件 地 址 正则 表达 式 为 : 
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4 


Nb([L_A-Za-z0-9-](\.[_A-Za-z0-9-])*@([A-Za-z0-9-])+((\.com)|(\.ned)|O\.org)| Qinfo)|O\.edu)| OmiDIC 
WgoW bi wv). aero) .arpa)l .coop)INVind job)| Nmuseum)|N\.name)lN\.pro 
OY eve nato)|(\..{2,3DI0\.{2,3}W\.{2,3})S)\b 


-天 和 * 
随 着 技术 的 不 断 发 展 ,有 可 能 上 面 的 正则 表达 式 不 能 完全 覆盖 实际 的 电子 邮件 地 址 
此 时 ， 建 议 开发 者 使 用 正则 表达 式 校 验 器 来 完成 邮件 校 验 。 就 


该 校 验 器 可 以 接受 如 下 一 个 参数 。 
> fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 

<!-- 使 用 非 字段 校 验 器 风格 来 配置 邮件 校 验 器 -> 
<validator type="email"> 

<!-- 指定 需要 校 验 的 字段 名 :email --> 

<param name="fieldName">email</param> 

<!-- 指定 校 验 失败 的 提示 信息 --> 

<message> 你 的 电子 邮件 地 址 必须 是 一 个 有 效 的 电邮 地 址 </message> 
</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 
<validators> 
Lr ed ye 校 验 email 属性 --> 
<field name="email 
ele volidator type="email"> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 电子 邮件 地 址 必须 是 一 个 有 效 的 电邮 地 址 </message> 
</ field-validator> 
</field> 
<validators> 
8， 网 址 校 验 器 
网 址 校 验 器 的 名 称 是 url， 它 要 求 被 检查 字段 的 字符 如 果 非 空 ， 则 必须 是 合法 的 URL 地 址 。 不 过 
这 个 校 验 器 其 实 就 是 基于 正则 表达 式 进行 校 验 的 ， 因 此 ， 有 可 能 随 着 技术 的 发 展 ， 这 个 校 验 器 不 能 完 
全 夭 盖 所 有 的 网 址 。 此 时 ， 建 议 开发 者 使 用 正则 表达 式 校 验 器 进行 网 址 校 验 。 
该 校 验 器 可 以 接受 如 下 一 个 参数 。 
> fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 参数 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 
<!-- 使 用 非 字段 校 验 器 风格 来 配置 网 址 校 验 器 --> 
<validator type="url"> 

指定 需要 校 验 的 字段 名 : url --> 


nessage> 你 的 宇 页 地 址 必须 是 个 有 效 的 网 址 </message> 
</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 


<!-- 使 用 字段 校 验 器 风格 来 配置 网 址 校 验 器 ， 校 验 url 属性 --> 
<field name="url"> 
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<field-validator type="url"> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 主页 地 址 必须 是 一 个 有 效 的 网 址 </message> 
</ field-validator> 


</field> 
<validators> 
9. Visitor 校 验 器 
Visitor 校 验 器 主要 用 于 检测 Action 里 的 复合 属性 ， 例 如 一 个 Action 里 包含 了 User 类 型 的 属性 。 
假设 有 下 面 的 Action 类 。 
程序 清单 :codes\04\4.2\visito\WEB-INF\src\org\crazyit\app\action\RegistAction.java 
public class RegistAction extends ActionSupport 


{ 
//Action 里 包含 了 一 个 User 类 型 的 参数 
private User user; 
//user 属性 的 setter 和 getter 方法 
public void setUser (User user) 
{ 
this.user = user; 


} 
public User getUser() 
{ 
return (this.user); 
了 


上 面 的 User 类 是 一 个 最 普通 的 Java 类 ， 仅 仅 提供 了 4 个 属性 ， 以 及 每 个 属性 的 setter 和 getter 方 
法 。 该 User 类 的 代码 片段 如 下 。 
程序 清单 :codes\04\4.2\visito\WEB-INF\src\org\crazyit\app\domain\User.java 
public class User 


{ 
//User 类 里 包含 的 4 个 基本 数据 类 型 的 属性 
private String name; 
private String pass; 
private int age; 
private Date birth; 
// 此 处 省 略 了 4 个 属性 的 setter 和 getter 方法 


} 


为 了 校 验 上 面 RegistAction 里 的 User 属性 ， 显 然 不 能 通过 其 他 校 验 器 完成 ， 因 为 那些 普通 校 验 器 
都 只 能 校 验 基本 数据 类 型 和 字符 串 类 型 。 此 时 ,为 了 校 验 该 User 类 型 属性 里 的 其 他 属性 ， 则 应 该 使 用 
Visitor 校 验 器 。 
下 面 给 出 校 验 RegistAction 的 校 验 规则 文件 。 
程序 清单 : codes\04\4.2\visito\WEB-INF\src\org\crazyit\app\action\RegistAction-validation.xml 
<?xml version="l.0" encoding="GBK"?> 
<!-- 指定 校 验 规则 文件 的 DTD 信息 --> 
<!IDOCTYPE Validators PUBLIC ” 
-//Opensymphony Group//XWork Validator 1.0.3//EN™" 
whttp: //www. Spanaynph ony eon/ syn rm waits 0.3.dtar> 
<!-- 校 验 规则 文件 的 根 元 素 


<validators> 
<!-- 指定 校 验 user 字段 -=> 
<field name="User"> 
<!-- 使 用 Visitor 校 验 器 --> 
<field-validator type="visitor"> 
指定 校 验 规则 文件 的 context --> 
name="context": text</param> 
指定 校 验 失败 后 提示 信息 是 否 添加 下 面前 级 --> 
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<param name="appendPrefix">true</param> 
指定 校 验 失 败 的 提示 信息 前 组 --> 
<message> 用 户 的 : </message> 
</field-validator> 
</field> , 
</validators> 


显然 ， 上 面 的 校 验 规则 并 未 指定 User 类 里 各 字段 应 该 遵守 怎样 的 校 验 规 则 。 因 此 ， 我 们 还 必须 为 
User 类 指定 对 应 的 校 验 规则 文件 。 在 默认 情况 下 ， 该 校 验 文件 的 规则 文件 名 为 User-validation.xml， 因 
为 配置 Visitor 校 验 器 时 指定 了 context 为 userContext ， 则 该 校 验 文件 的 文件 名 为 
User-userContext-validation.xml (该 文件 不 是 放 在 与 Action 相同 的 路 径 ， 而 是 应 该 放 在 与 User.class 相 
同 的 路 径 )。 该 文件 的 代码 如 下 。 

程序 清单 : codes\04W4.2\visito\WWEB-INF\src\org\crazyit\app\domain\User-userContext-validation.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 校 验 配置 文件 的 DTD 信息 -> 
<!DOCTYPE validators PUBLIC 
"-//OpenSymphony Group//XWork Validator 1.0.3//EN" 
"http://wuw.opensymphony.com/xwork/xwork-validator-1.0.3.dtd"> 
<!-- 校 验 文件 的 根 元 素 -> 
<validators> 
<!-- 校 验 User 属性 的 name 属性 --> 
<field name="name"> 
<!-- 指定 name 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<!-- 如 果 校 验 失败 ， 输 出 name . requried 对 应 的 国际 化 信息 --> 
<message key="name. requried"/> 
</field-validator> 
<!-- 指定 name 属性 必须 匹配 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<!-- 如 果 校 验 失败 ， 输 出 name . regex 对 应 的 国际 化 信息 ~-> 
‘<message key="name.regex"/> 
</field-validator> 
</field> 
<!-- 校 验 User 属性 的 pass 属性 --> 
<field name="pass"> 
<!-- 指定 pass 属性 必须 满足 必 填 规则 --> 
<field-validator type="requiredstring"> 
<param name="trim">true</param> 
<!-- 如 果 校 验 失 败 ， 输 出 pass .requried 对 应 的 国际 化 信息 --> 
<message key="pass.requried"/> 
</field-validator> 
<!-- 指定 pass 属性 必须 满足 匹配 指定 的 正则 表达 式 --> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<!-- 如 果 校 验 失败 ， 输 出 Pass. regex 对 应 的 国际 化 信息 --> 
<message key="pass.regex"/> 
</field-validator> 
</field> 
<!-- 指定 User 属性 的 age 属性 必须 在 指定 范围 内 -> 
<field name="age"> 
<field-validator type="int"> 
<param name="min">1</param> 
<param name="max">150</param> 
<!-- 如 果 校 验 失 败 ， 输 出 age. range 对 应 的 国际 化 信息 -~> 
‘<message key="age.range"/> 
</field-validator> 
</field> 
<!-- 指定 User 属性 的 birth 属性 必须 在 指定 范围 内 --> 
<field name="birth"> 
<field-validator type="date"> 
<!-- 下 面 指定 日 期 字符 串 时 ， 必 须 使 用 本 Locale 的 日 期 格式 --> 
<param name="min">1900-01=01</param> 
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<param name="max">2050-02-21</param> 
<!-- 如 果 校 验 失败 ， 输 出 birth .range 对 应 的 国际 化 信息 --> 
<message key="birth.range"/> 
</field-validator> 
</field> 
</validators> 


从 上 面 的 配置 文件 中 可 以 看 出 ,这 个 User-userContext-validation.xml 文件 的 内 容 与 之 前 校 验 Action 
的 校 验 文件 完全 相同 ， 通 过 这 种 方式 就 可 以 对 Action 里 复合 类 型 的 属性 进行 校 验 了 。 

因为 Action 里 的 属性 不 再 是 基本 数据 类 型 ， 而 是 User 类 型 的 属性 ， 则 将 JSP 页 面 进行 简单 的 修 
改 : 将 表单 域 直接 绑 定 到 user 属性 的 属性 。 修 改 后 JSP 页 面 的 表单 部 分 代码 如 下 : 


<s:form action="registPro"> 
<s:textfield name="user.name" label=" 用 户 名 "/> 
<s:textfield name="user.pass” label=" 窗 码 "/> 
<s:textfield name="user.age"” 1abel=" 年 龄 "/> 
<s:textfield name="user.birth”label=" 生 日 "/> 
<s:submit value=" 注 册 "/> 

</s: form> 


在 上 面 表单 域 的 name 属性 中 ， 指 定 了 这 些 表单 域 的 名 字 为 userpass、userage 等 ， 这 就 意味 着 将 
这 些 属性 直接 绑 定 到 Action 实例 的 user 属性 的 pass、age 属性 。 
如 果 浏览 者 的 输入 不 能 通过 输入 校 验 ， 将 看 到 如 图 4.18 所 示 的 页 面 。 


ET 
请 输入 人物 的 注册 信息 


用 户 的 ， 用 户 各 儿 坊 1 
MPE: 


用 户 的 ， 用 户 名 六 镇 1 
五 本 


用 户 的 ， 年 龄 世 须 在 1 和 150 之 间 . 
训 衣 :加 
和 有 


TD 
3 


图 4.18 Visitor 校 验 器 的 校 验 效果 


在 图 4.18 中 看 到 校 验 提示 信息 是 :“ 用 户 名 : 必须 输入 名 字 ” 等 。 其 中 “用 户 的 : ”字符 串 是 在 配 
置 Visitor 校 验 器 时 指定 的 <message … 信 元 素 的 内 容 ， 如 果 我 们 指定 appendPrefix 属性 值 为 rue， 则 会 
在 提示 信息 中 增加 该 前 级， 否则 将 不 会 添加 该 前 级 。 
10. 转换 校 验 器 
转换 校 验 器 的 名 称 是 conversion， 它 检查 被 校 验 字段 在 类 型 转换 过 程 中 是 否 出 现 错误 。 它 可 以 接 
受 如 下 两 个 参数 。 
> fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 
参数 。 
> repopulateField: 该 参数 指定 当 类 型 转换 失败 后 ， 返 回 input 页 面 时 ， 类 型 转换 失败 的 表单 
域 是 否 保留 原来 的 错误 输入 。 
采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
”< 优 用 赣 字 良 校内 加 风格 来 配置 转 换 校 玲 吕 
<validator type="conversion"> 
<!-- 指定 需要 校 验 的 字段 名 :age --> 
<param name="fieldName": 


>age</param> 
<!-- 指定 类 型 转换 失败 后 ， 返 回 输入 页 面 不 保留 原来 的 错误 输入 --> 
<param name="repopulateField">false</param> 


314 


http://52pdf.taobao.com 


第 4 章 4 


<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 年 龄 必须 是 一 个 整数 </message> 
</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-- 使 用 字段 校 验 器 风格 来 配置 转换 校 验 器 ， 校 验 age 属性 --> 
<field name="age"> 
<field-validator type="conversion"> 
<!-- 指定 类 型 转换 失败 后 ， 入 于 议和 个 各 二 站 的 村 各 槐 入 Er 
<param name="repopulateField 
<!-~ 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 年 龄 必须 是 一 个 整数 </message> 
</ field-validator> 


</field> 

<validators> 

11. 字符 串 长 度 校 验 器 

字符 串 长 度 校 验 器 的 名 称 是 stringlength， 它 要 求 被 校 验 字段 的 长 度 必须 在 指定 的 范围 之 内 ， 否 则 

就 算 校 验 失败 。 该 校 验 器 可 以 接受 如 下 几 个 参数 。 

> fieldName:， 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 
参数 。 

> ”maxLength: 该 参数 指定 字段 值 的 最 大 长 度 ， 该 参数 可 选 ， 如 果 不 指 定 该 参数 ， 则 最 大 长 度 
不 受 限 制 。 

> ”minLength:， 该 参数 指定 字段 值 的 最 小 长 度 ， 该 参数 可 选 ， 如 果 不 指 定 该 参数 ， 则 最 小 长 度 
不 受 限制 。 

> ”trim: 指定 校 验 该 字段 之 前 是 否 截 断 该 字段 值 前 后 的 空白 。 该 参数 可 选 ， 默 认 是 true。 

采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 
dn 使 用 于 隐 校 时 天 忆 必 来 量 放学 将 时长 度 术 栓 且 ot 
<validator type="string: 
<!-- 指定 需要 校 验 的 字段 名 :user -> 
<param name="fieldName">user</ 
<!-- 指定 user 属性 字符 串 的 最 小 长 度 一 > 
<param name="minLength">4</param> 
<!-- 指定 user 人 eid 
0</param> 


<param name=， 
da Er a 
<message> 你 的 用 户 名 长 度 必须 在 4 到 20 之 间 </message> 
</validator> 


<validators> 


采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-- 使 用 字段 校 验 器 风格 来 配置 字符 串 长 度 校 验 器 ， 校 验 user 属性 一 > 
<field name="user"> 
<field-validator type="stringlength"> 
<!-- 指定 user 属性 字符 串 的 最 小 长 度 --> 
>4</Param> 


<param name="minLength": 

<!-- 指定 user 属性 字符 串 的 最 大 长 度 -> 

<param name="maxLength">20</param> 

<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 用 户 名 长 度 必须 在 4 到 20 之 间 </message> 

</ field-validator> 
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</field> 


xvalidators> 

12. 正则 表达 式 校 验 器 

正则 表达 式 校 验 器 的 名 称 是 regex, 它 检查 被 校 验 字段 是 否 匹 配 一 个 正则 表达 式 。 该 校 验 器 可 以 接 

受 如 下 几 个 参数 。 

> fieldName: 该 参数 指定 校 验 的 Action 属性 名 ， 如 果 采 用 字段 校 验 器 风格 ， 则 无 须 指定 该 
参数 。 

> ”expression: 该 参数 是 必需 的 ， 该 参数 指定 匹配 用 的 正则 表达 式 。 

> ”caseSensitive: 该 参数 指明 进行 正则 表达 式 匹 配 时 ， 是 否 区 分 大 小 写 。 该 参数 是 可 选 的 ， 默 
认 是 true。 

采用 非 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 


<validators> 
<!-- 使 用 非 字段 校 验 器 风格 来 配置 正则 表达 式 校 验 器 --> 
<validator type="regex"> 
<!-- 指定 需要 校 验 的 字段 名 :user -> 
<param name="fieldName">user</param> 
<!-- 指 定 匹配 的 正则 表达 式 --> 
am name="expression"><1[CDATA[(NVwt4,20})]]></Param> 


<par: 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 用 户 名 长 度 必须 在 4 到 20 之 间 ， 且 必须 是 字母 和 数字 </messagey 
</validator> 
cvalidators> 
采用 字段 校 验 器 配置 风格 时 ， 该 校 验 器 的 配置 示例 如 下 : 
<validators> 
<!-- 使 用 字段 校 验 器 风格 来 配置 正则 表达 式 校 验 器 ， 校 验 user 属性 --> 
<field name="user"> 
<field-validator type="regex"> 
<!-- 指定 匹配 的 正则 表达 式 --> 
<param name="expression"><! [CDATA[ (\w{4,20})]]></param> 
<!-- 指定 校 验 失败 的 提示 信息 --> 
<message> 你 的 用 户 名 长 度 必须 在 4 到 20 之 间 ， 且 必须 是 字母 和 数字 </message> 
</ field-validator> 
</field> 
<validators> 


>>4.2.10 基于 Annotation 的 输入 校 验 


这 种 基于 Annotation 的 输入 校 验 实 质 上 也 属于 Struts 2“ 零 配置 ”特性 的 部 分 ， 它 允许 使 用 
Annotation 来 定义 每 个 字段 应 该 满足 的 规则 , Struts 2 在 com.opensymphony.xwork2.validatorannotations 
包 下 提供 了 大 量 校 验 器 相关 的 Annotation， 这 些 Annotation 和 前 面 介绍 的 验证 器 大 致 上 一 一 对 应 ， 读 
者 可 以 自行 查阅 API 文档 。 

提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 
虽 然 这 些 Annotation 实质 上 也 属于 Struts 2 的 “ 零 配置 " 特性 ， 但 由 于 这 种 特性 并 不 是 
Convention 插件 提供 的 ， 而 是 由 XWork 框架 提供 的 ， 因 此 不 需要 Convention 插件 。 
为 了 在 Action 类 通过 Annotation 指定 验证 规则 ， 经 过 如 下 配置 即 可 : 
> “使 用 验证 器 Annotation 修饰 Action 里 各 属性 对 应 的 setter 方法 。 
下 面 我 们 在 前 面 118NValidate 应 用 的 基础 上 进行 修改 , 将 该 应 用 的 WEB-INF\src\lee 路 径 下 的 校 验 
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规则 文件 删除 ， 修 改 该 路 径 下 的 RegistActionjava 文件 ， 通 过 注释 指定 各 属性 应 该 满足 的 规则 。 修 改 
后 的 Action 代码 如 下 所 示 。 
程序 清单 ，codes\04\4.2\annotation\WEB-INF\srcvorg\crazyitappvaction\RegistActionjava 


public class RegistAction extends RctionSupport 
{ 
private String name; 
private String pass; 
private int age; 
private Date birth; 
//name 属性 的 setter 和 getter 方法 
// 使 用 Annotation 指定 必 填 、 正 则 表达 式 两 个 校 验 规则 
@RequiredstringValidator (key = "name.requried" 
, message = "") 
GRegexFieldValidator (expression = "\\w{4,25}" 
,key = "name.regex" , message = "") 
public void setName (String name) 
{ 


this.name = name; 


1 
public String getName() 
{ 

return this.name; 


} 
//pass 属性 的 setter 和 getter 方法 
@RequiredstringValidator (key = "pass.requried" 
,message = "") 
RegexFieldValidator (expression = "\\w{4,25}" 
skey = "pass.regex" ,message = "") 
public void setPass(String pass) 
{ 
this.pass = pass; 
} 
public String getPass() 
{ 
return this.pass; 


//age 属性 的 setter 和 getter 方 法 

QIntRangeFieldValidator (message = "" 
, key = "age.range", min = "1" 
, max = "150") 

public void sethge(int age) 

{ 
this.age = ager 

} 

public int getAge() 

{ 
return this.age; 


} 
//birth 属性 的 setter 和 getter 方法 
// 使 用 Annotation 指定 日 期 范围 校 验 规 
QDateRangeFieldValidator (message = "" 
,key = "birth.range", min = "1900/01/01" 
， max = "2050/01/21") 
public void setBirth(Date birth) 
{ 


this.birth = birth; 
上 
public Date getBirth() 
{ 

return this.birth; 


} 


上 面 Action 的 粗 体 字 代 码 使 用 了 验证 器 Annotation 修饰 了 各 属性 的 setter 方法 , 这 样 Struts 2 就 知 
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道 了 各 属性 应 该 满足 怎样 的 规则 。 通 过 在 Action 中 使 用 Annotation 指定 各 字段 应 该 满足 的 校 验 规则 ， 
就 可 以 避免 书写 XML 校 验 规则 文件 。 

关于 使 用 Annotation 来 代替 XML 配置 文件 ， 这 是 JDK 1.5 新 增 Annotation 后 的 一 个 趋势 ， 使 用 
这 种 方式 无 须 编写 XML 文件 ， 从 而 可 以 简化 应 用 开发 ， 但 带 来 的 副作用 是 所 有 内 容 都 被 写 入 Java 代 
码 中 ， 会 给 后 期 维护 带 来 一 定 困难 。 


》>》》>4.2.11 手动 完成 输入 校 验 


基于 Struts 2 校 验 器 的 校 验 可 以 完成 绝 大 部 分 输入 校 验 ， 但 这 些 校 验 器 都 具有 固定 的 校 验 逻辑 ， 
无 法 满足 一 些 特殊 的 校 验 规则 。 对 于 一 些 特殊 的 校 验 要 求 , 可 能 需要 在 Struts 2 中 进行 手动 校 验 。 Struts 
2 提供 了 良好 的 可 扩展 性 ， 从 而 允许 通过 手动 方式 完成 自 定义 校 验 。 

1. 重 写 validate() 方 法 


本 应 用 一 样 采用 前 面 的 注册 页 面 ,但 现在 我 们 要 求 name 请 求 参数 的 值 必须 包含 crazyit 字符 串 ( 这 
个 要 求 其 实 也 可 通过 正则 表达 式 校 验 器 完成 ， 此 处 仅仅 是 示范 )。 现 在 我 们 通过 重 写 ActionSupport 类 
的 validate() 方 法 来 进行 这 种 校 验 。 

下 面 的 示例 将 对 上 面 的 注册 应 用 进行 改进 ， 为 上 面 的 Web 应 用 增加 Struts 2 支持 。 增 加 Struts 2 
支持 后 ,将 通过 如 下 的 Action 来 处 理 用 户 请 求 。 下 面 的 Action 仅仅 重 写 了 ActionSupport 类 的 validate 
方法 。 

下 面 是 重 写 validate0 方 法 后 的 RegistAction 代码 。 

程序 清单 ，codes\04\4.2\overrideValidate\WEB-INF\src\org\crazyit\app\action\RegistAction.java 


public class RegistAction extends ActionSupport 
private String name; 
private String pass; 
private int age; 
private Date birth; 
// 省 略 了 4 个 属性 的 setter 和 getter 方法 


publie void validate() 
! System.out .println ("进入 validate 方法 进行 校 验 " 
二 name] 
// 要 求 用 户 名 必须 包含 crazyit 子 串 
if(!name.contains ("crazyit")) 
{ 
addFieldError ("user" , 
"您 的 用 户 名 必须 包含 crazyit! ") ; 
} 
} 
上 面 的 粗 体 字 代码 重 写 了 validate 方法 ， 在 validate 方法 中 ， 一 旦 发 现 校 验 失败 ， 就 把 校 验 失败 提 
示 通过 addFieldError 方法 添加 进 系统 的 FieldError 中 ， 这 与 类 型 转换 失败 后 的 处 理 是 完全 一 样 的 。 除 
此 之 外 ， 程 序 无 须 做 额外 的 处 理 ， 如 果 Struts 2 发 现 系统 的 FieldError 不 为 空 ， 将 会 自动 跳 转 到 input 
逻辑 视图 ， 因 此 依然 必须 在 struts.xml 文件 中 为 该 Action 的 input 逻辑 视图 指定 视图 资源 。 
除 此 之 外 ， 为 了 在 input 视图 对 应 的 JSP 页 面 中 输出 错误 提示 ， 应 该 在 该 页 面 中 增加 如 下 代码 : 
<!-- 输出 类 型 转换 失败 提示 和 校 验 失败 提示 -> 
<s:ftelderror/> 
上 面 的 <s:fielderror 户 标签 专门 负责 输出 系统 的 FieldError 信息 ， 也 就 是 输出 系统 的 类 型 转换 失败 
提示 和 输入 校 验 的 失败 提示 。 
如 果 在 输入 页 面 输入 的 用 户 名 不 包含 crazyit 字符 串 ， 我 们 将 会 看 到 如 图 4.19 所 示 的 界面 。 
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请 输入 您 的 注册 信息 
*。 算 攻 生 输入 灾 玛 ! 
。， 怎 的 年 疮 名 须 在 1 和 150 之 问 : 
。 怎 的 用 户 名 少 关 但 言 crazyit1 


re ee Lr] 


Wo 
EF 
和 


图 4.19 重 写 validate 方法 完成 输入 校 验 


在 上 面 的 validate 方法 中 ， 如 果 校 验 失 败 ， 我 们 直接 添加 了 校 验 失败 的 提示 信息 ， 并 没有 考虑 国 
际 化 的 问题 。 但 这 并 不 是 太 大 的 问题 ， 因 为 ActionSupport 类 里 包含 了 一 个 getText 方法 ， 该 方法 可 以 
取得 国际 化 信息 。 

2. 重 写 validateXxx() 方 法 

前 面 已 经 介绍 过 了 ，Struts 2 的 Action 类 里 可 以 包含 多 个 处 理 逻 辑 ， 不 同 的 处 理 逻 辑 对 应 不 同 的 
方法 。 即 Struts 2 的 Action 类 里 定义 了 几 个 类 似 于 execute 的 方法 ， 只 是 方法 名 不 是 execute。 

如 果 我 们 的 输入 校 验 只 想 校 验 某 个 处 理 逻 辑 ， 也 就 是 仅 校 验 某 个 处 理 方法 ， 则 重 写 validate 方法 
显然 不 够 ，validate() 方 法 无 法 准确 知道 需要 校 验 哪个 处 理 方法 。 实 际 上 ， 如 果 我 们 重 写 了 Action 的 
validate 方法 ， 则 该 方法 会 校 验 所 有 的 处 理 逻 辑 。 

为 了 实现 校 验 指定 处 理 逻辑 的 功能 ，Struts 2 的 Action 允许 提供 一 个 validateXxx0 方 法 ， 其 中 xxx 
即 是 Action 对 应 的 处 理 逻 辑 方法 。 

下 面 对 上 面 的 Action 进行 改写 ， 为 该 Action 增加 regist， 并 增加 validateRegist0 方 法 。 修 改 后 的 
RegistAction 类 代码 如 下 。 

程序 清单 :codes\04\4.2\validateXxx\WEB-INF\src\org\crazyit\app\actionRegistAction.java 

public class RegistAction extends ActionSupport 
// 该 action 的 4 个 属性 

Private String name; 

private String pass; 

Private int ager 


private Date birth; 
// 此 处 省 略 4 个 属性 的 setter 和 getter 方法 


public String regist() 
[; 

return SUCCESS; 
} 
public void validate() 


Public void validateRegist() 
{ 
system.out.println ("进入 validateRegist 方法 进行 校 验 " 


+ name); 

// 要 求 用户 名 必须 包含 -org 子囊 
if(!name. contains (".org")) 
{ 
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addFieldError ("user" , 
"您 的 用 户 名 必须 包含 -org1 ") ; 


} 
} 


实际 上 ， 上 面 的 validateRegist 方法 与 前 面 的 regist 方法 大 致 相同 ， 此 处 仅仅 是 为 了 讲解 如 何 通 过 
提供 validateXxx 方法 来 实现 只 校 验 某 个 处 理 逻 辑 。 

为 了 让 该 Action 的 regist 方法 来 处 理 用 户 请 求 ， 必 须 在 struts.xml 文件 中 指定 该 方法 。struts.xml 
文件 的 代码 如 下 。 

程序 清单 : codes\04W.2\validateXxx\WEB-INFVsrcstruts xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Struts 2 配置 文件 的 DTD 信息 --> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2,1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<!-- 指定 Struts 2 应 用 的 国际 化 资源 文件 --> 
<constant name="struts.custom.il8n.resources" value="mess"/> 
<!-- 指定 Struts 2 应 用 编码 的 字符 集 ~-> 
<constant name="struts,.il8n.encoding" value="GBK"/> 
<package name="lee" extends="struts-default"> 
<!-- 定义 处 理 用 户 请 求 的 regist Action, 使 用 .RegistAction 的 regist 
方法 处 理 用 户 请 求 --> 
<action name="registPro" class="org.crazyit.app.action.RegistAction" 
method="regist"> 
<result name="input">/WEB-INF/content/regist.jsp</result> 
<result>/WEB-INF/content /show.jsp</result> 
</action> 
<action name="*+"> 
<result>/WEB-INF/content/{1} .jsp</result> 
</action> 
</package> 
</struts> 


在 上 面 名 为 registPro 的 Action 中 ， 指 定 使 用 RegistAction 的 regist 方法 处 理 用 户 请 求 。 如 果 浏 览 
者 再 次 向 registPro 提交 请 求 ， 该 请 求 将 由 RegistAction 的 regist 处 理 逻 辑 处 理 ， 那 么 不 仅 validate() 方 
法 会 进行 输入 校 验 ，validateRegist0 方 法 也 会 执行 输入 校 验 。 
如 果 我 们 在 本 应 用 的 registjsp 页 面 中 输入 不 符合 要 求 ， 将 看 到 如 图 4.20 所 示 的 页 面 。 
[| 


请 输入 您 的 注册 信息 
及 输入 守 1 


PA 这 到 人 的 钳 训 提 站 
天 可 


和 的 年 具名 须 在 1 和 150 之 问 : 
:0 
8 
EE 


图 4.20 validate 和 validateXxx 方法 同时 作用 


从 图 4.20 中 可 以 看 出 , 当 用 户 向 regist 方法 发 送 请 求 时 ,该 Action 内 的 validate 方法 和 validateRegist 
方法 都 会 起 作用 ， 而 且 validateRegist 方法 首先 被 调用 。 
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前 面 已 经 介绍 过 了 ， 不 管用 户 向 Action 的 哪个 方法 发 送 请 求 ，Action 内 的 validate 方法 都 会 被 调 
用 。 和 Action 内 还 有 该 方法 对 应 的 validateXxx 方法 ， 则 该 方法 会 在 validate 方法 之 前 被 调用 。 


当 我 们 通过 重 写 validate0 或 ValidateXoa0 方 法 来 进行 输入 校 验 时 ， 如 果 开 发 者 在 这 
两 个 方法 中 添加 的 FieldError, 但 Struts 2 的 表单 标签 不 会 自动 显示 这 些 FieldError 提示 ， 
须 使 用 <s: SR 村 从 二 王 式 本 出 傅 误 各 示 ， 


通过 上 面 示例 的 介绍 ， 我 们 不 难 发 现 Struts 2 的 输入 校 验 需 要 经 过 如 下 儿 个 步 又 : 

人 @ 类 型 转换 器 负责 对 字符 串 的 请 求 参 数 执行 类 型 转换 ， 并 将 这 些 值 设置 成 Action 的 属性 值 。 

人 @ 在 执行 类 型 转换 过 程 中 可 能 出 现 异常 ， 如 果 出 现 异 常 ， 将 异常 信息 保存 到 ActionContext 中 ， 
conversionError 拦截 器 负责 将 其 封装 到 FieldError 里 ， 然 后 执行 第 3 步 ， 如 果 转 换 过 程 没 有 异常 信息 ， 
则 直接 进入 第 3 步 。 

人 @ 使 用 Struts 2 应 用 中 所 配置 的 校 验 器 进行 输入 校 验 。 

(@ 通过 反射 调用 validateXxx0 方 法 ， 其 中 Xxx 是 即将 处 理 用 户 请 求 的 处 理 逻 辑 所 对 应 的 方法 。 

人 @ 调用 Action 类 里 的 validate0 方 法 。 

@ 如 果 经 过 上 面 5 步 都 没有 出 现 FieldError, 将 调用 Action 里 处 理 用 户 请 求 的 处 理 方法 如 果 出 
现 了 FieldError， 系 统 将 转 入 input 逻辑 视图 所 指定 的 视图 资源 。 图 4.21 显示 了 Struts 2 表现 层 数据 的 
整套 处 理 流程 。 


YY 站 
i 


em | 


® 


图 4.21 Struts2 执行 数据 校 验 的 流程 图 
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4.3 ”使 用 Struts 2 控制 文件 上 传 


为 了 能 上 传 文件 , 我 们 必须 将 表单 的 method 设置 为 POST, 将 enctype 设置 为 multipart/form-data。 
只 有 在 这 种 情况 下 ， 浏 览 器 才 会 把 用 户 选择 文件 的 二 进 制 数据 发 送 给 服务 器 。 
- 旦 我 们 设置 了 enctype 为 multipart/form-data， 此 时 浏览 器 将 采用 二 进 制 流 的 方式 来 处 理 表单 数 
据 ，Servlet 3.0 规范 的 HttpServletRequest 已 经 提供 了 方法 来 处 理 文件 上 传 ， 但 这 种 上 传 需要 在 Servlet 
中 完成 。 而 Struts 2 则 提供 了 更 简单 的 封装 。 
提示 : Struts 2 的 文件 上 传 还 没有 来 得 及 使 用 Servlet 3.0 API， 因 此 Struts 2 的 文件 上 传 还 需要 依赖 
于 Common-FileUpload、COS 等 文件 上 传 组 件 。 


和 4.3.1 Struts 2 的 文件 上 传 


Struts 2 并 未 提供 自己 的 请 求解 析 器 ， 也 就 是 说 ，Struts 2 不 会 自己 去 处 理 multipart/form-data 的 请 
求 ， 它 需要 调用 其 他 上 传 框架 来 解析 二 进 制 请 求 数据 。 但 Struts 2 在 原 有 的 上 传 解析 器 基础 上 做 了 进 
- 步 封装 ， 更 进一步 简化 了 文件 上 传 。 
在 Struts 2 的 struts.properties 配置 文件 中 ， 我 们 看 到 了 下 面 的 配置 代码 ， 它 们 主要 用 于 配置 Struts 
2 上 传 文件 时 的 上 传 解析 器 。 
# 指定 使 用 COS 的 文件 上 传 解析 器 


# struts.multipart.parser=cos 

# 指定 使 用 Pell 的 文件 上 传 解析 器 

# struts.multipart.parser=pell 

# Struts 2 默认 使 用 Jakarta 的 Common-FileUpload 的 文件 上 传 解析 器 
struts.multipart .parser=jakarta 


Struts 2 的 封装 隔离 了 底层 文件 上 传 组 件 的 区 别 ， 开 发 者 只 要 在 此 处 配置 文件 上 传 所 使 用 的 解析 
器 ， 就 可 以 轻松 地 在 不 同 的 文件 上 传 框架 之 间 切 换 。 

Struts 2 默认 使 用 的 是 Jakarta 的 Common-FileUpload 的 文件 上 传 框架 ， 因 此 ， 如 果 需 要 使 用 Struts 
2 的 文件 上 传 功能 ， 则 需要 在 Web 应 用 中 增加 两 个 JAR 文件 ， 即 commons-io-1.3.2.jar 和 
commons-fileupload-1.2.1.jar, 将 Struts 2 项 目 lib 下 的 这 两 个 文件 复制 到 Web 应 用 的 WEB-INF\lib 路 径 

下 即 可 。 

Struts 2 默认 使 用 Jakarta 的 Common-FileUpload 的 文件 上 传 , 那 是 因为 它们 同 是 Apache 组 织 下 的 
项 目 ， 但 并 不 意味 着 只 能 使 用 Jakarta 的 Common-FileUpload 文件 上 传 ， 我 们 一 样 可 以 在 Web 应 用 中 
使 用 COS、Pell 的 文件 上 传 支持 。 对 于 开发 者 而 言 ， 使 用 哪 种 文件 上 传 支持 ， 几 乎 没有 任何 区 别 一 一 
只 需要 修改 struts.multipart.parser 常量 ， 并 在 Web 应 用 中 增加 相应 上 传 项 目的 类 库 即 可 。 

Struts 2 的 文件 上 传 支持 在 原 有 的 文件 上 传 项 目 上 做 了 进一步 封装 ， 简 化 了 文件 上 传 的 代码 实现 ， 
取消 了 不 同上 传 项 目 上 的 编程 差异 。 

下 面 将 以 Struts 2 默认 的 文件 上 传 支持 为 例 ， 详 细 介绍 


FE Struts 2 文件 上 传 相关 方面 的 知识 。 
> >4.3.2 实现 文件 上 传 的 Action 

zi 

a Um- 假设 有 如 图 4.22 所 示 的 文件 上 传 页 面 , 其 中 包含 两 个 表 


单 域 : 文件 标题 和 文件 域 一 一 当然 ， 为 了 能 完成 文件 上 传 ， 
我 们 应 该 将 这 两 个 表单 域 所 在 表单 的 enctype 属性 设置 为 
“multipart/form-data”。 该 页 面 的 代码 如 下 。 

程序 清单 :codes\04\4.3\simpleUpload\WEB-INF\content\upload.jsp 

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
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<$etaglib prefix="s" uri="/struts-tags"s> 
<1DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http: //www.w3.0rg/TR/xhtml1/DTD/xhtmll1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtmln> 
<head> 
<title> 简 单 的 文件 上 传 </title> 
</head> 
<body> 
<s:form action="uploadPro" 
enctype="multipart/form-data"> 
<s:textfield name="title” 1abel=" 文 件 标题 "/><br /> 
<s:file name="upload"” label=" 选 择 文件 "/><br /> 
<s:submit value=" 上 传 "/> 
</s:form> 
</body> 
</html> 


上 面 的 页 面 使 用 了 Struts 2 的 标签 库 来 生成 上 传 文件 的 表单 ， 其 中 <s:file.… 户 用 于 生成 一 个 文件 上 
传 域 。 当 该 页 面 提交 请 求 时 ， 请 求 发 送 到 uploadPro.action， 这 是 Struts 2 的 一 个 Action。 
Struts 2 的 Action 无 须 负责 处 理 HttpServletRequest 请 求 ， 正 如 前 面 介 绍 的 ，Struts 2 的 Action 已 经 
与 ServletAPI 彻底 分 离 了 , Struts 2 框架 负责 解析 HttpServletRequest 请 求 中 的 参数 , 包括 文件 域 , Struts 
2 使 用 File 类 型 来 封装 文件 域 。 下 面 是 处 理 上 传 请 求 的 Action 类 代码 。 
程序 清单 :codes\04\4.3\simpleUpload\WEB-INF\src\org\crazyit\app\action\UploadAction.java 
public class UploadAction extends Actionsupport 


{ 
// 封 装 文件 标题 请 求 参数 的 属性 
private String title; 
// 封 装 上 传 文件 域 的 属性 
private File upload; 
// 圭 装 上 传 文件 类 型 的 属性 
Private String uploadContentType; 
// 封 装 上 传 文件 名 的 属性 
Private String uploadFileName; 
// 直 接 在 struts.xml 文件 中 配置 的 属性 
private String savePathy 
// 接 受 struts .xml 文件 配置 值 的 方法 
public void setSavePath(String value) 
上 
this.savePath = value; 


} 
7/ 返回 上 传 文件 的 保存 位 置 
private String getSavepath() throws Exception 
长 
return ServletActionContext.getServletContext () 
.getRealPath ("/WEB-INF/" + savePath); 


} 
// 文 件 标题 的 setter 和 getter 方法 
public void setTitle(String title) 
上 
this.title = title; 
} 
public String getTitle() 
{ 


return (this.title); 


} 
/1 上 传 文件 对 应 文件 内 容 的 setter 和 getter 方法 
public void setUpload(File upload) 
{ 
this.upload = upload; 


} 
public File getUpload() 
{ 
return (this.upload); 
上 
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/4 上 传 文件 的 文件 类 型 的 setter 和 getter 方法 
public void setUploadContentType (String uploadContentType) 


{ 
this.uploadContentType = uploadContentType; 


} 
public String getUploadContentTypet) 


return (this.uploadContentType); 


} 
// 上 传 文件 的 文件 名 的 setter 和 getter 方法 
public void setUploadFileName (String uploadFileName) 


{ 
this.uploadFileName = uploadFileName; 


} 
public String getUploadFileName() 
{ 
return (this.uploadFileName); 
} 
eoverride 
public String execute() throws Exception 


{ 

// 以 服务 器 的 文件 保存 地 址 和 原文 件 名 建立 上 传 文件 输出 流 

FileOutputSstream fos = new FileOutputstream(getSavePath() 
+ "\\" + getUploadFileName ()); 

FileInputStream fis = new FileInputStream(getUpload()); 

byte[] buffer = new byte[1024]; 

int len = 0; 

while {(len = fis.read(buffer)) > 0) 

{ 
fos.writelbuffer , 0 , len); 


} 
return SUCCESS; 
} 
} 


上 面 的 Action 与 普通 的 Action 并 没有 太 大 的 不 同 ， 一 样 提供 了 upload 和 title 两 个 属性 ， 这 两 个 
属性 分 别 对 应 前 面 的 两 个 表单 域 的 name 属性 ， 用 于 封装 两 个 表单 域 的 请 求 参 数 。 

值得 注意 的 是 ， 上 面 的 Action 还 包含 了 两 个 属性 : uploadFileName 和 uploadContentType (如 上 粗 
体 字 代码 所 示 )， 这 两 个 属性 分 别 用 于 封装 上 传 文件 的 文件 名 、 上 传 文件 的 文件 类 型 。 这 两 个 属性 ， 体 
现 了 Struts 2 设计 的 灵巧 、 简 化 之 处 ，Action 类 直接 通过 File 类 型 属性 直接 封装 了 上 传 文件 的 文件 内 
容 ， 但 这 个 File 属性 无 法 获取 上 传 文件 的 文件 名 和 文件 类 型 ， 所 以 Struts 2 直接 将 文件 域 中 包含 的 上 
传 文件 名 和 文件 类 型 的 信息 封装 到 uploadFileName 和 uploadContentType 属性 中 。 可 以 认为 ， 如 果 表 
单 中 包含 一 个 name 属性 为 xxx 的 文件 域 ， 则 对 应 Action 需要 使 用 三 个 属性 来 封装 该 文件 域 的 信息 。 

> ”类 型 为 File 的 xx 属性 封装 了 该 文件 域 对 应 的 文件 内 容 。 

> ”类 型 为 String 的 xxxFileName 属性 封装 了 该 文件 域 对 应 的 文件 的 文件 名 。 

> ”类 型 为 String 的 xxxContentType 属性 封装 了 该 文件 域 对 应 的 文件 的 文件 类 型 。 

通过 上 面 的 3 个 属性 ， 可 以 更 简单 地 实现 文件 上 传 ， 所 以 在 execute 方法 中 ， 可 以 直接 通过 调用 
getXxx() 方 法 来 获取 上 传 文件 的 文件 名 、 文 件 类 型 和 文件 内 容 。 

除 此 之 外 ， 上 面 的 Action 中 还 包含 了 一 个 savePath 属性 ， 该 属性 的 值 通 过 配置 文件 来 设置 ， 从 而 
允许 动态 设置 该 属性 的 值 。 


Struts 2 的 Action 中 的 属性 ， 功 能 非常 丰富 ,除了 可 以 用 于 封装 HTTP 请 求 参数 外 ， 也 
可 以 卦 装 Action 的 处 理 结果 。 不仅 如 此 ，Action 的 属性 还 可 通过 在 Struts 2 配置 文件 中 进 | 
| 。 行 配置 ， 接 收 Struts 2 框架 的 注入 ， 克 许 在 配置 文件 中 为 该 属性 动态 指定 值 。 j 
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>>4.3.3 配置 文件 上 传 的 Action 


配置 Struts 2 文件 上 传 的 Action 与 配置 普通 Action 并 没有 太 大 的 不 同 ， 一 样 是 指定 该 Action 的 
name， 以 及 该 Action 的 实现 类 。 当 然 ， 还 应 该 为 该 Action 配置 <result .…. 信 元素。 与 之 前 的 Action 配置 
存在 的 一 个 小 小 区 别 是 , 该 Action 还 配置 了 一 个 <param .… 记 元素, 该 元 素 用 于 为 该 Action 的 属性 动态 
分 配属 性 值 。 

下 面 是 该 应 用 的 struts.xml 配置 文件 代码 。 

程序 清单 : codes\04W4.3\simpleUpload\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts,apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.custom.ilBn.resources" value="mess"/> 
<!-- 设置 该 应 用 使 用 的 解码 集 --> 
<constant name="struts.il8n.encoding" value="GBK"/> 
<package name="lee" extends="struts-default"> 
<!-- 配置 处 理 文件 上 传 的 Action --> 
<action name="uploadPro" class="org.crazyit.app.action.UploadAction"> 
<!-- 动态 设置 Action 的 属性 值 --> 
<param name="savePath">/upload</param> 
<!-- 配置 Struts 2 默认 的 视图 页 面 --> 
<result>/WEB-INF/content/succ. jsp</result> 
</action> 
<action name="*"> 
<result>/WEB-INF/content/{1).jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 配置 文件 除了 使 用 <param .…/> 元 素 设 置 了 uploadAction 的 savePath 属性 值 外 ， 与 前 面 的 
Action 几乎 完全 一 样 一 一 这 再 次 体现 了 Struts 2 的 简单 设计 。 

配置 了 该 Web 应 用 后 ， 如 果 我 们 在 如 图 4.32 所 示 的 页 面 中 输入 文件 标题 ， 并 浏览 到 需要 上 传 的 
文件 ， 然 后 单 击 “ 上 传 ”按钮 ， 该 上 传 请 求 将 被 UploadAction 处 理 ， 处 理 结束 后 转 入 suce.jsp 页 面 ， 
该 页 面 使 用 了 简单 的 Struts 2 标签 来 显示 上 传 的 图 片 。suce.jsp 页 面 的 代码 如 下 。 

程序 清单 : codes\04\4.3\simpleUpload\WEB-INF\content\succ.jsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %> 
<%@taglib prefix="s" uri="/struts-tags"®> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://wuw.w3.0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> yy 
<title> 上 传 成 功 </title> 全 > 内 
</head> 
<body> 
上 传 成 功 !<br/> 
文件 标题 :<s:property value=" + title"/><br/> 
文件 为 ，<img src="<s:property value="'uploadFiles/' 
+ uploadFileName"/>"/><br/> 


</body> 
</html> 


的 将 看 到 如 图 4.23 所 示 的 页 面 。 


得 天 注意， 上 一 
上 面 我 们 上 传 时 把 文件 保存 到 服务 器 时 文件 的 文件 名 依 没有 发 生 改 变 ， 这 在 实 
际 项 目 中 需要 改进 ， 因 为 多 个 用 户 并 发 上 传 时 可 能 发 生 文件 名 相同 的 情形 ， 因 此 建议 使 by 


用 java.util.UUID 工具 类 来 生成 唯一 的 文件 名 。 
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图 4.23 上 传 成 功 页 面 
通过 上 面 的 开发 过 程 ， 不 难 发 现 通过 Struts 2 实现 文件 上 传 确实 是 一 件 简单 的 事情 。 只 要 我 们 将 
文件 域 与 Action 中 一 个 类 型 为 File 的 属性 关联 ,就 可 以 轻松 访问 到 上 传 文件 的 文件 内 容 一 至于 Struts 
2 使 用 何 种 Multipart 解析 器 ， 对 开发 者 完全 透明 。 
和 四 
Struts 2 实现 文件 上 传 的 编程 关键 ， 就 是 使 用 了 三 个 属性 来 封装 文件 域 ， 其 中 一 个 
Fen 用 于 封装 该 文件 的 文件 名 ， 一 个 用 于 封装 该 文件 的 文件 类 型 ， 一 个 用 于 封装 该 文件 的 文 | 


》>>4.3.4 手动 实现 文件 过 滤 


大 部 分 时 候 ，Web 应 用 不 允许 浏览 者 自由 上 传 ， 尤 其 不 能 允许 上 传 可 执行 性 文件 一 一 因为 可 能 是 
病毒 程序 。 通常 ， 我 们 可 以 允许 浏览 者 上 传 图 片 、 上 传 压缩 文件 等 ， 除 此 之 外 ， 还 必须 对 浏览 者 上 传 
的 文件 大 小 进行 限制 。 因 此 必须 在 文件 上 传 中 进行 文件 过 滤 。 

从 上 面 的 Action 中 可 以 看 出 ，Action 内 有 两 个 方法 分 别 用 于 获取 文件 类 型 和 文件 大 小 。 为 了 实现 
文件 过 滤 ， 完 全 可 以 通过 判断 这 两 个 方法 的 返回 值 来 实现 文件 过 滤 。 在 这 种 方式 下 ， 程 序 员 获 取 全 部 
的 过 滤 控 制 权利 。 

如 果 需 要 手动 实现 文件 过 滤 ， 可 按 如 下 步骤 进行 。 

人 @ 在 Action 中 定义 一 个 专用 于 进行 文件 过 滤 的 方法 ， 该 方法 的 方法 名 字 是 任意 的 ， 该 方法 的 好 
辑 就 是 判断 上 传 文件 的 类 型 是 否 为 允许 类 型 。 例 如 增加 filterTypes0 方 法 ， 方 法 代码 如 下 。 

程序 清单 : codes\04\4.3\codeFilteWEB-INF\src\org\crazyit\app\action\UploadAction.java 

: 过 滤 文 件 类 型 

* @param types 系统 所 有 人 允许 上 传 的 文件 类 型 

* ereturn 如 果 上 传 文件 的 文件 类 型 允许 上 传 ， 

二 返回 null， 和 否则 返回 error 字符 串 

人 String filterTypes (String[] types) 


{ 
// 获 取 希 望 上 传 的 文件 类 型 
String fileType = getUploadContentType(); 
for (String type : types) 
{ 
if (type.equals (fileType)) 
{ 
return null; 
} 
} 
return ERROR; 
} 


人 @ 上 面 的 方法 判断 了 上 传 文件 的 文件 类 型 是 否 在 允许 上 传 文件 类 型 列表 中 。 为 了 让 应 用 程序 可 
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以 动态 配置 允许 上 传 的 文件 列表 , 为 该 Action 增加 了 一 个 allowTypes 属性 , 该 属性 的 值 列 出 了 所 有 人 允 
许 上 传 的 文件 类 型 。 为 了 可 以 在 struts.xml 文件 中 配置 alowTypes 属性 的 值 ， 必 须 在 Action 类 中 提供 
如 下 代码 。 
程序 清单 : codes\04\4.3\codeFilter\WWEB-INF\src\org\crazyit\app\action\UploadAction.java 
// 定 义 该 Action 允许 上 传 的 文件 类 型 
Private String allowTypes; 
//allowTypes 属性 的 setter 和 getter 方法 
public String getAllowTypes() 各 
{ 
return allowTypes; 
} 
public void setAllowTypes (string allowTypes) 
{ 
this.allowTypes = allowTypes; 
} 


(3) 利用 Struts 2 的 输入 校 验 来 判断 用 户 输入 的 文件 是 否 符合 要 求 。 如 果 不 符合 要 求 ， 接 下 来 就 
将 错误 提示 添加 到 FieldError 中 。 该 Action 中 增加 的 validate() 方 法 代码 如 下 : 
1 codes\04\4.3\codeFilter\WEB-INF\src\org\crazyitapp\action\UploadAction.java 


// 执 行 输入 校 验 
Public void validate() 
{ 


7/ 将 允许 上 传 文件 类 型 的 字符 串 以 英文 逗号 (，) 
// 分 解 成 字符 串 数组 从 而 判断 当前 文件 类 型 是 否 允 许 上 伟 
String filterResult = filterType (getAllowTypes().split(",")); 
// 如 果 当前 文件 类 型 不 允许 上 伟 
if (filterResult != null) 
/7/ 添 加 RieldError 
addFieldError ("upload” ，" 您 要 上 传 的 文件 类 型 不 正确 1 ") ; 
} 
} 

上 面 的 validate() 方 法 的 代码 非常 简单 ， 它 调用 了 filterTypes 来 判断 浏览 者 所 上 传 的 文件 是 否 符合 
要 求 , 如 果 不 是 允许 上 传 的 文件 类 型 , validate0 方 法 就 添加 了 FieldError, 这 样 Struts 2 将 自动 返回 input 
逻辑 视图 名 ;只 有 当 该 文件 的 类 型 是 允许 上 传 的 文件 类 型 时 ， 才 真正 执行 文件 上 传 遇 辑 。 

为 了 让 文件 类 型 检验 失败 时 能 返回 input 逻辑 视图 ， 必 须 为 该 Action 增加 input 逻辑 视图 配置 。 经 
过 上 面 的 配置 ， 当 浏览 者 上 传 文件 类 型 为 不 允许 类 型 时 ， 系 统 将 退回 input 逻辑 视图 对 应 的 页 面 。 

修改 后 的 struts.xml 文件 代码 如 下 。 
程序 清单 :codes\04\4.3\codeFilte\WEB-INF\sre\struts.xml 


<!-- 配置 处 理 文件 上 传 的 Action --> 

<action name="uploadPro" class="org.crazyit.app.action.UploadAction"> 
<!-- 动态 设置 Action 的 属性 值 --> 
<param name="savePath">/uploadFiles</param> 
<!-- 设置 允许 上 传 的 文件 类 型 --> 
<param name="allowTypes">image/png, image/gif, image/jpeg</param> 
<result name="input">/WEB-INF/content/upload. jsp</result> 
<!-- 配置 Struts 2 默认 的 视图 页 面 --> 
<result>/WEB-INF/content/succ.jsp</result> 

</action> 


为 了 在 inputjsp 页 面 上 显示 文件 过 滤 失 败 的 错误 提示 , 可 以 在 该 页 面 中 使 用 如 下 代码 输出 错误 提示 。 
<s:fielderror/> 
实现 文件 大 小 过 滤 ， 与 实现 文件 类 型 过 滤 的 方法 基本 相似 。 虽然 在 上 面 的 Action 类 中 并 没有 方法 
直接 获取 上 传 文件 的 大 小 , 但 Action 中 包含 了 一 个 类 型 为 File 的 属性 ,该 属性 封装 了 文件 域 对 应 的 文 
件 内 容 ; 而 File 类 有 一 个 length0 方 法 ,该 方法 可 以 返回 文件 的 大 小 , 通过 比较 该 文件 的 大 小 和 允许 上 
传 的 文件 大 小 ， 从 而 决定 是 否 允许 上 传 该 文件 。 
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Fn 如 果 需 要 实现 文件 大 小 的 过 滤 , 则 可 以 调用 File 类 的 length0 方 法 来 获取 上 传 文件 的 大 
1、 与 多 许 上 传 的 文件 大 小 进行 比较 ， 从 而 决定 是 否 多 许 上 传 。 | 


>>4.3.5 拦截 器 实现 文件 过 渡 


上 面 手动 实现 文件 过 滤 的 方式 虽然 简单 ， 但 毕竟 需要 书写 大 量 的 过 滤 代 码 ， 不 利于 程序 的 高 层次 
解构 ， 而 且 开发 复杂 。 
Struts 2 提供 了 一 个 文件 上 传 的 拦截 器 ， 通 过 配置 该 拦截 器 可 以 更 轻松 地 实现 文件 过 滤 。Struts 2 
中 文件 上 传 的 拦截 器 是 fileUpload， 为 了 让 该 拦截 器 起 作用 ， 只 需要 在 该 Action 中 配置 该 拦截 器 引用 
即 可 。 
配置 fleUpload 拦截 器 时 ， 可 以 为 其 指定 两 个 参数 。 
> ”allowedTypes: 该 参数 指定 允许 上 传 的 文件 类 型 ， 多 个 文件 类 型 之 间 以 英文 逗号 (,) 隔 开 。 
> ”maximumSize: 该 参数 指定 允许 上 传 的 文件 大 小 ， 单 位 是 字 节 。 
通过 配置 fileUpload 的 拦截 器 ， 可 以 更 轻松 地 实现 文件 过 滤 ， 当 文件 过 滤 失 败 后 ， 系 统 自动 转 入 
input 逻辑 视图 , 因此 必须 为 该 Action 配置 名 为 input 的 逻辑 视图 。 除 此 之 外 , 还 必须 显 式 地 为 该 Action 
配置 defaultStack 的 拦截 器 引用 。 
通过 拦截 器 来 实现 文件 过 滤 的 配置 文件 如 下 。 
程序 清单 : codes\04\4.3\autoFilter\WEB-INF\sre\struts.xml 
<?xml version="1.0" encoding-"GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.custom.ilgn.resources" value="mess"/> 
<!-- 设置 该 应 用 使 用 的 解码 集 --> 
<constant name="struts.il8n.encoding" value="GBK"/> 
<package name="lee" extends="struts-default"> 
<!-~ 配置 处 理 文件 上 传 的 Action --> 
<action name="uploadPro" class="org.crazyit.app.action.UploadAction"> 
<!-- 配置 fileUpload 的 拦截 器 --> 
<interceptor-ref name="fileUpload"> 
<1-- 配置 允许 上 传 的 文件 类 型 --> 
<param name="allowedTypes">image/png 
,image/gif, image/jpeg</param> 
<!--~ 配置 允许 上 传 的 文件 大 小 --> 
<param name="maximumSize">2000</param> 
</interceptor-ref> 
<!-~ 配置 系统 默认 的 拦截 器 --> 
<interceptor-ref name="defaultstack"/> 
<!-- 动态 设置 Action 的 属性 值 -> 
<param name="savePath">/uploadFiles</param> 
<!-- 配置 Struts 2 默认 的 视图 页 面 --> 
<result>/WEB-INF/content/succ.jsp</result> 
<result name="input">/WEB-INF/content /upload.jsp</result> 
</action> 
<action name="*"> 
<result>/WEB-INF/content/ {1}.jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 拦截 器 过 滤 不 仅 过 滤 了 文件 的 类 型 , 也 过 滤 了 文件 大 小 。 上 传 文件 的 类 型 只 能 是 图 片 文件 ， 
并 且 文 件 大 小 不 能 大 于 2000 字 节 (当然 , 我 们 随时 可 以 更 改 到 更 大 )。 如 果 我 们 上 传 文件 的 文件 太 大 ， 
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系统 将 转 入 input 逻辑 视图 ， 也 就 是 /WEB-INF/content/upload.jsp 页 面 。 
E 


置 引用 Struts 默认 的 拦截 器 栈 : defaultStack. 而 且 fileUpload 拦截 器 必须 配置 在 
defaultStack 拦截 器 栈 之 前 - 


》>>4.3.6 输出 错误 提示 


如 果 上 传 失败 ， 系 统 返回 input 逻辑 视图 ， 也 就 是 /WEB-INF/content/upload.jsp 页 面 ，Struts 2 的 标 
签 可 以 自动 显示 上 传 失败 的 提示 信息 ， 并 让 浏览 者 重新 上 传 。 

当然 ， 开 发 者 也 可 使 用 <s:fielderror> 来 显 式 输出 上 传 失败 的 校 验 提示 。 

上 面 的 代码 将 会 把 文件 过 滤 失 败 的 信息 显示 在 该 页 面 上 ， 给 用 户 的 重新 上 传 生成 提示 。 如 果 用 户 
上 传 的 文件 大 小 大 于 2000 字 节 ， 将 看 到 如 图 4.24 所 示 的 错误 提示 页 面 。 

上 面 的 提示 信息 是 系统 默认 的 提示 信息 ， 对 于 一 个 中 文 的 Web 应 用 而 言 ， 这 段 英文 提示 信息 非常 
“刺眼 ” 所 以 应 该 使 用 国际 化 信息 替换 它 。 

上 传 文件 太 大 的 提示 信息 的 key 是 “struts.messages.error.file.too.large”"， 如 果 在 自己 的 国际 化 资源 
文件 中 增加 该 key 的 消息 ， 将 可 改变 该 提示 信息 。 


IMD MO RED BRD WE IAD Wm 
| 人 © x Bi 
Bmraaramm 


文件 标题: Rae 
File too large: uplosd “ajar. jpg” 
pload_42961395_12c6758515<_8000_00000009 tap” 11820 
二 文件 im 


mn 
图 4.24 上 传 文件 太 大 的 提示 页 面 


如 果 上 传 文件 的 文件 类 型 不 是 允许 上 传 的 文件 类 型 时 ， 错 误 提示 信息 对 应 国际 化 资源 文件 中 key 
为 “struts.messages.error.content.type.not.allowed” 的 信息 ; 如 果 在 自己 的 国际 化 资源 文件 中 增加 该 key 
的 消息 ， 将 可 改变 文件 类 型 不 允许 的 提示 信息 。 

下 面 是 本 应 用 中 国际 化 资源 文件 的 代码 。 


# 改 变 文件 类 型 不 允许 的 提示 信息 
struts.messages.error.content.type.not.allowed= 您 上 传 的 文件 类 型 只 能 是 图 片 文件 1 
请 重新 选择 ! 

# 改 变 上 传 文件 太 大 的 提示 信息 
struts.messages.error.file.too.1arge= 您 要 上 传 的 文件 太 大 ， 请 重新 选择 ! 


提示 ;…… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
因为 上 面 的 国际 化 资源 文件 中 包含 了 非 西欧 字符 ， 所 以 应 该 使 用 native2ascii 命令 处 理 。 
该 资源 文件 。 
改变 了 默认 提示 信息 后 ， 如 果 上 传 的 文件 太 大 ， 将 看 到 如 图 4.25 所 示 的 页 面 。 
如 果 上 传 了 非 图 片 文件 ， 将 看 到 如 图 4.26 所 示 的 页 面 。 
除 此 之 外 ，Struts 2 还 提供 了 一 个 key 为 “struts.messages.erroruploading” 的 提示 信息 ， 如 果 用 户 


上 传 文件 失败 ， 既 不 是 文件 类 型 不 允许 ， 也 不 是 文件 大 小 超出 允许 大 小 ,而 是 出 现 了 一 个 未 知 的 错误 ， 
则 系统 将 在 提示 页 面 输 出 该 key 对 应 的 消息 。 
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大 从 本 本: 吏 本 w 这 奢 。 
怎 上 传 的 文件 类 型 只 能 是 图 片 文件 1 


[2%] 


图 4.25 改变 默认 文件 太 大 的 提示 信息 图 4.26 上 传 文件 类 型 不 符合 的 提示 信息 
>》4.3.7 文件 上 传 的 常量 配置 


当 每 次 上 传 文件 时 ， 都 可 以 在 Tomcat 的 控制 台 看 见 如 下 所 示 的 输出 信息 : 


INFO (org.apache.struts 2.dispatcher.Dispatcher:624) - Unable to find 'struts, multipart. 
saveDir' property setting. Defaulting to javax,servlet.context. tempdir 

INFO (org.apache.Struts 2.interceptor.FileUploadInterceptor:277) - Removing file Upload 
Di \tomcat5520\work\Catalina\localhost\simpleUpload\ upload 103b2706_112b45dc4a3— 
8000_00000001. tmp 


其 中 第 一 个 提示 信息 说 ， 系 统 找 不 到 struts.multipart.saveDir 属性 的 设置 ， 默 认 使 用 javax.servlet. 
context.tempdir 路 径 ， 这 是 因为 Struts 2 执行 文件 上 传 过 程 中 ， 需 要 指定 一 个 临时 文件 来， 如 果 没 有 指 
定 临时 文件 来， 系统 默认 使 用 javax.servletcontexttempdir， 在 Tomcat 安装 路 径 下 的 work\Catalina\ 
localhost\ 路 径 下 。 

第 二 个 提示 信息 说 ， 系 统 正在 删除 一 个 临时 文件 ， 该 临时 文件 就 是 上 传 过 程 中 产生 的 临时 文件 。 

如 果 为 了 避免 文件 上 传 时 使 用 Tomcat 的 工作 路 径 作为 临时 路 径 ， 则 应 该 设置 
struts.multipart.saveDir 属性 。 设 置 该 属性 既 可 以 通过 struts.properties 文件 设置 ， 也 可 以 通过 struts.xml 
文件 的 常量 配置 。 

除 此 之 外 ， 还 有 一 个 文件 上 传 的 属性 : struts.multipart maxSize， 该 属性 设置 整个 表单 请 求 内 容 的 
最 大 字 节 数 。 


4.4 使 用 Struts 2 控制 文件 下 载 


Struts 2 提供 了 stream 结果 类 型 ， 该 结果 类 型 就 是 专门 用 于 支持 文件 下 载 功能 的 。 指 定 stream 结 
果 类 型 时 ， 需 要 指定 一 个 inputName 参数 ， 该 参数 指定 了 一 个 输入 流 ， 这 个 输入 流 是 被 下 载 文件 的 入 
口 。 通 过 Struts 2 的 文件 下 载 支持 ， 允 许 系统 控制 浏览 者 下 载 文件 的 权限 ， 包 括 实现 文件 名 为 非 西欧 
字符 的 文件 下 载 。 


>>4.4.1 实现 文件 下 载 的 Action 


可 能 很 多 读者 会 觉得 ， 文 件 下 载 太 简单 ， 直 接 在 页 面 上 给 出 一 个 超级 链接 ， 该 链接 的 href 属性 等 
于 要 下 载 文件 的 文件 名 ， 不 就 可 以 实现 文件 下 载 了 吗 ? 大 部 分 时 候 的 确 可 以 实现 文件 下 载 ， 但 如 果 该 
文件 的 文件 名 为 中 文 文件 名 , 则 会 导致 下 载 失败 ; 如 果 应 用 程序 需要 在 用 户 下 载 之 前 进行 进一步 检查 ， 
比如 判断 用 户 是 否 有 足够 权限 来 下 载 该 文件 等 ， 那 么 就 需要 让 Struts 2 来 控制 下 载 了 。 

看 下 面 的 一 个 原始 的 下 载 页 面 代码 片段 。 

程序 清单 : codes\04\4.4\down\rawDown.html 

<h1> 原 始 的 下 载 </h1> 


<ul> 
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<li> 
下 载 疯狂 Java 联盟 的 Logo: 
<a href="images/ 疯 狂 联 盟 . jpg"> 下 载 图 形 文件 </a> 
</li> 


<li> 
下 载 疯狂 Java 联盟 的 Logo 的 压缩 文件 : 
<a href="images/wjc_logo.zip"> 下 载 压缩 文件 </a> 
</1i> 
</ul> 


上 面 的 页 面包 含 两 个 下 载 的 超级 链接 ， 两 个 链接 的 资源 都 是 存在 的 ， 但 因为 第 一 个 资源 文件 的 文 
件 名 是 中 文 文件 名 ， 如 果 单 击 第 一 个 超级 链接 ， 将 出 现 如 图 4.27 所 示 的 页 面 。 


2M WD E60 Fe® ED IAD Wo 


HTTP Status 404 - /down/images/%E7%96 
ooAFooE7%8Bes%o82%E8%819%o94%oE7 


lo9Bo%o9F,jpg 


em 


ae 


Te 
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图 4.27 文件 名 为 中 文 时 下 载 失败 


从 图 4.27 所 示 页 面 中 椭圆 形 框 包围 的 地 方 ,我 们 看 到 被 下 载 的 文件 名 变 成 了 包含 大 量 % 的 字符 串 ， 
很 明显 ， 这 种 文件 名 显然 无 法 取得 需要 下 载 的 文件 。 

为 了 解决 这 个 问题 ， 我 们 使 用 Struts 2 的 文件 下 载 支持 来 下 载 该 文件 。 

Struts 2 的 文件 下 载 Action 与 普通 的 Action 并 没有 太 大 的 不 同 ， 仅 仅 是 该 Action 需要 提供 一 个 返 
回 InputStream 流 的 方法 ， 该 输入 流 代表 了 被 下 载 文件 的 入 口 。 该 Action 类 的 代码 如 下 。 

程序 清单 : codes\04\4.4\down\WEB-INF\sre\org\crazyit\applaction\FileDownloadAction.java 

public class FileDownloadAction 

extends ActionSupport 


7/ 该 属性 可 以 在 配置 文件 中 动态 指定 该 属性 值 
private String inputPath; 


// 依 赖 注入 该 属性 值 的 setter 方法 
public void setInputPath(String value) 


{ 


inputPath = value; 
} 
/* 
定义 一 个 返回 InputStream 的 方法 ， 
该 方法 将 作为 被 下 载 文件 的 入 口 ， 
且 需 要 配置 stream 类 型 结果 时 指定 inputName 参数 ， 
opens 参数 的 值 就 是 方法 去 掉 get 前 级 、 首 字母 小 写 的 字符 串 
Public Inputstream getTargetFile() throws Exception 
{ 


//Servletcontext 提供 getResourceAsstream() 方 法 


// 返 回 指定 文件 对 应 的 输入 流 
return ServletActionContext.getServletContext () 


.getResourcehsStream (inputPath) ; 
} 
} 


从 上 面 的 Action 中 看 到 , 该 Action 中 包含 了 一 个 getTargetFile0 方 法 , 该 方法 返回 一 个 InputStream 
输入 流 ， 这 个 输入 流 返回 的 是 下 载 目 标 文件 的 入 口 。 该 方法 的 方法 名 为 getTargetFile， 则 stream 类 型 
的 结果 映射 中 inputName 参数 值 为 argetFile。 
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一 旦 我 们 定义 了 该 Action， 就 可 通过 该 Action 来 实现 文件 下 载 。 
>》>4.4.2 配置 Action 


配置 该 文件 下 载 的 Action 与 配置 普通 的 Action 并 没有 太 大 的 不 同 ， 关 键 是 需要 配置 一 个 类 型 为 
stream 的 结果 ， 该 stream 类 型 的 结果 将 使 用 文件 下 载 作为 响应 。 配置 stream 类 型 的 结果 需要 指定 如 下 
4 个 属性 。 

> ”contentType: 指定 被 下 载 文件 的 文件 类 型 。 

> inputName: 指定 被 下 载 文件 的 入 口 输入 流 。 

> ”contentDisposition: 指定 下 载 的 文件 名 。 

> ”bufferSize: 指定 下 载 文件 时 的 缓冲 大 小 。 

eaini 结 果 类 型 的 还 半袖 国 是 返回 入 兴 户 卉 -个 输入 流 ， 


因此 无 须 指定 location 属性 。 


Fo 生生 arcam 类 型 的 结果 时 ， 因为 无 须 指定 实际 显示 的 物理 资源 , 所 以 无 须 指 定 location | 
属性 


只 需要 指定 inputName 属性 即 可 ， 该 属性 代表 被 下 载 文件 的 入 口 。 


下 面 是 配置 该 下 载 所 用 的 Action 类 的 配置 文件 片段 。 
程序 清单 :codes\04\4.4\down\WEB-INF\sre\struts.xml 
<action name="download" class="org.crazyit.app.action.FileDownloadAction"> 
<!-- 指定 被 下 载 资源 的 位 置 --> 
<param name="inputPath">\images\ 首 狂 联 盟 .jpg</param> 
<!-- 配置 结果 类 型 为 stream 的 结果 --> 
<result name="success" type="stream"> 
<!-- 指定 下 载 文件 的 文件 类 型 --> 
<param name="contentType">image/jpg</param> 
<!-- 指定 由 getTargetFile () 方 法 返回 被 下 载 文 件 的 Inputstream --> 
<param name="inputName">targetFile</param> 
<param name="contentDisposition">filename="wjc_logo. jpg"</param> 
<!-- 指定 下 载 文件 的 缓冲 大 小 -> 
<param name="bufferSize">4096</param> 
</result> 
</action> 


如 果 通 过 上 面 的 Struts 2 提供 文件 下 载 支持 来 实现 文件 下 载 ， 就 可 以 实现 包含 中 文 文件 名 的 文件 
下 载 了 。 


》>>4.4.3 下 载 前 的 授权 控制 


通过 Struts 2 的 下 载 支持 ， 应 用 程序 可 以 在 用 户 下 载 文件 之 前 ， 先 通过 Action 来 检查 用 户 是 否 有 
权 下 载 该 文件 ， 就 可 以 实现 下 载 前 的 授权 控制 。 

下 面 的 Action 的 execute 方法 在 返回 success 字符 串 之 前 ， 首 先 通过 判断 session 里 的 user 属性 是 
否 为 scott， 如 果 用 户 名 通过 验证 就 允许 下 载 ， 否 则 直接 返回 登录 页 面 。 下 面 是 该 Action 类 的 代码 。 

程序 清单 : codes\04\4.4\down\WEB-INF\src\org\crazyit\app\action\AuthorityDownAction.java 


Public class AuthorityDownAction 
implements Action 


{ 
private string inputPath; 
public void setInputPath(String value) 
{ 
inputPath = value; 
上 


public InputStream getTargetFile() throws Excéption 
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{ 
//ServletContext 提供 getResourceAsStream() 方 法 
// 返 回 指定 文件 对 应 的 输入 流 
return ServletActionContext.getServletContext() 
getResourceAsSstream (inputPath); 
1 


Public String execute() throws Exception 


// 取 得 ActionContext 实例 
ActionContext ctx = ActionContext.getContext (); 
// 通 过 ActionContext 访问 用 户 的 HttpSsession 
Map session = ctx.getSession(); 
String user = (String)session.get("user"); 
// 判 断 Session 里 的 user 是 否 通过 检查 
if ( user != null 566 user.equals("crazyit.org")) 
{ 
return SUCCESS; 


3 
ctx.put ("tip™" 
，“" 您 还 没有 登录 ， 或 者 登录 的 用 户 名 不 正确 ， 请 重新 登录 !") ; 
return LOGIN; 
} 
} 


因为 上 面 的 Action 在 登录 校 验 失 败 后 ， 将 返回 一 个 login 逻辑 视图 名 ， 因 此 配置 该 Action 时 还 必 
须 配 置 一 个 名 为 login 的 结果 ， 这 个 结果 类 型 就 是 默认 结果 类 型 。 下 面 是 配置 该 Action 的 配置 片段 。 

程序 清单 : codes\04\4.4\down\WEB-INF\src\struts.xml 

<action name="download2" class="org.crazyit.app.action.AuthorityDownAction"> 


<!-- 定义 被 下 载 文件 的 物理 资源 --> 
<param name="inputPath">\images\wjc_logo.zip</param> 
<result name="success" type="stream"> 
<!-- 指定 下 载 文件 的 文件 类 型 --> 
<param name="contentType">application/zip</param> 
<!-- 指定 由 getTargetEFile1) 方 法 返回 被 下 载 文件 的 InputStream --> 
<param name="inputName">targetFile</param> 
patan nanen"contentDisposition">+1ename"wie 1ogo: zip"</paran> 
<!-~ 指定 下 载 文件 的 缓冲 大 小 一 > 
<param name="buffersize”>4096</param> 
</result> 
<!-- 定义 一 个 名 为 1ogin 的 结果 --> 
<result name="login">/WEB-INF/content/login.jsp</result> 
</action> 


上 面 的 Action 在 下 载 前 先进 行 权限 检查 ， 如 果 要 下 载 文件 的 浏览 者 还 没有 登录 , 或 者 登录 用 的 用 
户 名 不 是 crazyit.org, Action 将 会 返回 一 个 名 为 input 的 视图 名 ,该 视图 映射 到 /WEB-INF/content/login.jsp 
页 面 。 如 果 不 登录 系统 ， 试 图 通过 单 击 超级 链接 来 下 载 该 资源 ， 将 看 到 如 图 4.28 所 示 的 登录 页 面 。 


图 4.28 下 载 前 的 登录 页 面 


为 了 能 看 到 如 图 4.28 所 示 的 登录 页 面 ,我 们 必须 为 系统 编写 login.jsp 页 面 ， 该 页 面 就 是 一 个 简单 
的 登录 表单 页 。login.jsp 页 面 保存 在 codes\04\4.4\down\WEB-INF\content 路 径 下 。 
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通过 在 如 图 4.28 所 示 页 面 的 用 户 名 输入 框 中 输入 crazyit.org 字符 串 ， 并 单 击 “ 登 录 ” 按 钮 ， 将 提 
交 该 登录 请 求 〈 该 请 求 对 应 的 Action 将 完成 简单 登录 )， 一 旦 完成 了 正常 登录 ， 用 户 的 session 里 user 
属性 的 值 为 crazyit.org 后 ， 文 件 下 载 将 完全 正常 。 


4.5 详解 Struts 2 的 拦截 器 机 制 


拦截 器 体系 是 Struts 2 框架 的 重要 组 成 部 分 ， 我 们 可 以 把 Struts 2 理解 成 一 个 空 容器 ， 而 大 量 的 内 
建 拦截 器 完成 了 该 框架 的 大 部 分 操作 。 比如 , params 拦截 器 负责 解析 HTTP 请 求 的 参数 , 并 设置 Action 
的 属性 ，servlet-config 拦截 器 直接 将 HTTP 请 求 中 的 HttpServletRequest 实例 和 HttpServletResponse 实 
例 传 给 Action，fileUpload 拦截 器 则 负责 解析 请 求 参数 中 的 文件 域 ， 并 将 一 个 文件 域 设 置 成 Action 的 
三 个 属性 …… 这 些 通用 操作 都 是 通过 Struts 2 的 内 建 拦截 器 完成 的 。 

Struts 2 拦截 器 是 可 插 拔 式 的 设计 : 如 果 我 们 需要 使 用 某 个 拦截 器 ， 只 需要 在 配置 文件 中 应 用 该 拦 
截 器 即 可 ;如 果 不 需 要 使 用 该 拦截 器 ， 只 需要 在 配置 文件 中 取消 应 用 该 拦截 器 一 一 不 管 是 否 应 用 某 个 
拦截 器 ， 对 于 Struts 2 框架 不 会 有 任何 影响 。 

Struts 2 拦截 器 由 struts-default.xml、struts.xml 等 配置 文件 进行 管理 ， 所 以 开发 者 很 容易 扩展 自己 
的 拦截 器 ， 从 而 可 以 最 大 限度 地 扩展 Struts 2 框架 。 


> >4.5.1 拦截 器 在 Struts 2 中 的 作用 


对 于 任何 MVC 框架 来 说 ， 它 们 都 会 完成 一 些 通用 的 控制 逻辑 ， 例 如 解析 请 求 参 数 ， 类 型 转换 ， 
将 请 求 参数 封装 成 DTO〔Data Transfer Object)， 执 行 输入 校 验 ， 解 析 文件 上 传 表 单 中 的 文件 域 ， 防 止 
表单 的 多 次 提交 …… 像 早期 的 Struts1 框架 把 这 些 动作 都 写 死 在 系统 的 核心 控制 器 里 , 这 样 做 的 缺点 有 
如 下 两 个 。 
> ”灵活 性 非常 差 ， 这 种 框架 强制 所 有 项 目 都 必须 使 用 该 框架 提供 的 全 部 功能 ， 不 管用 户 是 否 需 
要 ， 核 心 控制 器 总 是 会 完成 这 些 操 作 。 
> 可 扩展 性 很 差 ， 如 果 用 户 需 要 让 核心 控制 器 完成 更 多 自 定义 的 处 理 ， 这 就 比较 困难 了 。 在 
Struts1 时 代 我 们 都 是 通过 扩展 Struts1 的 核心 控制 器 来 实现 的 。 
Struts 2 改变 了 这 种 做 法 , 它 把 大 部 分 核心 控制 器 需要 完成 的 工作 按 功 能 分 开 定义 ,每 个 拦截 器 完 
成 一 个 功能 。 而 这 些 拦截 器 可 以 自由 选择 ， 灵 活 组 合 (甚至 不 用 Struts 2 的 任何 拦截 器 )， 开 发 者 需要 
使 用 哪些 拦截 器 ， 只 需要 在 struts.xml 文件 中 指定 使 用 该 拦截 器 即 可 。 
Struts 2 框架 的 绝 大 部 分 功能 都 是 通过 拦截 器 来 完成 的 ， 当 StrutsPrepareAndExecuteFilter 拦截 到 用 
户 请 求 之 后 ， 大 量 拦截 器 将 会 对 用 户 请 求 进行 处 理 ， 然 后 才 会 调用 用 户 开 发 的 Action 实例 的 方法 来 处 
理 请 求 。 拦 截 器 与 Action 之 间 的 关系 如 图 4.29 所 示 。 
可 能 有 读者 会 提出 疑问 ,前面 介绍 的 很 多 示例 似乎 从 未 使 用 过 任何 拦截 器 ， 为 什么 我 们 的 应 用 能 
够 运行 呢 ? 实际 上 ，Struts 2 已 经 默认 启用 了 大 量 通用 功能 的 拦截 器 ， 只 要 我 们 配置 Action 的 package 
继承 了 struts-default 包 ， 这 些 拦截 器 就 会 起 作用 。 


>>4.5.2 Struts 2 内 建 的 拦截 器 


从 Struts 2 框架 来 看 ， 拦 截 器 几乎 完成 了 Struts 2 框架 70% 的 工作 ， 包 括 解析 请 求 参 数 ， 将 请 求 参 
数 赋值 给 Action 属性 ， 执 行 数据 校 验 ， 文 件 上 传 ……Struts 2 设计 的 灵巧 性 ， 更 大 程度 地 得 益 于 拦截 
器 设计 ， 当 需要 扩展 Struts 2 功能 时 ， 只 需要 提供 对 应 拦截 器 ， 并 将 它 配置 在 Struts 2 容器 中 即 可 ;如 
果 不 需 要 该 功能 ， 也 只 需要 取消 该 拦截 器 的 配置 即 可 。 这 种 可 插 拔 式 的 设计 ， 正 是 软件 设计 领域 一 直 
扑 孜 以 求 的 目标 。 
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sutsprepareAndExecutorFater 初 冶 化 一 个 
ActionProxy 详 例 ， 并 届 用 它 的 execute 方 法 


La] 


图 4.29 拦截 器 与 Action 的 关系 


Struts 2 内 建 了 大 量 的 拦截 器 , 这 些 拦截 器 以 name-class 对 的 形式 配置 在 struts-default xml 文件 中 ， 
其 中 name 是 拦截 器 的 名 字 ， 就 是 以 后 使 用 该 拦截 器 的 唯一 标识 ， class 则 指定 了 该 拦截 器 的 实现 类 ， 
如 果 我 们 定义 的 package 继承 了 Struts 2 的 默认 struts-default 包 ， 则 可 以 自由 使 用 下 面 定义 的 拦截 器 ， 
否则 必须 自己 定义 这 些 拦截 器 。 


下 面 是 Struts 2 内 建 
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截 器 的 简要 介绍 。 

alias: 实现 在 不 同 请 求 中 相似 参数 别名 的 转换 。 

autowiring: 这 是 个 自动 装配 的 拦截 器 ， 主 要 用 于 当 Struts 2 和 Spring 整合 时 ，Struts 2 可 
以 使 用 自动 装配 的 方式 来 访问 Spring 容器 中 的 Bean。 

chain: 构建 一 个 Action 链 ， 使 当前 Action 可 以 访问 前 一 个 Action 的 属性 ， 一 般 和 <result 
type="chain" /> 一 起 使 用 。 

conversionError: 这 是 一 个 负责 处 理 类 型 转换 错误 的 拦截 器 ， 它 负责 将 类 型 转换 错误 从 
ActionContext 中 取出 ， 并 转换 成 Action 的 FieldError 错误 。 

createSession: 该 拦截 器 负责 创建 一 个 HttpSession 对 象 , 主要 用 于 那些 需要 有 HttpSession 
对 象 才能 正常 工作 的 拦截 器 中 。 

debugging: 当 使 用 Struts 2 的 开发 模式 时 ， 这 个 拦截 器 会 提供 更 多 的 调试 信息 。 
execAndWait， 后 台 执 行 Action， 负 责 将 等 待 画 面 发 送 给 用 户 。 

exception: 这 个 拦截 器 负责 处 理 异常 ， 它 将 异常 映射 为 结果 。 

fileUpload: 这 个 拦截 器 主要 用 于 文件 它 负 责 解析 表单 中 文件 域 的 内 容 。 

it8n: 这 是 支持 国际 化 的 拦截 器 ， 它 负责 把 所 选 的 语言 、 区 域 放 入 用 户 Session 中 。 

logger: 这 是 一 个 负责 日 志 记录 的 拦截 器 ， 主 要 是 输出 Action 的 名 字 。 

model-driven: 这 是 一 个 用 于 模型 驱动 的 拦截 器 ， 当 某 个 Action 类 实现 了 ModelDriven 接口 
时 ， 它 负责 把 getModel() 方 法 的 结果 堆 入 ValueStack 中 。 

scoped-model-driven: 如 果 一 个 Action 实现 了 一 个 ScopedModelDriven 接口 ， 该 拦截 器 负责 
从 指定 生存 范围 中 找 出 指定 的 Model， 并 将 通过 setModel 方法 将 该 Model 传 给 Action 实例 。 
params: 这 是 最 基本 的 一 个 拦截 器 ， 它 负责 解析 HTTP 请 求 中 的 参数 ， 并 将 参数 值 设置 成 
Action 对 应 的 属性 值 。 

prepare: 如 果 action 实现 了 Preparable 接口 ， 将 会 调用 该 拦截 器 的 prepare() 方 法 。 
static-params: 这 个 拦截 器 负责 将 xml 中 <action> 标 签 下 <param> 标 签 中 的 参数 传 入 action 。 
scope: 这 是 范围 转换 拦截 器 ， 它 可 以 将 Action 状态 信息 保存 到 HttpSession 范围 ， 或 者 保 
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存 到 ServletContext 范围 内 。 
> et ong 如 果菜 个 Action 需要 直接 访问 Servlet API， 就 是 通过 这 个 拦截 器 实现 的 。 


| 


> _roles: 这 是 一 个 JAAS (Java Authentication and Authorization Service，Java 授权 和 认证 
服务 ) 拦截 器 ， 只 有 当 浏 览 者 取得 合适 的 授权 后 ， 才 可 以 调用 被 该 拦截 器 拦截 的 Action 。 

> timer: 这 个 拦截 器 负责 输出 Action 的 执行 时 间 ， 这 个 拦截 器 在 分 析 该 Action 的 性 能 瓶颈 时 
比较 有 用 。 

> ”token: 这 个 拦截 器 主要 用 于 阻止 重复 提交 ， 它 检查 传 到 Action 中 的 token， 从 而 防止 多 次 
提交 。 

> “token-session: 这 个 拦截 器 的 作用 与 前 一 个 基本 类 似 , 只 是 它 把 token 保存 在 HttpSession 中 。 

> “validation: 通过 执行 在 xxxAction-validation.xml 中 定义 的 校 验 器 ， 从 而 完成 数据 校 验 。 

> ”workflow: 这 个 拦截 器 负责 调用 Action 类 中 的 validate 方法 ， 如 果 校 验 失败 ， 则 返回 input 
的 逻辑 视图 。 

大 部 分 时 候 ， 开 发 者 无 须 手动 控制 这 些 拦 截 器 ， 因 为 struts-default.xml 文件 中 已 经 配置 了 这 些 拦 

截 器 ， 只 要 我 们 定义 的 包 继承 了 系统 的 struts-default 包 ， 就 可 以 直接 使 用 这 些 拦截 器 。 


>》4.5.3 配置 拦截 器 


在 struts.xml 文件 中 定义 拦截 器 只 需 为 拦截 器 类 指定 一 个 拦截 器 名 , 就 完成 了 拦截 器 定义 。 定 义 拦 
鹤 器 使 用 <interceptor .. 人 > 元 素来 定义 ， 定 义 拦 截 器 最 简单 的 格式 如 下 : 
<!-- 通过 指定 拦截 器 名 和 拦截 器 实现 类 来 定义 拦截 器 --> 


<interceptor name=" 拦 蕉 器 名 ”class=" 拦 蕉 器 实现 类 "/> 


二 注 | 
尽量 避免 在 Action 中 直接 访问 Servlet API， 这 样 会 导致 Action a Servlet 的 高 耦合 


大 部 分 时 候 ， 只 需要 通过 上 面 的 格式 就 可 完成 拦截 器 的 配置 。 如 果 还 需要 在 配置 拦截 器 时 传 入 拦 
截 器 参数 ， 则 需要 在 <interceptor .…/ > 元 素 中 使 用 <param .…/> 子 元 素 。 下 面 是 在 配置 拦截 器 时 ， 同 时 传 
入 拦截 器 参数 的 配置 形式 。 


<!-- 通过 指定 拦截 器 名 和 拦截 器 实现 类 来 定义 拦截 器 --> 

<interceptor name=" 拦 截 器 名 ” class=" 拦 截 器 实现 类 "/> 
<!-~ 下 面 的 元 素 可 以 出 现 0 次 ， 也 可 以 出 现 无 限 多 次 
其 中 name 属性 指定 需要 设置 的 参数 名 ， 中 间 指定 的 就 是 该 参数 的 值 -> 
<param name= "参数 名 "> 参数 值 </Param> 

</interceptor> 


除 此 之 外 ， 还 可 以 把 多 个 拦截 器 连 在 一 起 组 成 拦截 器 栈 ， 例 如 ， 如 果 需 要 在 Action 执行 前 同时 做 
登录 检查 、 安 全 检查 和 记录 日 志 ， 则 可 以 把 这 三 个 动作 对 应 的 拦截 器 组 成 一 个 拦截 器 栈 。 定 义 拦截 器 
栈 使 用 <interceptor-stack .… 伺 元素， 拦截 器 栈 是 由 多 个 拦截 器 组 成 的 ， 因 此 需要 在 <interceptor-stack .…/> 
元 素 中 使 用 <interceptor-ref .… 信 元 素来 定义 多 个 拦截 器 引用 ， 即 该 拦截 器 栈 由 多 个 <interceptorref .…/> 
元 素 指定 的 拦截 器 组 成 。 

从 程序 结构 上 来 看 ， 拦 截 器 栈 是 由 多 个 拦截 器 组 成 的 ， 即 一 个 拦截 器 栈 包含 了 多 个 拦截 器 ; 但 从 
程序 功能 上 来 看 ， 拦 截 器 栈 和 拦截 器 是 统一 的 ， 它 们 包含 的 方法 都 会 在 Action 的 execute 方法 执行 之 
前 自动 执行 。 实 际 上 ， 我 们 完全 可 以 把 拦截 器 栈 当成 一 个 更 大 的 拦截 器 。 

配置 拦截 器 栈 的 语法 示例 如 下 : 


<interceptor-stack name=" 拦 截 器 栈 名 "> 


Ns 的 Se 


336 


http://52pdf.taobao.com 


SA 


</interceptor-stack> 

上 面 的 配置 片段 示例 配置 了 一 个 名 为 “拦截 器 栈 名 ”的 拦截 器 栈 ， 这 个 拦截 器 由 下 面 的 “拦截 器 

-” 和 “拦截 器 二 ”组 成 ， 当 然 还 可 以 包含 更 多 的 拦截 器 ， 只 需 在 <interceptor-stack .…./> 元 素 下 配置 更 
多 的 <interceptor-ref .. 户 子 元 素 即 可 。 


疙 就 可 以 完全 像 使 用 普通 拦截 器 一 样 使 用 拦截 器 栈 ， 因 为 拦截 器 和 拦截 器 栈 的 功能 是 完全 统 | 


因为 拦截 器 栈 与 拦截 器 的 功能 几乎 完全 相同 ， 因 此 可 能 出 现 的 情况 是 : 拦截 器 栈 里 也 可 包含 拦截 
器 栈 。 因 此 ， 可 能 出 现 如 下 的 配置 片段 : 


<interceptor-stack name=" 拦 截 器 栈 一 "> 
<interceptor-ref name=" 拦 截 器 一 "/> 
<interceptor-ref name=" 拦 截 器 二 "/> 
<!-- 还 可 配置 更 多 的 拦截 器 一 > 


</interceptor-stack> 
<interceptor-stack name=" 拦 截 器 栈 二 "> 
<interceptor-ref name=" 拦 截 器 三 "/> 
<interceptor-ref name=" 拦 截 器 栈 一 "/> 
<!-- 还 可 配置 更 多 的 拦截 器 --> 
</interceptor-stack> 
在 上 面 的 配置 片段 中 ,第 二 个 拦截 器 栈 包 含 了 第 一 个 拦截 器 栈 (包含 两 个 拦截 器 ), 其 实质 的 情况 
就 是 拦截 器 栈 二 由 三 个 拦截 器 组 成 ， 拦 截 器 一 、 拦 截 器 二 和 拦截 器 三 。 
那么 为 什么 不 直接 在 拦截 器 栈 二 中 直接 配置 三 个 拦截 器 的 引用 ， 而 是 通过 引用 另 一 个 拦截 器 栈 
呢 ? 答案 是 为 了 软件 复 用 。 因 为 系统 中 已 经 存在 了 一 个 名 为 “拦截 器 栈 一 ”的 拦截 器 栈 ， 这 个 拦截 器 
栈 由 两 个 拦截 器 组 成 ， 当 需要 再 次 使 用 这 两 个 拦截 器 时 ， 直 接 调 用 该 拦截 器 栈 即 可 ， 无 须 分 别 调用 两 
个 拦截 器 。 而 且 ， 这 两 个 拦截 器 组 成 的 拦截 器 栈 也 可 以 单独 使 用 。 
系统 为 拦截 器 指定 参数 有 如 下 两 个 时 机 。 
> ”定义 拦截 器 时 指定 参数 值 ， 这 种 参数 值 将 作为 拦截 器 参数 的 默认 参数 值 。 
> ”使 用 拦截 器 时 指定 参数 值 ， 在 配置 Action 时 为 拦截 器 参数 指定 值 。 
通过 为 <interceptor-ref .… 人 > 元 素 增加 <param .…/> 子 元 素 ， 就 可 在 使 用 拦截 器 时 为 参数 指定 值 。 
下 面 是 在 配置 拦截 器 栈 时 为 拦截 器 动态 指定 参数 值 的 语法 示意 。 
<interceptor-stack name=" 拦 截 器 栈 一 "> 
<interceptor-ref name=" 拦 截 器 一 "> 
<!-- 下 面 为 拦截 器 分 别 定义 了 两 个 参数 值 -> 
<param name=" 参 数 一 "> 参 数值 一 </param> 
<param name=" 参 数 二 "> 参数 值 二 </param> 
<!-- 还 可 指定 更 多 的 参数 值 --> 


</interceptor> 
<interceptor-ref name=" 拦 截 器 二 "/> 


<!-- 还 可 配置 更 多 的 拦截 器 -> 


</interceptor-stack> 

<interceptor-stack name=" 拦 截 
<interceptor-ref name=" 拦 截 器 三 "/> 
<interceptor-ref name=" 拦 截 器 栈 一 "/> 
<!-~ 还 可 配置 更 多 的 拦截 器 --> 


</interceptor-stack> 
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有 两 个 时 机 为 拦截 器 指定 参 教 值 ， 一 个 时 机 是 当 定义 拦截 器 (通过 <intercepter .…/> | 
元 素来 定义 拦截 器 ) 时 指定 拦截 器 的 参数 值 ， 这 种 方式 为 该 拦截 器 的 参数 指定 默认 值 ; 
另 一 个 时 机 是 当 使 用 拦截 器 ( 通过 <interceptor-ref ... 亿 元 素 使 用 拦截 器 ) 时 指定 拦截 器 的 by 


套数 值 ， 这 种 方式 用 于 覆盖 拦截 器 的 默认 参数 值 


如 果 在 两 个 时 机 为 同一 个 参数 指定 了 不 同 的 参数 值 ， 则 使 用 拦截 器 时 指定 的 参数 值 将 会 覆盖 默认 
的 参数 值 。 


4.5.4 使 用 拦截 器 


-日 定义 了 拦截 器 和 拦截 器 栈 后 , 就 可 以 使 用 这 个 拦截 器 或 拦截 器 栈 来 拦截 Action 了 , 拦截 器 ( 包 
含 拦截 器 栈 ) 的 拦截 行为 将 会 在 Action 的 execute 方法 执行 之 前 被 执行 。 
通过 <interceptor-ref .… 户 元 素 可 以 在 Action 内 使 用 拦截 器 ， 在 Action 中 使 用 拦截 器 的 配置 语法 ， 
与 配置 拦截 器 栈 时 引用 拦截 器 的 语法 完全 一 样 。 
下 面 是 在 Action 中 定义 拦截 器 的 配置 示例 。 
<!-- 定义 全 部 的 拦截 器 --> 
<interceptors> 
<1-- 定义 第 一 个 拦 才 器 --> 
<interceptor name="mysimple" class="lee.SimpleInterceptor"/> 
<!-- 定义 第 二 个 拦截 器 --> 
<interceptor name="later" class="lee.LaterInterceptor"> 
<!-- 指定 该 拦截 器 的 默认 参数 值 --> 
<param name="name"> 第 二 个 拦截 器 </param> 
</interceptor> 
</interceptors> 


<!-- 配置 自 定义 的 Action， 实 现 类 为 LoginAction --> 

<action name="login" class="org.crazyit.app.action.LoginAction"> 
<!-- 配置 该 Action 的 两 个 局 部 结果 映射 --> 
<result name="error">/error,jsp</result> 
<result name="success">/welcome.jsp</result> 


<!-- 使 用 系统 默认 的 拦截 器 栈 --> 
<interceptor-ref name="defaultstack"/> 


<interceptor-ref name="later"> 
<!-- 为 该 Action 指定 拦截 器 参数 ， 履 盖 name 参数 的 默认 值 --> 
<Param name="name"> 动 态 参数 </param> 
</interceptor-ref> 
</action> 


上 面 的 配置 文件 的 粗 体 字 代码 一 共 使 用 了 三 个 拦截 器 〈 栈 )， 其 中 defaultStack 是 系统 默认 的 拦截 
器 栈 。 而 mysimple 和 later 就 是 用 户 自 定义 的 拦截 器 ， 因 此 在 执行 LoginAction 之 前 ， 这 三 个 拦截 器 都 
会 起 作用 。 


》>4.5.5 ”配置 默认 拦截 器 


当 配置 一 个 包 时 ， 可 以 为 其 指定 默认 拦截 器 。 一 旦 为 某 个 包 指定 了 默认 的 拦截 器 ， 如 果 该 包 中 的 
Action 没有 显 式 指定 拦截 器 ， 则 默认 的 拦截 器 将 会 起 作用 。 但 值得 注意 的 是 ， 如 果 一 旦 我 们 为 该 包 中 
的 Action 显 式 应 用 了 某 个 拦截 器 , 则 默认 的 拦截 器 不 会 起 作用 ; 如 果 该 Action 需要 使 用 该 默认 拦截 器 ， 
则 必须 手动 配置 该 拦截 器 的 引用 。 
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配置 默认 拦截 器 使 用 <default-interceptor-ref ..…. 记 元素 , 该 元 素 作 为 <package .元素 的 子 元 素 使 用 ， 
为 该 包 下 的 所 有 Action 配置 默认 的 拦截 器 。 

配置 <default-interceptor-ref .元 素 时， 需要 指定 一 个 name 属性， 该 name 属性 值 是 一 个 已 经 存 
在 拦截 器 〈 栈 ) 的 名 字 ， 表 明 将 该 拦截 器 〈 栈 ) 配置 成 该 包 的 默认 拦截 器 。 需 要 注意 的 是 ， 每 个 
<package .> 元 素 只 能 有 一 个 < default-interceptor-ref .> 子 元 素 ， 即 每 个 包 只 能 指定 一 个 默认 拦截 器 。 

下 面 是 配置 默认 拦截 器 的 配置 示例 。 


<package name=" 包 名 "> 
<!-- 所 有 拦截 器 和 拦截 器 栈 都 配置 在 该 元 素 下 一 > 


<interceptors> 


<!1-- 定义 拦截 器 --> 
< 


<interceptor-stack .../> 
<interceptors> 


<! Ar 的 入 拘 > 
拦截 器 名 或 拦截 器 栈 名 "/: 


<default-interceptor-ref name=" 
<!-- 配置 多 个 Action --> 
<action ../> 

</package> 


.注意 :和 
| 每 个 包 只 能 指定 一 个 默认 拦截 器 。 如 果 我 们 指定 了 多 个 拦截 器 ， 那 么 系统 将 无 法 确 | 
尖 呈 个 才 是 典 兴 六 入 敬 ， 当然 ， 如 果 我 们 需要 指定 多 个 拦截 器 共同 作为 默认 拦截 器 ， 则 可 


应 器 定义 成 拦截 器 栈 ， 然 后 把 这 个 拦截 器 栈 配置 成 默认 拦截 器 即 可 . 


Action 中 使 用 拦截 器 一 样 ， 也 可 以 在 配置 默认 拦截 器 时 为 该 拦截 器 指定 参数 。 指 定 默认 拦截 
器 的 <default-interceptor-ref ..…/> 元 素 同样 支持 <param .…/> 子 元 素 。 
下 面 是 在 配置 默认 拦截 器 时 为 该 拦截 器 指定 参数 值 的 配置 示例 。 
<package name=" 包 名 "> 

<!-- 所 有 拦截 器 和 拦截 器 栈 都 配置 在 该 元 素 下 -> 

<interceptors> 
<!-- 定义 拦截 器 
<interceptor .. 


<!-~ 定义 拦截 器 栈 --> 
<interceptor-stack .../> 
<interceptors> 


<!-- 配置 该 包 下 的 默认 拦截 器 一 既 可 以 是 拦截 器 ， 也 可 以 是 拦截 器 栈 -> 
<default-interceptor-ref name=" 或 拦截 器 栈 名 "> 


<!-- 在 配置 默认 拦 帘 器 时 为 该 拦截 器 指定 参数 值 -> 
<paran nane=" 参 数 名 "> 参数 值 </paran> 
<!-~ 下 面 还 可 以 配置 多 个 参数 值 -> 


</default-interceptor-ref> 
<!-- 配置 多 个 Action --> 
<action ../> 
</package> 
配置 默认 拦截 器 是 一 种 使 用 拦截 器 的 方式 一 一 避免 在 每 个 Action 中 单独 配置 拦截 器 , 通过 在 该 包 
下 配置 拦截 器 ， 可 以 实现 为 该 包 下 所 有 Action 同时 配置 相同 的 拦截 器 。 
与 使 用 拦截 器 一 样 ， 配 置 默 认 拦 截 器 指定 的 参数 值 会 覆盖 拦截 器 指定 的 默认 参数 值 。 
此 时 ,我 们 应 该 可 以 理解 为 什么 前 面 的 Action 都 无 须 配置 defaultStack 拦截 器 栈 了 ， 因 为 在 Struts 
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2 的 struts-default.xml 文件 中 有 如 下 配置 片段 : 
<?xml version="1.0" encoding="UTF-8" ?> 


<!-- 指定 Struts 2 配置 文件 的 DTD 信息 --> 
<!DOCTYPE struts PUBLIC 


"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"https//struts.apache.org/dtds/struts-2.1.7.dtd"> 


<!-- 指定 Struts 2 配置 文件 的 根 元 素 一 > 


<struts> 


个 <15r 配置 Struts 2 的 默认 包 --> 


ge name="struts-default"> 


-- 指定 Struts 2 的 默认 拦截 器 栈 --> 
ault-interceptor-ref name="defaultstack"/> 


</package> 


</struts> 
上 面 的 配置 文件 的 粗 体 字 代码 定义 了 一 个 名 为 struts-default 的 包 ， 该 包 下 定义 了 名 为 defaultStack 
的 默认 拦截 器 栈 引 用 。 
而 前 面 Struts 2 应 用 中 的 包 , 都 是 struts-default 包 的 子 包 。 当 我 们 定义 的 包 继承 struts-default 包 时 ， 
也 继承 了 它 的 默认 拦截 器 栈 : defaultStack， 这 就 意味 着 ， 如 果 我 们 不 为 Action 显 式 地 应 用 拦截 器 ， 则 
defaultStack 拦截 器 栈 会 自动 生效 。 
经 过 上 面 的 介绍 ， 可 以 看 出 与 拦截 器 相关 的 配置 元 素 如 下 。 


> 


<interceptors .…/> 元 素 : 该 元 素 用 于 定义 拦截 器 ， 所 有 的 拦截 器 和 拦截 器 栈 都 在 该 元 素 下 定 
义 。 该 元 素 包含 <interceptor ../> 和 <interceptor-stack.../> 子 元 素 ， 分 别 用 于 定义 拦截 器 和 拦 
截 器 栈 。 

<interceptor …/> 元 素 ， 该 元 素 用 于 定义 单个 的 拦截 器 ， 定 义 拦截 器 时 只 需 指定 两 个 属性 ; 
name 和 class， 分 别 指定 拦截 器 的 名 字 和 实现 类 。 

<interceptor-stack..…/> 元 素 : 该 元 素 用 于 定义 拦截 器 栈 ， 该 元 素 中 包含 多 个 <interceptor- 
ref..…./> 元 素 ， 用 于 将 多 个 拦截 器 或 拦截 器 栈 组 合成 一 个 新 的 拦截 器 栈 。 
<interceptor-ref.…/> 元 素 : 该 元 素 引 用 一 个 拦截 器 或 拦截 器 栈 , 表明 应 用 指定 拦截 器 。 该 元 素 
只 需 指定 一 个 name 属性 ， 该 属性 值 为 一 个 已 经 定义 的 拦截 器 和 拦截 器 栈 。 该 元 素 可 以 作为 
<interceptor-stack.../> 和 <action .…/> 元 素 的 子 元 素 使 用 。 

<param .…/>: 该 元 素 用 于 为 拦截 器 指定 参数 , 可 以 作为 <interceptor .…/>、<interceptor-ref.../> 
和 <default-interceptor-ref .…/> 元 素 的 子 元 素 使 用 。 

<default-interceptor-ref .…/>: 该 元 素 为 指定 包 配置 默认 拦截 器 。 该 元 素 作为 <package .…/> 
元 素 的 子 元 素 使 用 。 


>>》4.5.6 ”实现 拦截 器 类 


虽然 Struts 2 框架 提供 了 许多 拦截 器 ， 这 些 内 建 的 拦截 器 实现 了 Struts 2 的 大 部 分 功能 ， 因 此 ， 大 
部 分 Web 应 用 的 通用 功能 ,都 可 以 通过 直接 使 用 这 些 拦截 器 来 完成 , 但 还 有 一 些 系统 逻辑 相关 的 通用 
功能 ， 可 以 通过 自 定义 拦截 器 来 实现 。 值 得 称道 的 是 ，Struts 2 的 拦截 器 系统 是 如 此 的 简单 、 易 用 。 

如 果 用 户 要 开发 自己 的 拦截 器 类 , 应 该 实现 com.opensymphony.xwork2.interceptor.Interceptor 接口 ， 
该 接口 的 类 定义 代码 如 下 : 


publit interface Interceptor extends Serializable 
{ 


7/ 销毁 该 拦截 器 之 前 的 回调 方法 
void-destroy{); 

/7 初始 化 该 拦截 器 的 回调 方法 
vaid init()? 
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// 拦 截 器 实现 拦截 的 逻辑 方法 


String intercept (ActionInvocation invocation) throws Exception; 


} 

通过 上 面 的 接口 可 以 看 出 ， 该 接口 里 包含 了 如 下 三 个 方法 。 

> init(): 在 该 拦截 器 被 实例 化 之 后 ， 在 该 拦截 器 执行 拦截 之 前 ， 系 统 将 回调 该 方法 。 对 于 每 个 

拦截 器 而 言 ， 其 init() 方 法 只 执行 一 次 。 因 此 ， 该 方法 的 方法 体 主要 用 于 初始 化 性 资源 ， 例 如 
数据 库 连 接 等 。 

> destroy(): 该 方法 与 init() 方 法 对 应 。 在 拦截 器 实例 被 销毁 之 前 ,系统 将 回调 该 拦截 器 的 destroy 

方法 ， 该 方法 用 于 销毁 在 init() 方 法 里 打开 的 资源 。 

> intercept(Actionlnvocation invocation): 该 方法 是 用 户 需 要 实现 的 拦截 动作 。 就 像 Action 的 

execute 方法 一 样 ，intercept 方法 会 返回 一 个 字符 串 作为 逻辑 视图 。 如 果 该 方法 直接 返回 了 
-个 字符 串 ， 系 统 将 会 跳 转 到 该 逻辑 视图 对 应 的 实际 视图 资源 ， 不 会 调用 被 拦截 的 Action。 
该 方法 的 ActionInvocation 参数 包含 了 被 拦截 的 Action 的 引用 ， 可 以 通过 调用 该 参数 的 

invoke 方法 ， 将 控制 权 转 给 下 一 个 拦截 器 ， 或 者 转 给 Action 的 execute 方法 。 

除 此 之 外 ，Struts 2 还 提供 了 一 个 AbstractInterceptor 类 ， 该 类 提供 了 一 个 init 和 destroy 方法 的 空 
实现 ， 如 果 我 们 实现 的 拦截 器 不 需要 打开 资源 ， 则 可 以 无 须 实现 这 两 个 方法 。 可 见 ， 继 承 
AbstractInterceptor 类 来 实现 自 定义 拦截 器 会 更 加 简单 。 

下 面 实现 了 一 个 简单 的 拦截 器 。 

程序 清单 ，codes\044.5\simpleIntercepto\WEB-INF\src\org\crazyitapp\interceptor\SimpleiInterceptorjava 

public class SimpleInterceptor 


extends RbstractInterceptor 


// 简 单 拦截 器 的 名 字 

private String name; 

// 为 读 简 单 拦截 器 设置 名 字 的 setter 方法 
public void setName (String name) 
{ 


{ 


this.name = name; 
上 
public String intercept (ActionInvocation invocation) 
throws Exception 
{ 
// 取 得 被 拦截 的 Action 实例 
LoginAction action = (LoginAction)invocation.getAction(); 
// 打 印 执行 开始 的 实现 
System.out.println (name + ”拦截 器 的 动作 - 
"开始 执行 登录 Action 的 时 间 为 : ”+ new 
7/ 取得 开始 执行 Action 的 时 间 
long start = System.currentTimeMillis()7 
// 执 行 该 拦截 器 的 后 一 个 拦截 器 
// 如 果 该 拦截 器 后 没有 其 他 拦截 器 ， 则 直接 执行 Action 的 execute 方法 
String result = invocation.invoke(); 
// 打 印 执行 结束 的 时 间 
System.out.println (name + "拦截 器 的 动作 -- 
"执行 完 登录 Action 的 时 间 为 : ”+ new Dat 
long end = System.currentTimeMillis(); 
System.out .println (name + "拦截 器 的 动作 --------- "+ 
"执行 完 该 Action 的 事件 为 " + (end - start) + "毫秒 "); 


return result; 


了 
} 


上 面 的 拦截 器 仅仅 在 被 拦截 方法 之 前 ， 打 印 出 开始 执行 Action 的 时 间 ， 并 记录 开始 执行 Action 
的 时 刻 ， 执行 被 拦截 Action 的 execute 方法 之 后 ， 再 次 打印 出 当前 时 间 ， 并 输出 执行 Action 的 时 长 。 
程序 粗 体 字 代码 将 会 调用 目标 Action 的 execute 方法 。 

当 我 们 实现 intercept(ActionInvocation invocation) 方 法 时 , 可 以 获得 ActionInvocation 参数 ， 这 个 参 
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数 又 可 以 获得 被 拦截 的 Action 实例 ,一 旦 取得 了 Action 实例 ,几乎 获得 了 全 部 的 控制 权 : 可 以 实现 将 
HTTP 请 求 中 的 参数 解析 出 来 ， 设 置 成 Action 的 属性 (这 是 系统 params 拦截 器 完成 的 事情 );， 也 可 以 
直接 将 HTTP 请 求 中 的 HttpServletRequest 实例 和 HttpServletResponse 实例 传 给 Action (这 是 


当然 ， 也 可 实现 应 用 相关 的 逻辑 。 


servlet-config 拦截 器 完成 的 事情 ) … 
》>>4.5.7 使 用 拦截 器 


使 用 拦截 器 需要 两 个 步骤 : 

人 通过 <interceptor .…. 亡 元 素来 定义 拦 蕉 器 。 

人 通过 <interceptor-ref .… 亡 元 素来 使 用 拦截 器 。 

为 了 在 本 应 用 中 使 用 上 面 的 拦截 器 ， 本 应 用 的 配置 文件 如 下 。 
程序 清单 : codes\04\4.5\simpleInterceptor\WEB-INF\sre\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<!-- 通过 常量 配置 Struts 2 的 国际 化 资源 信息 --> 
<constant name="struts.custom.il8n.resources" value="mess"/> 
<!-- 通过 常量 配置 Struts 2 所 使 用 的 解码 集 --> 
<constant name="struts.il8n.encoding"” value="GBK"/> 
<!-- 配置 本 系统 所 使 用 的 包 -> 
<package name="lee" extends="struts-default"> 
<!-- 应 用 所 需 使 用 的 拦截 器 都 在 该 元 素 下 配置 一 > 
<interceptors> 
<!-- 配置 mysimple 拦截 器 --> 
<interceptor name="mysimple" 
class="org.crazyit.app. interceptor.SimpleInterceptor"> 
<!-- 为 拦截 器 指定 参数 值 ~-> 
<param name="name"> 简 单 拦截 器 </param> 
</interceptor> 
</interceptors> 
<action name="loginPro" class="org.crazyit.app.action.LoginAction"> 
<result name="error">/WEB-INF/content/error.jsp</result> 
<result name="success">/WEB-INF/content/welcome.jsp</result> 
<!-- 配置 系统 的 默认 拦截 器 --> 
<interceptor-ref name="defaultStackn"/> 
<!--~ 应 用 自 定义 的 mysimple 拦截 器 一 -> 
‘in 


</action> 
<action name="*"> 
<result>/WEB-INF/content/11).jsp</result> 
</action> 
</package> 
</struts> 
上 面 的 配置 文件 的 第 一 段 粗 体 字 代码 将 org.crazyit.app.interceptor SimpleInterceptor 拦截 器 类 定义 
成 名 为 “mysimple” 的 拦截 器 ， 第 二 段 粗 体 字 代 码 在 名 为 login 的 Action 中 使 用 该 拦截 器 。 值 得 注意 


的 是 ， 当 应 用 mysimple 拦截 器 时 ， 我 们 还 应 用 了 系统 默认 的 defaultStack 拦截 器 栈 。 
Si 
-关注 意 : 
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行 时 间 信息 。 
当 浏 览 者 在 浏览 器 中 对 该 Action 发 送 请求 时 ， 该 拦截 器 将 会 拦截 该 Action 的 execute 方法 ， 将 在 
Tomcat 的 控制 台 看 到 如 图 4.30 所 示 的 效果 。 


:_Server startup in 1774 


名 后 的 拦截 器 拓 截 器 的 动作 一 一 一 一 开始 执行 登录 Action 的 时 间 为 : Sat Nov 20 13:19 | 


入 execute 方 法 执行 体 . --- 

名 后 的 拦截 器 拦截 要 的 动作 一 一 一 一 热 行 完结 录 Acrion 的 时 间 为 : Sat Nov 20 13:19:2 
CST 2010 

名 后 的 拦截 器 拦截 器 的 动作 ~ 一 一 一 一 执行 完 该 ction 的 事件 为 1625 毫 秒 


过 


图 4.30 拦截 器 作用 Action 的 效果 


从 图 4.30 中 可 以 看 出 ，SimpleInterceptor 拦截 器 已 经 获得 了 执行 机 会 ， 取 得 了 系统 中 该 Action 处 
理 用 户 请 求 的 时 间 。 不 仅 如 此 ， 我 们 还 可 以 看 到 ， 系 统 中 的 拦截 器 name 属性 值 是 “动态 参数 ”， 而 不 
是 “简单 拦截 器 ”这 就 表明 在 <interceptor-ref … 人 > 元 素 中 指定 的 属性 值 覆盖 了 在 <interceptor … 信 元素 中 
指定 的 属性 值 。 

虽然 上 面 的 拦截 器 的 作用 非常 有 限 ， 但 如 果 有 必要 ， 完 全 可 以 把 多 个 Action 总 是 需要 完成 的 通用 
操作 (例如 权限 控制 》 放 到 该 拦截 器 中 完成 。4.5.12 节 将 会 演示 通过 拦截 器 进行 权限 控制 的 示例 。 

拦截 器 的 配置 离 不 开 前 面 介绍 的 <interceptor .…./>、<interceptor-ref .…/> 和 <interceptor-stack .… 人 元素 。 
但 对 于 深入 拦截 器 的 配置 方面 ， 则 还 有 一 些 值得 注意 的 地 方 。 

从 图 4.30 所 示 执 行 结果 可 以 看 出 ，Struts 2 拦截 器 的 功能 非常 强大 ， 它 既 可 以 在 Action 的 execute 
方法 之 前 插入 执行 代码 ， 也 可 以 在 execute 方法 之 后 插入 执行 代码 ， 这 种 方式 的 实质 就 是 AOP (面向 
切面 编程 ) 的 思想 。 


》>》>4.5.8 ”拦截 方法 的 拦截 器 


在 默认 情况 下 , 如 果 我 们 为 某 个 Action 定义 了 拦截 器 , 则 这 个 拦截 器 会 拦截 该 Action 内 的 所 有 方 
法 。 但 在 某 些 情况 下 ， 我 们 不 想 拦截 所 有 的 方法 ， 只 需要 拦截 指定 方法 ， 此 时 就 需要 使 用 Struts 2 搓 
截 器 的 方法 过 滤 特 性 。 

为 了 实现 方法 过 滤 的 特性 , Struts 2 提供 了 一 个 MethodFilterInterceptor 类 , 该 类 是 AbstractInterceptor 
类 的 子 类 ， 如 果 用 户 需 要 自己 实现 的 拦截 器 支持 方法 过 滤 特 性 ， 则 应 该 继承 MethodFilterInterceptor。 

MethodFilterInterceptor 类 重 写 了 AbstractInterceptor 类 的 intercept(ActionInvocation invocation) 方 
法 ， 但 提供 了 一 个 doIntercept(ActionInvocation invocation) 抽 象 方法 。 从 这 种 设计 方式 可 以 看 出 ， 
MethodFilterInterceptor 类 的 intercept 已 经 实现 了 对 Action 的 拦截 行为 (只 是 实现 了 方法 过 滤 的 逻辑 )， 
但 真正 的 拦截 逻辑 还 需要 开发 者 提供 ， 也 就 是 通过 回调 dolntercept 方法 实现 。 可 见 ， 如 果 用 户 需 要 实 
现 自己 的 拦截 逻辑 ， 则 应 该 重 写 dolntercept(ActionInvocation invocation) 方 法 。 

下 面 是 一 个 简单 的 方法 过 滤 的 示例 应 用 ， 方 法 过 滤 的 拦截 器 代码 如 下 。 

程序 清单 : codes\04\4.5\methodFilter\WWEB-INF\src\org\crazyit\app\action\MyFilterInterceptorjava 


/ /拦截 方法 的 拦截 器 ， 应 该 继承 MethodFilterInterceptor 抽象 类 
public class MyFilterInterceptor 
extends MethodFilterInterceptor 


// 简 单 拦截 器 的 名 字 

private String name; 

// 为 该 简单 拦截 器 设置 名 字 的 setter 方法 
public void setName(String name) 
4 


{ 


this.name = name; 


上 
// 重 写 doIntercept 方法 ， 实 现 对 Action 的 拦截 逻辑 
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public String doIntercept (ActionInvocation invocation) 
throws Exception 

{ 
// 取 得 被 拦截 的 Action 实例 
LoginAction action = (LoginAction)invocation.getAction(); 
// 打 印 执行 开始 的 时 间 
System.out.println (name + "拦截 器 的 动作 --------- 

+ "开始 执行 登录 Action 的 时 间 为 : ”+ new Date()); 


// 取 得 开始 执行 Action 的 时 间 
long start = System.currentTimeMillis(); 


// 执 行 该 拦截 器 的 后 一 个 拦截 器 ， 或 者 直接 指定 Action 的 execute 方法 
String result = invocation.invoke(); 


// 打 印 执行 结束 的 时 间 
System.out .printlin (name + "拦截 器 的 动作 --------- " 
+ "执行 完 登录 Action 的 时 间 为 : ”+ new Date()); 
long end = System.currentTimeMillis()7 
// 打 印 执行 该 Action 所 花费 的 时 间 
System,out.println (name + ”拦截 器 的 动作 ---------" 
+ "执行 完 该 Action 的 事件 为 ”+ (end - start) + "毫秒 "); 
return result; 
) 
} 


从 上 面 的 代码 中 可 以 看 出 ， 上 面 的 拦截 器 的 拦截 逻辑 与 前 面 的 简单 拦截 器 的 拦截 逻辑 相似 ， 只 是 
之 前 是 需要 重 写 intercept 方法 ， 现 在 是 重 写 dolntercept 方法 。 
实际 上 ， 实 现 方法 过 滤 的 拦截 器 与 实现 普通 拦截 器 并 没有 太 大 的 区 别 ， 只 需要 注意 两 个 地 方 ， 实 
现 方法 过 滤 的 拦截 器 需要 继承 MethodFilterInterceptor 抽象 类 ，, 并且 重 写 dolntercept 方法 定义 对 Action 
的 拦截 逻辑 。 
在 MethodFilterInterceptor 方法 中 ， 额 外 增加 了 如 下 两 个 方法 。 
> public void setExcludeMethods(String excludeMethods): 排除 需要 过 滤 的 方法 一 一 设置 方 
法 “ 黑 名 单 ”， 所 有 在 excludeMethods 字符 串 中 列 出 的 方法 都 不 会 被 拦截 。 
> public void setlncludeMethods(String includeMethods)， 设置 需要 过 滤 的 方法 一 一 设置 方法 
“ 0 ”， 所 有 在 includeMethods 字符 串 中 列 出 的 方法 都 会 被 拦截 。 


本 流量 : 
如 果 一 个 方法 


时 在 excludeMethods 和 includeMethods 中 列 出 ， dn 


因为 MethodFilterinterceptor 类 包含 了 如 上 的 两 个 方 ; ， 风 该 拉夫 器 的 子 类 也 会 获得 这 两 个 方法 。 
可 以 在 配置 文件 中 指定 需要 被 拦截 ， 或 者 不 带 要 被 拦截 的 方法 。 

方法 过 滤 示 例 应 用 的 配置 片段 如 下 。 

程序 清单 : codes\04W4.5\methodFilter\WWEB-INF\sre\struts.xml 


<!-- 配置 本 系统 所 使 用 的 包 一 -> 
<package name="lee" extends="struts-default"> 
<!-- 应 用 所 需 使 用 的 拦截 器 都 在 该 元 素 下 配置 --> 
<interceptors> 
<!-- 配置 mysimple 拦截 器 --> 
<interceptor name="mysimple" 
class="org. crazyit .app.interceptor.MyFilterInterceptor"> 
<!-- 为 拦截 器 指定 参数 值 --> 
<param name="name"> 拦 截 方 法 的 拦截 器 </Param> 
</interceptor> 
</interceptors> 
<action name="loginPro" class="org.crazyit.app.action.LoginAction"> 
<result name="error">/WEB-INF/content/error.jsp</result> 
<result name="success">/WEB-INF/content/welcome.jsp</result> 
<!-- 配置 系统 的 默认 拦截 器 --> 
<interceptor-ref name="defaultStack"/> 
<!-- 应 用 自 定义 的 mysimple 拦截 器 --> 
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<interceptor-ref name="mysimple"> 
<!-- 重新 指定 name 属性 的 属性 值 --> 
<param name="name"> 改 名 后 的 拦截 方法 过 滤 拦 截 器 </Paramy> 
<!-- 指定 execute 方法 不 需要 被 拦截 --> 
<param name="excludeMethods">execute</param> 
</interceptor-ref> 
</action> 
<action name="*"> 
<result>/WEB-INF/content/{1} .jsp</result> 
</action> 
</package> 
上 面 的 配置 文件 的 粗 体 字 代码 通过 excludeMethods 属性 指定 了 execute 方法 无 须 被 拦截 ， 如 果 浏 
览 者 在 浏览 器 中 再 次 向 login 的 Action 发 送 请 求 ， 在 Tomcat 控制 台 将 看 不 到 任何 输出 ,表明 该 拦截 器 
没有 拦截 Action 的 execute 方法 。 
如 果 需 要 同时 指定 多 个 方法 不 被 该 拦截 器 拦截 ， 则 多 个 方法 之 间 以 英文 逗号 〈,) 隔 开 。 看 如 下 的 
配置 片段 : 
<interceptor-ref name="myfilter"> 
<!-- 重新 指定 name 属性 的 属性 值 --> 
name="name"> 改 名 后 的 方法 过 滤 拦 截 器 </param> 
指定 execute 和 haha 方法 不 需要 被 拦截 --> 
am name="excludeMethods">execute,haha</param> 
</interceptor-ref> 
上 面 的 粗 体 字 代码 指定 execute 和 haha 方法 都 不 会 被 myfilter 拦截 器 拦截 。 
如 果 excludeMethods 参数 和 includeMethods 参数 同时 指定 了 一 个 方法 名 , 则 拦截 器 会 拦截 该 方法 。 
看 如 下 的 配置 片段 : 
<interceptor-ref name="myfilter"> 
<!--~ 重新 指定 name 属性 的 属性 值 --> 
param name="name"> 改 名 后 的 方法 过 滤 拦 截 器 </param> 
<!-- 指定 execute 和 haha 方法 不 需要 被 拦截 --> 
<param name="excludeMethods">execute,haha</param> 
<!-- 指定 execute 方法 需要 被 拦截 --> 
<param name="includeMethods">execute</param> 
</interceptor-ref> 
上 面 的 配置 片段 通过 excludeMethods 参数 指定 了 execute 和 haha 方法 不 需要 被 拦截 ， 又 通过 
includeMethods 参数 指定 了 execute 方法 需要 拦截 一 一 二 者 冲突 ! 以 includeMethods 参数 指定 的 取胜 ， 
即 拦截 器 会 拦截 execute 方法 。 
Struts 2 中 提供 了 这 种 方法 过 滤 的 拦截 器 有 如 下 几 个 : 
> Tokeninterceptor 
> TokenSessionStorelnterceptor 
> DefaultWorkflowlnterceptor 
> Validationlnterceptor 


>>4.5.9 ”拦截 器 的 执行 顺序 


随 着 系统 中 配置 拦截 器 的 顺序 的 不 同 ， 系 统 中 执行 拦截 器 的 顺序 也 不 一 样 。 通 常 认为 ， 先 配置 的 
拦截 器 ， 会 先 获得 执行 的 机 会 ， 但 有 时 候 在 一 些 特殊 的 情况 下 可 能 有 少许 出 入 。 

此 时 的 示例 应 用 依然 使 用 最 初 的 简单 拦截 器 类 ， 但 将 其 配置 文件 修改 成 如 下 形式 。 

程序 清单 : codes\04\4.5\sequences\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 

<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1,7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 

<struts> 
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<!-- 通过 常量 配置 Struts 2 的 国际 化 资源 信息 --> 
<constant name="struts.custom.il8n.resources" value="mess"/> 
<!-- 通过 常量 配置 Struts 2 所 使 用 的 解码 集 --> 
<constant name="struts.il8n.encoding"” value="GBK"/> 
<!-- 配置 本 系统 所 使 用 的 包 一 -> 
<package name="lee" extends="struts-default"> 
<!-- 应 用 所 需 使 用 的 拦截 器 都 在 该 元 素 下 配置 一 > 
<interceptors> 
<!-- 配置 mysimple 拦截 器 -> 
<interceptor name="mysimple" 
class="org. crazyit. app.interceptor.SimpleInterceptor"> 
<!-- 为 拦截 器 指定 参数 值 --> 
name="namen> 人 简单 拦 蕉 器 </Param> 
</interceptor> 
</interceptors> 
<action name="loginpro" class="org.crazyit.app.action.LoginAction"> 
<result name="error">/WEB-INF/content/error.jsp</result> 
<result name="success">/WEB-INF/content/welcome.jsp</result> 
<!-- 配置 系统 的 默认 拦截 器 -> 
<interceptor-ref name="defaultStack"/> 
<!- 应 用 自 定义 的 mysimple 拦截 器 一 -> 
<interceptor-ref name="mysimple"> 
<param name="name"> 第 一 个 </param> 
</interceptor-ref> 
<interceptor-ref name="mysimple"> 
<param name="name"> 第 二 个 </param> 
</interceptor-ref> 
</action> 
<action name="*"> 
<result>/WEB-INF/content/{1}.jsp</result> 
</action> 
</package> 
</struts> 


从 上 面 的 配置 片段 可 以 看 出 ， 当 我 们 在 <interceptors .…/> 元 素 中 定义 了 一 个 拦截 器 后 (第 一 段 粗 体 
字 代 码 所 示 ), 在 后 面 的 拦截 器 栈 定义 、Action 定义 中 可 以 多 次 使 用 这 个 拦截 器 。 即使 在 同一 个 Action， 
或 者 同一 个 拦截 器 栈 定义 中 ， 也 可 以 重复 使 用 同一 个 拦截 器 。 对 于 上 面 的 名 为 login 的 Action， 就 两 
次 使 用 mysimple 拦截 器 拦截 该 Action〈 如 第 二 段 粗 体 字 代码 所 示 )。 
当 使 用 mysimple 来 重复 拦截 login Action 时 ， 分 别 使 用 指定 的 两 个 拦截 器 名 : 第 一 个 和 第 二 个 。 
如 果 浏 览 者 在 浏览 器 中 对 该 Action 发 送 请 求 ， 将 看 到 如 图 4.31 所 示 的 效果 。 


ee 
:Server startup in 09 ms 
一 个 搓 夫 器 的 动 开始 执行 登录 Action 的 时 间 为 ，Sar Nov 20 14:34:22 CST 


010 
清二 个 拦截 总 的 动 f 


开始 执行 登录 Action 的 时 间 为 ， Sat Nov 20 14:34:22 CST 
010 


执行 完整 录 4etion 的 对 间 为 : Sat Nov 20 14:34;24 CST 20 


行 完 恋 ction 的 事件 为 1609 理 秒 
生 完 到 录 Action 的 时 间 为 : Sat Nov 20 14:34:24 CST 20 


执行 完 该 Action 的 事件 为 1641 奉 秒 


] 


图 4.31 两 个 拦截 器 的 执行 顺序 
从 图 4.31 中 可 以 看 出 ， 对 于 在 execute 方法 之 前 的 动作 ， 第 一 个 拦截 器 先 起 作用 ， 也 就 是 说 ， 配 
置 在 前 面 的 拦截 器 将 先 起 作用 : 对 于 在 execute 方法 之 后 的 动作 ， 则 第 二 个 拦截 器 先 起 作用 ， 也 就 是 
说 ， 配 置 在 后 面 的 拦截 器 将 先 起 作用 。 
可 以 得 出 如 下 结论 : 在 Action 的 控制 方法 执行 之 前 ， 位 于 拦截 器 链 前 面 的 拦截 器 将 先 发 生 作用 ; 
在 Action 的 控制 方法 执行 之 后 ， 位 于 拦截 器 链 前 面 的 拦截 器 将 后 发 生 作用 。 
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》>》>4.5.10 ”拦截 结果 的 监听 器 


在 前 面 的 简单 拦截 器 中 ， 我 们 将 在 execute 方法 执行 之 前 、 执 行 之 后 的 动作 都 定义 在 拦截 器 的 
intercept(ActionInvocation invocation) 方 法 中 ， 这 种 方式 看 上 去 结构 不 够 清晰 。 

为 了 精确 定义 在 execute 方法 执行 结束 后 ， 在 处 理 物理 资源 转向 之 前 的 动作 ，Struts 2 提供 了 用 于 
拦截 结果 的 监听 器 ， 这 个 监听 器 是 通过 手动 注册 在 拦截 器 内 部 的 。 

前 面 已 经 介绍 过 拦截 结果 的 监听 器 接口 : PreResultListener, 只 是 之 前 是 在 Action 中 注册 该 监听 器 ， 
那么 该 监听 器 将 只 对 指定 Action 有 效 。 此 处 把 PreResultListener 监听 器 注册 在 拦截 器 中 ， 这 样 可 以 只 
要 该 拦截 器 起 作用 的 地 方 ， 这 个 拦截 接口 的 监 昕 器 都 会 被 触发 。 

下 面 是 本 示例 应 用 中 的 监听 器 代码 。 
程序 清单 :codes\044.5\preResultListener\WWEB-INF\src\org\crazyitapp\interceptorIMyPreResultListenerjava 
public class MyPreResultListener 
implements PreResultListener 


// 定 义 在 处 理 Result 之 前 的 行为 
public void beforeResult (ActionInvocation invocation 
,String resultCode) 


// 打 印 出 执行 结果 
System.out.println ("返回 的 逻辑 视图 为 :" + resultCode); 


{ 


{ 


} 
】} 


与 前 面 直接 在 intercept 方法 中 定义 在 execute 方法 执行 之 后 执行 的 代码 相 比 ， 在 beforeResult 方法 
内 有 了 更 多 的 参数 ， 如 resultCode， 这 个 参数 就 是 被 拦截 Action 的 execute 方法 的 返回 值 。 上 面 的 监听 
器 仅仅 打印 了 被 拦截 器 Action 的 execute 方法 的 返回 值 。 

虽然 上 面 的 beforeResult 方法 也 获得 ActionInvocation 类 型 的 参数 ， 但 通过 这 个 参数 来 控制 Action 
已 经 没有 太 大 作用 了 一 一 因为 Action 的 execute 方法 已 经 执行 结束 了 。 

这 个 监听 器 是 通过 代码 手动 注册 给 某 个 拦截 器 的 ， 下 面 是 该 拦截 器 代码 。 

程序 清单 ，codes\4M.1\preResultListenenWEB-INF\srcworgyerazyitapp\interceptonBeforeResultInterceptorjava 
public class BeforeResultInterceptor 
extends AbstractIinterceptor 


public string intercept (ActionInvocation invocation) 
throws Exception 


// 将 一 个 拦截 结果 的 监听 器 注册 给 该 拦截 器 

invocation .addPreResultListener (new MyPreResultListener ()); 
System.out .println ("execute 方法 执行 之 前 的 拦截 . . -”) 字 

// 调 用 下 一 个 拦截 器 ， 或 者 Action 的 执行 方法 

String result = invocation.invoke(); 

System.out .println ("execute 方法 执行 之 后 的 拦截 . . ."); 

return result; 


{ 


) 
} 


上 面 的 粗 体 字 代码 手动 注册 了 一 个 拦截 结果 的 监听 器 : MyPreResultListener， 该 监听 器 中 的 
beforeResult 方法 肯定 会 在 系统 处 理 物理 资源 转向 之 前 被 执行 , 上 面 的 拦截 器 也 定义 了 需要 在 处 理 物理 
资源 转向 之 前 执行 的 代码 。 

将 该 拦截 器 配置 在 struts.xml 文件 中 , 配置 该 拦截 器 与 配置 普通 拦截 器 并 没有 任何 区 别 , 此 处 不 再 
给 出 配置 该 拦截 器 的 配置 文件 。 

当 浏览 者 通过 浏览 器 向 该 Action 发 送 请 求 时 ， 将 看 到 如 图 4.32 所 示 的 效果 。 
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xecute 方 法 执行 之 后 的 拦截 . 
加 J 
图 4.32 拦截 结果 的 监听 器 


从 图 4.32 中 可 以 看 出 ， 定 义 在 MyPreResultListener 类 中 的 beforeResult 方法 ， 定 义 在 拦截 器 的 
intercept(ActionInvocation invocation) 方 法 中 在 Result 之 前 执行 的 动作 ， 更 早 执行 。 

虽然 在 beforeResult 方法 中 再 对 ActionInvocation 方法 进行 处 理 已 经 没有 太 大 的 作用 了 ， 但 了 解 
Action 已 经 执行 完毕 ， 而 处 理 物理 资源 转向 还 没有 开始 执行 的 时 间 点 也 非常 重要 ， 可 以 让 开发 者 精确 
控制 Action 处 理 的 结果 ， 并 且 对 处 理 结果 做 有 针对 性 的 处 理 。 

值得 注意 的 是 ， 虽 然 beforeResult 方法 中 也 可 获得 ActionInvocation 实例 ， 但 千 万 不 可 通过 该 实例 
再 次 调用 invoke( 方 法 ， 如 果 再 次 调用 invoke0 方 法 ,将 会 再 次 执行 Action 处 理 ，Action 处 理 之 后 紧 跟 
的 是 beforeResult 方法 …… 这 会 陷入 一 个 死 循环 。 


用 invoke0 方 法， 3 
Em 


>>4.5.11 覆盖 拦截 器 栈 里 特定 拦截 器 的 参数 


在 有 些 时 候 ， 我 们 的 Action 需要 使 用 一 个 拦截 器 栈 ， 当 使 用 这 个 拦截 器 栈 时 ， 又 需要 获 盖 该 拦截 
器 栈 中 某 个 拦截 器 的 指定 参数 值 。 这 时 候 我 们 需要 在 配置 使 用 拦截 器 栈 的 <interceptor-ref … 人 > 元 素 中 使 
用 <param .… 户 元 素来 传 入 参数 ， 在 <param .…/> 元 素 中 指定 参数 名 时 应 使 用 :< 拦截 器 名 >.< 参 数 名 > 这 种 
形式 ， 这 样 才 可 以 让 Struts 2 明白 我 们 想 米 盖 哪 个 拦截 器 的 哪个 参数 。 

下 面 的 配置 文件 定义 了 一 个 拦截 器 栈 ， 但 这 个 拦截 器 栈 内 包含 了 两 个 拦截 器 。 程 序 在 使 用 该 拦截 
器 栈 时 藉 益 了 指定 拦截 器 中 的 指定 参数 。 

程序 清单 :， codes\04\4.5\override\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<!-- 通过 常量 配置 Struts 2 的 国际 化 资源 信息 -> 
<constant name="struts.custom.il8n,. resources" value="mess"/> 
<!-- 通过 常量 配置 Struts 2 所 使 用 的 解码 集 ~-> 
<constant name="struts.il8n.encoding" value="GBK"/> 
<!-- 配置 本 系统 所 使 用 的 包 --> 
<package name="lee" extends="struts-default"> 
<!-- 应 用 所 需 使 用 的 拦截 器 都 在 该 元 素 下 配置 --> 
<interceptors> 
<!-- 配置 mysimple 拦截 器 --> 
<interceptor name="mysimplen 
class="org.crazyit .app. interceptor.SimpleInterceptor"> 
<!-- 为 拦截 器 指定 参数 值 --> 
<param name="name"> 简 单 拦截 器 </param> 
</interceptor> 
<!-- 配置 第 二 个 拦截 器 --> 
<interceptor name="second" class="lee.SecondInterceptorn/> 
<!-- 配置 名 为 my-stack 的 拦截 器 栈 -> 
<interceptor-stack name="my-stack"> 
<!-- 配置 拦截 器 栈 内 的 第 一 个 拦截 器 --> 
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9 
<interceptor-ref name="mysimple"> 
name="name"> 第 一 个 </param> 
</interceptor-ref> 
<!-- 配置 拦截 器 栈 内 的 第 二 个 拦截 器 一 > 
<interceptor-ref name="second"> 
<param name="name"> 第 二 个 </param> 
</interceptor-ref> 
</interceptor-stack> 
</interceptors> 
<action name="loginPro" class="org.crazyit.app.action.LoginAction"> 
<result name="error">/WEB-INF/content/error.jsp</result> 
<result name="success">/WEB-INF/content/welcome.jsp</result> 
<!-- 配置 系统 的 默认 拦截 器 --> 
<interceptor-ref name="defaultStack"/> 
<!-- 应 用 上 面 的 拦截 器 栈 --> 
<interceptor-ref name="my-stack"> 
<!-- 覆盖 指定 拦截 器 的 指定 参数 值 --> 
name="second.name"> 改 名 后 的 拦 项 器 </param> 
</interceptor-ref> 
</action> 
<action name="*"> 
<result>/WEB-INF/content/{1} .jsp</result> 
</action> 
</package> 
</struts> 


上 面 的 配置 片段 的 第 一 段 粗 体 字 代 码 配 置 了 一 个 名 为 my-stack 的 拦截 器 栈 ， 这 个 拦截 器 栈 包 含 
两 个 拦截 器 ， 这 两 个 拦截 器 分 别 引 用 mysimple 和 second 拦截 器 ， 并 且 著 盖 了 mysimple 拦截 器 的 默认 参数 。 

配置 文件 在 名 为 login 的 Action 中 使 用 my-stack 拦截 器 时 ， 使 用 了 <param..…/> 元 素来 米 盖 该 拦截 
器 栈 里 second 拦截 器 的 name 参数 ， 如 上 面 的 配置 文件 中 粗 体 字 代码 所 示 。 

人 

得 .注意 : 

如 果 需 要 在 使 用 拦截 器 栈 | : 
盖 的 属性 时 ， 不 能 只 指定 属性 名 ， 必 须 加 上 该 属性 属于 的 拦截 名 。 即 采用 如 下 形式 : < y 


拦截 器 名 >.< 属 性 名 >。 


>》>4.5.12 使 用 拦截 器 完成 权限 控制 


前 面 介 绍 的 知识 都 只 是 拦截 器 的 用 法 ， 并 未 涉及 拦截 器 的 实用 功能 。 本 节 将 使 用 拦截 器 来 示范 一 
个 较为 实用 的 功能 : 权限 检查 ， 当 浏览 者 需要 请 求 执行 某 个 操作 时 ， 应 用 需要 先 检查 浏览 者 是 否 登 录 ， 
以 及 是 否 有 足够 的 权限 来 执行 该 操作 。 

本 示例 应 用 要 求 用 户 登录 ， 且 必须 为 指定 用 户 名 才 可 以 查看 系统 中 某 个 视图 资源 ， 否 则 ， 系 统 直 
接 转 入 登录 页 面 。 对 于 上 面 的 需求 ， 可 以 在 每 个 Action 的 执行 实际 处 理 逻 辑 之 前 ， 先 执行 权限 检查 逻 
辑 ， 但 这 种 做 法 不 利于 代码 复 用 。 因 为 大 部 分 Action 里 的 权限 检查 代码 都 大 同 小 异 ， 故 将 这 些 权限 检 
查 的 逻辑 放 在 拦截 器 中 进行 将 会 更 加 优雅 。 

检查 用 户 是 否 登 录 ， 通 常 都 是 通过 跟踪 用 户 的 Session 来 完成 的 ， 通 过 ActionContext 即 可 访问 到 
session 中 的 属性 ， 拦 截 器 的 intercept (ActionInvocation invocation) 方 法 的 invocation 参数 可 以 很 轻易 地 
访问 到 请 求 相 关 的 ActionContext 实例 。 


权限 检查 拦截 器 类 的 代码 如 下 。 
程序 清单 : codes\04\4.5\authorityInterceptor\WEB-INF\src\org\crazyit\app\interceptor 
\AuthorityInterceptor.java 


/7 权限 检查 拦截 器 继承 AbstractInterceptor 类 
public class AuthorityInterceptor 
extends AbstractInterceptor 
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// 拦 截 Action 处 理 的 拦截 方法 

public String intercept (ActionInvocation invocation) 
throws Exception 

{ 
// 取 得 请 求 相关 的 ActionContext 实例 
ActionContext ctx = invocation.getInvocationContext (); 
Map session = ctx.getSession(); 
// 取 出 名 为 user 的 Session 属性 
String user = (String)session.get("user"); 
// 如 果 没 有 登录 ， 或 者 登录 所 用 的 用 户 名 不 是 scott， 都 返回 重新 登录 
if (user != null &6 user.equals ("crazyit.org") ) 
{ 


return invocation.invoke(); 


} 
// 没 有 登录 ， 将 服务 器 提示 设置 成 一 个 HttpServletRequest 属性 
ctx.put ("tip™ , 
"您 还 没有 登录 ， 请 输入 crazyit .org, leegang 登录 系统 ") ; 
// 直 接 返 回 login 的 逻辑 视图 
return Action.LOGIN; 
i 
} 


上 面 的 粗 体 字 代 码 先 通过 ActionInvocation 参数 取得 用 户 Session 实例 的 引用 , 然后 从 中 取出 user 
属性 ， 通 过 判断 该 属性 值 来 确定 用 户 是 否 登录 系统 ， 从 而 判断 是 否 需 要 转 入 登录 页 面 。 

实现 了 上 面 的 权限 检查 拦截 器 ,就 可 以 在 所 有 需要 实现 权限 控制 的 Action 中 复 用 上 面 的 拦截 器 了 。 

为 了 使 用 该 拦截 器 ， 首 先 在 struts.xml 文件 中 定义 该 拦截 器 。 定 义 拦截 器 的 配置 片段 如 下 。 

程序 清单 :codes\04\4.5\authorityInterceptor\WEB-INF\src\struts.xml 


<!-- 用 户 拦截 器 定义 在 该 元 素 下 --> 
<interceptors> 
<!-- 定义 了 一 个 名 为 authority 的 拦截 器 --> 
<interceptor name="authority" 
Class="org.crazyit.app.interceptor.AuthorityInterceptor"/> 
</interceptors> 


定义 了 该 拦截 器 之 后 ， 可 以 在 Action 中 应 用 该 拦截 器 。 应 用 该 拦截 器 的 配置 片段 如 下 : 
<!-- 定义 一 个 名 为 viewBook 的 Action， 其 实现 类 为 ActionSupport --> 
<action name="viewBook"> 
<!-- 返回 success 视图 名 时 ， 
转 入 /WEB-INF/content/viewBook.jsp 页 面 --> 
<result>/WEB-INF/content/viewBook.jsp</result> 
<interceptor-ref name="defaultstack"/> 
<!-- 应 用 自 定义 拦截 器 --> 
<interceptor-ref name="authority"/> 
</action> 


上 面 名 为 viewBook 的 Action， 没 有 指定 class 属性 ， 默 认 使 用 ActionSupport 类 ， 配 置 该 Action 
时 ， 只 指定 了 一 个 结果 映射 ， 指 定 系统 返回 success 字符 串 时 ， 系 统 将 转 入 
/WEB-INF/content/viewBook.jsp 页 面 ， 但 并 未 配置 login 视图 名 对 应 的 JSP 页 面 。 
考虑 到 这 个 拦截 器 的 重复 使 用 ,可 能 多 个 Action 都 需要 跳 转 到 login 逻辑 视图 ， 故 将 login 的 结果 
映射 定义 成 一 个 全 局 结果 上 映射。 下面 是 配置 login 结果 映射 的 配置 片段 。 
<!-- 定义 全 局 Result --> 
<global-results> 
<!-- 当 返 回 login 视图 名 时 ， 转 入 /login.jsp 页 面 --> 
<result name="login">/WEB-INF/content/login.jsp</result> 
</global-results> 
经 过 上 面 的 配置 , 如 果 浏 览 者 在 浏览 器 中 直接 发 送 viewBook 请 求 , 将 会 转 入 如 图 4.33 所 示 的 页 面 。 
如 果 要 简化 struts.xml 文件 的 配置 ， 避 免 在 每 个 Action 中 重复 配置 该 拦截 器 ， 可 以 将 该 拦截 器 配 


置 成 一 个 默认 拦截 器 栈 〈 这 个 默认 拦截 器 栈 应 该 包括 default-stack 拦截 器 栈 和 权限 检查 拦截 器 )。 
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图 4.33 ”拦截 器 进行 权限 检查 
定义 自己 的 默认 拦截 器 栈 的 配置 片段 如 下 : 


<interceptors> 


<!-- 定义 权限 检查 拦截 器 --> 
<interceptor name="authority" class="lee.AuthorityInterceptor®/> 


<!-- 定义 一 个 包含 权限 检查 的 拦截 器 栈 -> 

<interceptor-stack name="mydefault"> 
<!-- 定义 拦截 器 栈 包含 default-stack 拦截 器 栈 --> 
<interceptor-ref name="default-stack"/> 
<!-- 定义 拦截 器 栈 包含 authority 拦截 器 --> 
<interceptor-ref name=" authority"/> 

</interceptor- stack > 

</interceptors> 


- 旦 定义 了 上 面 的 mydefault 拦截 器 栈 ， 这 个 拦截 器 栈 就 包含 了 权限 检查 拦截 器 和 系统 默认 的 拦 
蕉 器 栈 。 如 果 将 这 个 拦截 器 栈 定义 成 默认 拦 蕉 器 ， 则 可 以 避免 在 每 个 Action 中 需要 重复 定义 权限 检查 
拦截 器 。 下 面 的 配置 代码 可 以 将 自 定 义 拦截 器 栈 配置 成 默认 拦截 器 栈 。 
<default-interceptor-ref name="mydefault"/> 
- 旦 在 某 个 包 下 定义 了 上 面 的 默认 拦截 器 栈 ,在 该 包 下 的 所 有 Action 都 会 自动 增加 权限 检查 功能 。 
对 于 那些 不 需要 使 用 权限 控制 的 Action， 将 它们 定义 在 另外 的 包 中 一 一 这 个 包 中 依然 使 用 Struts 2 原 
有 的 默认 拦截 器 栈 ， 将 不 会 有 权限 控制 功能 。 


4.6 使 用 Struts 2 的 Ajax 支持 


Ajax (Asynchronous JavaScript And XML)， 即 异步 JavaScript 和 XML 技术 ， 也 是 Web 2.0 的 核心 
技术 之 一 。Ajax 技术 改进 了 传统 Web 技术 ; 通过 Ajax 技术 , 浏览 者 与 服务 器 之 间 采 用 异步 通信 机 制 ， 
从 而 避免 了 浏览 者 的 等 待 ， 带 给 浏览 者 连续 的 体验 。 它 让 用 户 可 以 连续 发 送 多 次 异步 请 求 ， 而 无 须 等 
待 服务 器 响应 。 当 服务 器 的 响应 成 功 返 回 浏览 器 时 ， 浏 览 器 使 用 DOM (Document Object Model) 将 
服务 器 响应 装载 到 当前 页 面 的 指定 容器 内 。 

传统 的 Web 应 用 大 都 采用 一 种 独占 式 的 请 求 方法 ， 每 个 请 求 对 应 一 个 页 面 ， 因 此 每 当 服务 器 响应 
到 达 客 户 端 时 ， 浏 览 器 都 会 重新 转载 该 响应 ， 从 而 导致 频繁 的 页 面 刷新 。 由 于 传统 B/S 结构 应 用 里 
每 个 页 面 的 使 用 时 间 都 很 短暂 〈 只 用 于 一 次 发 送 请 求 ， 或 一 次 装载 服务 器 响应 )， 因 此 不 可 能 将 该 页 
面 制作 成 表现 功能 丰富 的 页 面 (这样 客户 端的 下 载 成 本 太 高 )， 所 以 传统 B/S 结构 应 用 的 表现 层 页 面 
都 很 简陋 。 

Ajax 技术 的 出 现 ， 完 善 了 传统 的 Web 应 用 的 不 足 。Ajax 技术 使 用 异步 方式 发 送 用 户 请 求 ， 用 户 
在 浏览 页 面 的 同时 可 以 发 送 异步 请 求 ， 在 第 一 个 请 求 的 服务 器 响应 还 没有 完成 时 ， 浏 览 器 可 以 再 次 发 
送 请 求 ， 页 面 状态 不 会 停止 ， 即 使 服务 器 响应 还 没有 到 达 ， 浏 览 者 还 可 以 浏览 原来 的 页 面 。 

当 服 务 器 响应 到 达 客 户 端 时 ， 浏 览 器 也 无 须 重新 加 载 整个 页 面 ， 它 只 更 新 页 面 的 部 分 数据 ， 从 而 
提高 了 页 面 的 利用 时 间 (可 以 使 用 一 个 页 面 发 送 无数 个 请 求 ,装载 无 数 次 响应 )， 因此 可 以 将 表现 层 页 
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面 制作 成 表现 功能 非 
Ajax 技术 的 关键 点 在 于 异步 发 送 请 求 。 当 然 ， 因 为 需要 让 浏览 器 动态 加 载 服务 器 响应 ， 所 以 还 需 
要 利用 传统 的 DHTML 知识 来 实现 HTML 页 面 的 动态 更 新 。 
Struts 2 是 一 个 非常 完备 的 MVC 框架 ， 它 提供 了 非常 完善 的 MVC 功能 。Struts 2.0 曾经 对 DWR 
和 Dojo 进行 了 封装 , 试图 提供 强大 的 Ajax 支持 。 从 Struts 2.1 开始 , Struts 2 把 这 种 Ajax 支持 放 入 Dojo 
插件 内 ，Struts 2 的 核心 功能 不 再 提供 基于 Dojo 的 Ajax 支持 。 本 书 由 于 篇 幅 因 素 不 再 介绍 Dojo 插件 
相关 内 容 ， 如 果 读 者 对 相关 内 容 感 兴趣 可 以 自行 参考 《Struts 2.1 权威 指南 》 一 书 。 


和 4.6.1 使 用 stream 类 型 的 Result 实现 Ajax 


前 面 介绍 过 Struts 2 支持 一 种 stream 类 型 的 Result， 这 种 类 型 的 Result 可 以 直接 向 客户 端 浏览 器 
生成 二 进 制 响应 、 文 本 响应 等 。 那 么 我 们 就 可 让 Struts 2 的 Action 来 直接 生成 文本 响应 ， 接 下 来 在 客 
户 端 页 面 动态 加 载 该 响应 即 可 。 

例如 下 面 做 一 个 非常 简单 的 Ajax 登录 示例 ,浏览 者 输入 用 户 名 、 密码 之 后 , 我们 让 他 以 异步 方式 
来 提交 请 求 ， 而 Struts 2 的 Action 则 直接 输出 登录 结果 一 一 无 须 使 用 额外 的 JSP 页 面 。 下 面 是 本 示例 
的 Action 类 代码 。 

程序 清单 :codes\04W4.6\streamAjax\WEB-INF\src\org\crazyit\app\action\LoginAction.java 

public class LoginAction 


implements Action 


// 封 装 请 求 参数 的 两 个 | 
Private String us 
private String pass; 
// 封 装 输 出 结果 的 二 进 制 流 

Private Inputstream inputstream; 
// 省 略 user 属性 的 setter 和 getter 方法 


7/ 省略 pass 属性 的 setter 和 getter 方法 


{ 


Public Inputstream getResult() 
{ 


return inputstream; 

} 

public String execute() 
throws Exception 


7/ 判断 用 户 名 、 密 码 ， 生 成 对 应 的 响应 
inputStream = user.equals ("crazyit. 5 55 pass.equals ("leegang") 
? new ByteArrayInputSstream(": 1 
.getBytes ("UTF-8")) 
: new ByteArrayInputstream(" 对 不 起 ， 用 户 名 、 害 码 不 匹配 1 " 
getBytes ("UTF-8")); 
return SUCCESS; 


i 


} 
} 


上 面 的 Action 与 普通 登录 Action 大 致 相同 ,同样 提供 了 user、pass 两 个 属性 来 封装 用 户 的 请 求 参 
数 ， 并 为 这 两 个 属性 提供 setter 和 getter 方法 。 但 这 个 Action 与 普通 Action 也 略 有 差别 ， 它 提供 了 一 
个 返回 二 进 制 流 的 方法 ，getResult0 一 一 如 上 面 的 Action 类 中 粗 体 字 代码 所 示 。 

getResult0 方 法 的 返回 的 二 进 制 流 将 会 直接 输出 给 浏览 者 一 一 这 将 会 使 用 stream 类 型 的 Result 来 
完成 ， 而 上 面 的 execute 方法 将 会 根据 浏览 者 输入 的 user、pass 请 求 参数 来 决定 生成 怎样 的 响应 。 

在 struts.xml 文件 中 配置 该 Action， 配 置 片段 如 下 。 

程序 清单 :codes\04\4.6\streamAjax\WEB-INF\src\struts.xml 


<action name="loginPpro" class="org.crazyit.app.action.LoginAction"> 
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<result name="success" type="stream"> 
<!-- 指定 下 载 文件 的 文件 类 型 一 > 
<param name="contentType">text/html</param> 
<!-- 指定 由 getResult () 方 法 返回 输出 结果 的 InputStream --> 
<param name="inputName">result</param> 

</result> 

<!-- 定义 一 个 名 为 login 的 结果 --> 

<result name="login">/WEB-INF/content/login.jsp</result> 

</action> 


示 : 
通过 使 用 stream 类 型 的 Result，Strut 2 可 以 无 需 JSP 视图 页 面 ， 直 接 在 Action 向 浏览 
者 生成 指定 的 响应 | 


接 下 来 只 要 定义 一 个 登录 页 面 ， 该 页 面向 上 面 的 loginPro Action 发 送 异 步 请 求 ， 并 动态 加 载 该 
Action 送 回来 的 响应 即 可 。 

为 了 简单 起 见 ， 我 们 此 处 不 会 去 做 创建 XMLHttpRequest 对 象 、 发 送 异步 请 求 这 些 烦琐 的 步骤 ， 
此 处 将 直接 借助 于 jQuery 这 个 Ajax 库 来 发 送 异 步 请 求 。 页 面 代码 如 下 。 

程序 清单 :codes\04W4.6\streamAjax\WEB-INF\content\loginjsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorpag 
<46 taglib prefix="s" uri="/struts-tags" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<title> 使 用 JSON 插件 </title> 
<script src="${pageContext.request.contextPath} /jquery-1.4;4.min;js” 
type="text/javascript"> 
</script> 
</head> 
<body> 
<s:form id="loginForm"> 
xtfield name="user” label=" 用 户 名 "/> 
‘extfield name="pass"” label=" 窗 码 "/> 
<tr><td colspan="2"> 
<input id="loginBn" type="button” value=" 提 交 "/> 
</td>x/tr> 
</s:form> 
<div ide"show" style="display:none;"> 
</div> 
<script type="text/javascript"> 
// 为 id 为 loginBn 的 按钮 绑 定 事件 处 理 函 数 
$ ("#1loginBn") .click (function() 


{ 
// 指 定向 1oginPro 发 送 请 求 ， 以 id 为 loginForm 表单 里 各 表单 控件 作为 请 求 参数 
$.get("loginPro" , $("#loginForm") .serializeArray() ， 

// 指 定 回调 函数 
Function (data , statusText) 


$("#show") .height (80) 
-width (300) 
-css("border" , "lpx solid black") 
.css("background-color" , "#efef99") 
-css("color" , "#f£0000") 
-css{("padding" , "20px") 
"empty () 7 
$("#show") .append ("登录 结果 : ”+ data + "<br />"); 
$("#show") .show{2000) ; 


Ds; 
</script> 
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</body> 
</html> 


上 面 的 程序 中 粗 体 字 代 码 正 是 通过 jQuery 发 送 异 步 请 求 的 代码 。 在 浏览 器 中 浏览 该 页 面 ， 并 
输入 合适 的 用 户 名 、 密 码 ， 然 后 登录 系统 ， 将 可 以 看 到 如 图 4.34 所 示 结 果 。 


斑 采 结 采 ， 落 要 你 ， 登 孚 成 功 ! 


图 4.34 登录 成 功 


除 此 之 外 ，Struts 2.2 还 提供 了 一 个 JSON 插件 ,通过 该 插件 能 更 简单 地 完成 Ajax 开发 ， 下 面 主要 
以 JSON 插件 为 例 来 介绍 Struts 2 的 Ajax 支持 。 


提示 : 
sa jQuery 是 一 个 非常 优秀 的 、 轻 量 级 Ajax 函数 库 ， 它 不 仅 提供 了 大 量 方 人 的 工具 本 的， 
而 且 对 Ajax 的 支持 也 是 既 简 单 、 又 强大 。 如 果 读 者 希望 获得 更 多 关于 jQuery 的 知识 ， 请 
| 。 条 考 疲 狂 Java 体系 的 《疯狂 Ajax 讲义 


》>>4.6.2 JSON 的 基本 知识 


JSON 的 全 称 是 JavaScript Object Notation， 即 JavaScript 对 象 符号 , 它 是 一 种 轻 量 级 的 数据 交换 格 
式 ,JSON 的 数据 格式 既 适 合 人 来 读 / 写 , 也 适合 计算 机 本 身 解析 和 生成 ,最早 的 时 候 ,JSON 是 JavaScript 
语言 的 数据 交换 格式 ， 后 来 慢 惕 发 展 成 一 种 语言 无 关 的 数据 交换 格式 ， 这 一 点 非常 类 似 于 XML。 

JSON 主要 在 类 似 于 C 的 编程 语言 中 广泛 使 用 ， 这 些 语言 包括 C、C++、C#、Java、JavaScript、 
Perl、Python 等 。JSON 提供 了 多 种 语言 之 间 完成 数据 交换 的 能 力 ， 因 此 ，JSON 也 是 一 种 非常 理想 的 
数据 交换 格式 。JSON 主要 有 如 下 两 种 数据 结构 : 

> 由 key-value 对 组 成 的 数据 结构 ， 这 种 数据 结构 在 不 同 的 语言 中 有 不 同 的 实现 。 例 如 ， 在 

JavaScript 中 是 一 个 对 象 ， 在 Java 中 是 一 种 Map 结构 ， 在 C 语言 中 ， 则 是 一 个 struct。 在 
其 他 语言 中 ， 可 能 有 record、dictionary、hash table 等 。 

> ”有 序 集合 。 这 种 数据 结构 在 不 同 语言 中 ， 可 能 有 list、vector、 数 组 和 序列 等 实现 。 

上 面 的 两 种 数据 结构 在 不 同 的 语言 中 都 有 对 应 的 实现 。 因 此 ， 这 种 简便 的 数据 表示 方式 完全 可 以 
实现 跨 语 言 ， 因 此 可 以 作为 程序 设计 语言 中 通用 的 数据 交换 格式 。 在 JavaScript 中 主要 有 两 种 JSON 
的 语法 ， 一 种 用 于 创建 对 象 ， 另 一 种 用 于 创建 数组 。 

1. 使 用 JSON 语法 创建 对 象 

使 用 JSON 语法 创建 对 象 是 一 种 更 简单 的 方式 ， 使 用 JSON 语法 可 避免 书写 函数 ， 也 可 避免 使 用 
new 关键 字 ， 而 是 直接 获取 一 个 JavaScript 对 象 。 对 于 早期 的 JavaScript 版 本 ， 如 果 要 使 用 JavaScript 
创建 一 个 对 象 ， 通 常情 况 下 可 能 会 这 样 写 : 

7/ 定义 一 个 函数 ， 作 为 构造 器 


function Person (name，sex) 
{ 


this.name = name; 
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this.sex = sex; 


} 

// 创 建 一 个 Person 实例 

var p = new Person('yeeku’, ‘male’); 
// 输 出 Person 实例 


alert (p.name); 
从 JavaScript 1.2 开始 ， 创 建 对 象 有 了 一 种 更 快捷 的 语法 ， 语 法 如 下 : 
var p = { "name": yeeku’, 

"sex" : ‘male’}; 
alert (p); 


图 4.35 JSON 创建 对 象 的 语法 示意 


在 图 4.35 中 ， 创 建 对 象 object 时 ， 总 以 {开始 ， 以 } 结 束 ， 对 象 的 每 个 属性 名 和 属性 值 之 间 以 英文 
冒号 (:) 隔 开 ， 多 个 属性 定义 之 间 以 英文 逗号 〈,) 隔 开 。 语 法 格式 如 下 : 
object = 
propertyNamel ; propertyValuel ， 
propertyName2 : propertyValue2 ， 


} 
必须 注意 的 是 ， 并 不 是 每 个 属性 定义 后 面 都 有 英文 逗号 (,)， 必 须 后 面 还 有 属性 定义 时 才 需 要 去 
号 (,)。 因 此 ， 下 面 的 对 象 定 义 是 错误 的 : 
和 
name : ‘yeeku’, 
sex : ‘male’, 


} 


因为 sex 属性 定义 后 多 出 一 个 英文 逗号 ， 最 后 一 个 属性 定义 的 后 面 直接 以 } 结束 了 ,不 再 有 英文 
逗号 (,)。 

当然 ， 使 用 JSON 语法 创建 JavaScript 对 象 时 ， 属 性 值 不 仅 可 以 是 普通 字符 串 ， 也 可 以 是 任何 基 
本 数据 类 型 ， 还 可 以 是 函数 、 数 组 ， 甚 至 是 另外 一 个 JSON 语法 创建 的 对 象 。 例 如 : 


person = 
{ 
name : ‘yeeku', 
sex : 'male', 
// 使 用 JSON 语法 为 其 指定 一 个 属性 
son:{ 
name: "nono'y 
grade:1 


和 
// 使 用 JSON 语法 为 person 直接 分 配 一 个 方法 
info : function() 
{ 
document .writeln(" 姓 名 : ”+ this.name + "性 别 : " + this.sexX); 
} 
} 


2. 使 用 JSON 语法 创建 数组 


使 用 JSON 语法 创建 数组 也 是 非常 常见 的 情形 ， 在 早期 的 JavaScript 语法 里 ， 我 们 通过 如 下 方式 
来 创建 数组 。 
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7/ 创建 数组 对 象 

var a = new Rrray()7 

// 为 数组 元 素 赋值 

al0] = "yeeku'7 

// 为 数组 元 素 赋值 

all] = ‘nono'; 

或 者 ， 通 过 如 下 方式 创建 数组 : 
// 创 建 数 组 对 象 时 直接 赋值 


Var a = new Array{'yeeku', ‘nono'); 
但 如 果 我 们 使 用 JSON 语法 ， 则 可 以 通过 如 下 方式 创建 数组 : 
// 使 用 JSON 语法 创建 数组 
var a = ['yeeku'’, 'nono']; 
图 4.36 是 JSON 创建 数组 的 语法 示意 。 
ee 
图 4.36 JSON 创建 数组 的 语法 示意 
正如 图 4.36 中 所 见 到 的 ，JSON 创建 数组 总 是 以 英文 方 括号 〈[) 开始 ， 然 后 依次 放 入 数组 元 素 ， 
元 素 与 元 素 之 间 以 英文 逗号 (,) 隔 开 , 最 后 一 个 数组 元 素 后 面 不 需要 英文 逗号 , 但 以 英文 反方 括号 (]) 
结束 。 使 用 JSON 创建 数组 的 语法 格式 如 下 : 
arr = [valuel , value 2 ...] 
与 JSON 语法 创建 对 象 相似 的 是 ， 数 组 的 最 后 一 个 元 素 后 面 不 能 有 逗号 〈,)。 
鉴于 JSON 语法 的 简单 易 用 ， 而 且 作为 数据 传输 载体 时 ， 数 据 传输 量 更 小 ， 因 此 在 Ajax 交互 中 ， 
往往 不 使 用 XML 作为 数据 交换 格式 , 而 是 采用 JSON 作为 数据 交换 格式 。 假 设 需要 交换 一 个 对 象 person， 
其 name 属性 为 yeeku，gender 属性 为 male，age 属性 为 29， 使 用 JSON 语法 可 以 简单 写成 如 下 形式 ， 


person = 

人 
name: 'yeeku', 
gender: ‘male', 
age:29 

} 


但 如 果 使 用 XML 数据 交换 格式 ， 则 需要 采用 如 下 格式 : 


<person> 
<name>yeeku</name> 
<gender>male</gender> 
<age>29</age> 
</person> 


对 比 这 两 种 表示 方式 ， 第 一 种 方式 明显 比 第 二 种 方式 更 加 简洁 ， 数 据 传 输 量 也 更 小 。 
当 服 务 器 返回 一 个 满足 JSON 格式 的 字符 串 后 ， 我 们 可 以 利用 json 扩展 的 方法 将 该 字符 串 转换 成 
-个 JavaScript 对 象 。 登 录 http://wwwjson.org/json2.js 站 点 ， 下 载 json2.js 文件 ， 该 文件 提供 了 一 个 全 
局 的 JSON 对 象 ,该 对 象 包含 两 个 方法 : stringify 和 parse, 其 中 前 者 负责 把 一 个 JSON 对 象 转换 成 JSON 
格式 的 字符 串 ， 而 后 者 则 负责 把 JSON 格式 字符 串 转换 成 JSON 对 象 。 


》>》>4.6.3 实现 Action 还 元 
假设 有 如 图 4.37 所 示 的 输入 页 面 该 页 面 中 包含 了 三 个 表单 域 ， 这 三 个 表单 域 对 应 于 三 个 请 求 参 


数 ， 因 此 应 该 使 用 Action 来 封装 这 三 个 请 求 参数 。 三 个 表单 域 的 namie 分 别 为 field1、field2 和 field3。 
处 理 该 请 求 的 Action 类 代码 如 下 。 
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isld 1 

Field 2 

Field 3: 
3 


图 4.37 输入 页 面 


程序 清单 : codes\04\4.6\struts2json\WWEB-INF\src\org\crazyit\app\actionJSONExample.java 
public class JSONExample 


// 模 拟 处 理 结果 的 属性 

private int[] ints = {10, 20); 

private Map<String , String> map 

new HashMap<string , String>(); 
private String customName = "顾客 "; 

// 封 装 请 求 参 数 的 三 个 属性 

private String fieldl; 

V/'transient "修饰 的 属性 不 会 被 序列 化 
private transient String field2; 

// 没 有 setter 和 getter 方法 的 字段 不 会 被 序列 化 
Private String field37 


public String execute() 
{ 


map.put ("name"，" 狗 狂 Java 讲义 "); 
return Action. SUCCESS; 


/风光 人 折 的 民 名 
QJSON (name="newName") 
public Map getMap() 
{ 
return this.map; 
} 


//customName 属性 的 setter 和 getter 方法 
public void setCustomName (String customName) 
{ 

this.customName = customName; 


上 
public String getCustomName () 
{ 

return this.customName; 


We fieldl、field2、field3 三 个 属性 的 setter、getter 方法 
) 
在 上 面 的 代码 中 ， 使 用 了 JSON 注释 ， 注 释 时 指定 了 name 属性 ，name 属性 用 于 改变 JSON 对 象 
的 属性 名 字 。 除 此 之 外 ，JSON 注释 还 支持 如 下 几 个 属性 。 
> ”serialize: 设置 是 否 序列 化 该 属性 。 
> deserialize: 设置 是 否 反 序列 化 该 属性 。 
> ”format: 设置 用 于 格式 化 输出 、 解 析 日 期 表单 域 的 格式 。 例 如 "yyyy-MM-ddTHH: mm:ss"。 


》>>4.6.4 JSON 插件 与 json 类 型 的 Result 


JSON 插件 提供 了 一 种 json 类 型 的 Result， 一 旦 为 某 个 Action 指定 了 一 个 类 型 为 json 的 Result， 
则 该 Result 无 须 映射 到 任何 视图 资源 。 因 为 JSON 插件 会 负责 将 Action 里 的 状态 信息 序列 化 成 JSON 
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格式 的 字符 串 ， 并 将 该 字符 串 返 回 给 客户 端 浏览 器 。 
简单 地 说 , JSON 插件 允许 我 们 在 客户 端 页 面 的 JavaScript 中 异步 调用 Action, 而 且 Action 不 再 需 


要 使 用 视图 资源 来 显示 该 Action 里 的 状态 信息 , 而 是 由 JSON 插件 负责 将 Action 里 的 状态 信息 返回 给 
调用 页 面 一 一 通过 这 种 方式 ， 就 可 以 完成 Ajax 交互 。 

将 Struts 2 解压 缩 目 录 的 lib 子 目录 下 stmuts2-json-plugin-2.2.1jar 文件 复制 到 Web 应 用 的 
WEB-INF\ib 目录 下 ， 即 可 为 该 Struts 2 应 用 增加 JSON 插件 。 

接 下 来 配置 提供 返回 JSON 字符 串 的 Action， 配 置 该 Action 与 配置 普通 Action 存在 小 小 的 区 别 ， 
应 该 为 该 Action 配置 类 型 为 json 的 Result， 而 这 个 Result 无 须 配置 任何 视图 资源 。 

配置 该 Action 的 struts.xml 文件 代码 如 下 。 

程序 清单 :codes\04W4.6\struts2json\WWEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache.org/dtds/struts-2.1.7.dtd"> 
<struts> 
<constant name="struts.il8n.encoding" value="UTF-8"/> 
<package name="example" extends="json-default"> 
<action name="JSONExample" class="org.crazyit.app.action.JSONExample"> 
<!-- 配置 类 型 的 json 的 Result --> 


param> 
<param name="contentType">text/html</param> 
</result> 
</action> 
<action name="*"> 
<result>/WEB-INF/content/{1) .jsp</result> 
</action> 
</package> 
</struts> 


在 上 面 配置 文件 中 有 两 个 值得 注意 的 地 方 : 
> 第 一 个 地 方 是 配置 struts.i18n.encoding 常量 时 , 不 再 使 用 GBK 编码 , 而 是 使 用 UTF-8 编码 ， 
这 是 因为 Ajax 的 POST 请 求 都 是 以 UTF-8 的 方式 进行 编码 的 。 
> 第 二 个 地 方 是 配置 包 时 ， 自 己 的 包 继 承 了 json-default 包 ， 而 不 再 继承 默认 的 default 包 ， 这 
是 因为 只 有 在 该 包 下 才 有 json 类 型 的 Result。 
- 旦 我 们 将 某 个 逻辑 视图 名 配置 成 json 类 型 ， 这 将 意味 着 该 逻辑 视图 无 须 指定 物理 视图 资源 ， 因 
为 JSON 插件 会 将 该 Action 序列 化 后 发 送 给 客户 端 。 
正如 上 面 的 粗 体 字 代 码 所 示 ， 配 置 json 类 型 的 Result 时 无 须 指 定 任何 视图 资源 一 一 JSON 插件 会 
将 Action 对 象 序列 化 成 一 个 JSON 格式 的 字符 串 ， 并 将 该 字符 串 作为 响应 输出 给 请 求 者 。 
上 面 的 粗 体 字 代码 中 定义 json 类 型 的 Result 时 ， 还 指定 了 noCache、contentType 两 个 参数 ， 这 都 
是 json 类 型 的 Result 的 合法 参数 ，json 类 型 的 Result 可 以 接受 如 表 4.1 所 示 的 常用 参数 。 


表 4.1 json 类 型 的 Result 允许 指定 的 参数 
参数 各 合法 值 说 明 

去 号 随 开 的 多 个 属性 名 所 有 匹配 其 中 任意 一 个 属性 名 表达 式 的 属性 都 不 会 被 序列 化 到 
表达 式 JSON 字符 串 中 

到 号 隔 开 的 多 个 属性 名 所 有 匹配 其 中 任意 一 个 属性 名 表达 式 的 局 性 都 会 被 序列 化 到 
表达 式 JSON 字符 串 中 
设置 该 参数 将 不 再 把 整个 Action 对 象 序列 化 成 JS 


excludeProperties 


IncludeProperties 


OGNL 表达 式 ， 确 定 
Action 内 某 个 属性 
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续 表 
参数 名 合法 值 默认 值 说 了 明 
wrapPrefix 任意 字符 串 设置 在 系统 生成 的 JSON 结果 字符 串 前 添加 园 串 前 统 
wrapSuflix 任意 字符 串 设置 在 系统 生成 的 JSON 结果 字符 囊 后 添加 固定 的 字符 串 后 级 
默认 情况 下 , JSON 插件 只 序列 化 Action 对 象 的 本 身 的 属性 , 不 
ignoreHierarchy tmue 或 false me 会 理会 它 的 父 类 的 属性 。 将 该 属性 设 false， 将 会 序列 化 从 Object 
类 开始 、 所 有 父 类 、 直 到 该 Action 类 中 所 包含 的 全 部 属性 
i i i 设置 是 否 对 JSON 响应 启用 gzip 压缩 。 如 果 启用 gzip 压缩 ， 需 
要 客户 端 浏览 器 支持 
设置 是 否 取 消 浏 览 器 缓存 。 将 该 参数 设 为 rue, 将 意味 着 增加 如 
下 响应 头 : 
noCache mue 或 flse false (Cache-Control: no-cache 
Expires: 0 
Pragma: No-cache 
excludeNullProperties | 。 tmue 或 false false 设置 是 吉 不 序列 化 属性 值 为 null 的 属性 
contentlype 合法 的 MIME 类 型 设置 服务 器 响应 的 类 型 默认 是 exyhtml， 通 常 无 须 修改 


六 4.6.5 实现 JSP 页 面 


为 了 更 简单 地 实现 Ajax 交互 ， 本 页 面 使 用 了 另 一 个 JavaSeript 框架 Prototype.js。 通 过 使 用 该 框 
眼 ， 可 以 更 加 简单 地 访问 页 面 中 的 DOM 节点 ， 包 括 更 好 地 实现 Ajax 交互 。 这 样 避免 去 做 创建 
XMLHttpRequest 对 象 、 发 送 异 步 请 求 这 些 烦琐 的 步骤 。 

下 面 是 该 JSP 页 面 的 代码 。 

程序 清单 ，codes\04\4.6\struts2jsonfirstjsp 


<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" $> 
<%@ taglib prefix="s" uri="/struts-tags" $> 
<!DOCTYPE html PUBLIC *-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head> 
<title> 使 用 JSON 插件 </title> 
<script src="${pageContext.request.contextPath}/prototype-1.6.1.js" 
type="text/javascript"> 
</script> 
<script type="text/javascript"> 
function gotclick() 


{ 
// 请 求 的 地 址 
var url = 'JSONExample.action"; 
// 将 favorite 表单 域 的 值 转换 为 请 求 参数 
var params = Form.serialize('forml'); 
// 创 建 Ajax.Request 对 象 ， 对 应 于 发 送 请 求 
var myAjax = new Ajax.Request( 
urls 
{ 
// 请 求 方式 ， POST 
method: "post' 
// 请 求 参数 
parameters:params, 
// 指 定 回调 函数 
onComplete: processResponse, 
// 是 否 异 步 发 送 请求 
asynchronous:true 
Ds: 
} 
function processResponse (request) 
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// 使 用 JSON 对 象 将 服务 器 响应 解析 成 JSON 对 象 

Var res = request.responseText .evalJSON(); 
// 谢 历 JSON 对 象 的 每 个 属性 

for {var propName in res) 


$ ("show") .innerHTML += propName + " --> " 
+ res[propName] + "<br/>"; 


} 

</script> 

</head> 

<body> 

<s:form id="forml"> 
<s:textfield name="field1" label="Field 1"/> 
<s:textfield name="field2" label="Field 2"/> 
<s:textfield name="field3" label="Field 3"/> 
<tr><td colspan="2"> 
<input type="button” value=" 提 交 " onclick="gotClick();"/> 
</td></tr> 

</s:form> 

<div id="show"> 

</div> 

</body> 

</html> 


在 上 面 的 页 面 中 使 用 了 Prototypejs 的 Ajax.Request 来 完成 Ajax 交互 。 为 了 使 用 Prototypejs， 当 
然 需 要 在 该 页 面 中 导入 Prototypejs 的 代码 库 。 


示 : | 
Prototypejs 是 一 个 非常 小 巧 而 实用 的 JavaScript 函数 库 ,也 支持 以 简单 的 方式 进行 Ajax : 
和》 文 互 . 如 果 读者 需要 获得 更 多 关于 Prototypejs 的 内 容 , 请 参考 疯狂 Java 体系 的 《疯狂 Ajax | 

| 讲义》 一 书 。 


上 面 的 页 面 代码 中 直接 调用 了 字符 串 的 evalJSONO， 该 方法 用 于 将 符合 JSON 格式 的 字符 趾 解析 
为 一 个 JSON 对 象 一 一 上 面 的 程序 将 服务 器 响应 的 字符 串 解析 成 JSON 对 象 ， 这 个 JSON 对 象 完整 地 
保存 了 Action 实例 的 状态 信息 。 

在 浏览 器 中 浏览 该 页 面 ， 如 果 在 上 面 三 个 表单 域 中 完成 输入 ， 然 后 单 击 “ 提 交 ” 按 钮 ， 将 看 到 如 
图 4.38 所 示 的 页 面 。 


novliane —) [object Object] 


图 4.38 使 用 JSON 插件 完成 Ajax 交互 
正如 图 4.38 中 所 看 到 的 ， 页 面 可 以 取得 整个 Action 实例 的 状态 信息 ， 包 括 Action 实例 里 的 每 个 
属性 名 ， 以 及 对 应 的 属性 值 。 既 然 我 们 获得 了 整个 Action 的 状态 信息 ， 就 完全 获得 了 Struts 2 对 该 请 
求 的 处 理 结果 ， 最 后 剩 下 的 事情 就 是 : 通过 DOM 操作 把 这 些 处 理 结果 显示 出 来 。 关 于 如 何 利用 DOM 
动态 改变 HTML 页 面 内 容 ， 请 参考 疯狂 Java 体系 的 《疯狂 Ajax 讲义 》 一 书 。 
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4.7 ”本 章 小 结 


本 章 主要 介绍 了 Struts 2 框架 的 高 级 内 容 ， 主 要 详细 讲解 了 Struts2 框架 的 类 型 转换 和 输入 校 验 ， 
对 所 有 的 MVC 框架 而 言 ， 类 型 转换 和 输入 校 验 都 是 非常 重要 的 内 容 : 类 型 转换 负责 将 字符 串 类 型 的 
请 求 参 数 转换 成 实际 所 需 的 类 型 ， 而 输入 校 验 则 用 于 保证 用 户 输入 的 合法 性 。 

本 章 还 介绍 了 Struts 2 的 文件 上 传 和 下 载 ，Struts 2 对 文件 上 传 提 供 了 完美 的 封装 ， 能 以 非常 简便 
的 方式 同时 上 传 多 个 文件 ，Struts 2 专门 提供 了 stream 结果 类 型 ， 用 于 实现 文件 下 载 。 

本 章 深入 讲解 了 Struts 2 拦截 器 ， 拦 截 器 完成 了 Struts 2 框架 70% 的 工作 ， 例 如 解析 请 求 参数 、 将 
请 求 参数 赋值 给 Action 属性 、 执 行 数据 校 验 、 文 件 上 传 ……Struts 2 框架 的 灵巧 性 ， 主 要 得 益 于 拦截 
器 设计 机 制 ， 当 需要 扩展 Struts 2 功能 时 ， 只 需要 提供 相应 的 拦截 器 ， 并 将 其 配置 在 Struts 2 容器 中 即 
可 ; 如 果 不 需 要 该 功能 ， 也 只 需要 禁用 该 拦截 器 即 可 。 通 过 引入 拦截 器 机 制 ， 允 许 Struts 2 框架 使 用 
可 插 拔 方式 管理 各 种 功能 。 

本 章 没有 全 面 介绍 Struts 2 的 Ajax 支持 ， 例 如 Struts 2 的 Ajax 表单 、Ajax 输入 校 验 等 ， 主 要 介绍 
了 如 何 利用 Struts 2 的 stream Result 开发 Ajax 支持 ， 还 介绍 了 简洁 、 易 用 的 JSON 插件 ， 并 详细 介绍 
如 何 利 用 JSON 插件 完成 Ajax 交互 。 
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第 5 章 
Hibernate 的 基本 用 法 


本 章 要 点 


和 ORM 的 基本 知识 


节 集 合 元 素 为 复合 类 型 的 映射 
划 复 合 主键 映射 
他 使 用 JPA Annotation 管理 映射 信息 
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本 


Hibernate 是 轻 量 级 Java EE 应 用 的 持久 层 解决 方案 , Hibemate 不 仅 管理 Java 类 到 数据 库 表 的 映射 
(包括 Java 数据 类 型 到 SQL 数据 类 型 的 映射 )， 还 提供 数据 查询 和 获取 数据 的 方法 ， 可 以 大 幅度 缩短 
使 用 JDBC 处 理 数据 持久 化 的 时 间 。 

目前 的 主流 数据 库 依然 是 关系 数据 库 ， 而 Java 语言 则 是 面向 对 象 的 编程 语言 ， 当 把 二 者 结合 在 一 
起 使 用 时 相当 麻烦 ， 而 Hibernate 则 减少 了 这 个 问题 的 困扰 ， 它 完成 对 象 模型 和 基于 SQL 的 关系 模型 
的 映射 关系 。 使 得 应 用 开发 者 可 以 完全 采用 面向 对 象 的 方式 来 开发 应 用 程序 。 

Hibernate 较 之 另 一 个 持久 层 框架 iBATIS, Hibernate 更 具有 面向 对 象 的 特征 ; 受 Hibernate 的 影响 ， 
Java EE 5 规范 抛弃 了 传统 的 Entity EJB， 改 为 使 用 JPA 作为 持久 层 解决 方案 。 而 JPA 实体 完全 可 以 当 
成 Hibernate PO 使 用 ， 由 此 可 见 Hibernate 的 影响 深远 。Hibernate 倡导 低 侵 入 式 的 设计 ， 完 全 采用 普 
通 的 Java 对 象 (POJO) 编 程 ， 不 要 求 PO 继承 Hibernate 的 某 个 超 类 或 实现 Hibernate 的 某 个 接口 。 

Hibernate 充当 了 面向 对 象 的 程序 设计 语言 和 关系 数据 库 之 间 的 桥梁 , Hibernate 允许 程序 开发 者 采 
用 面向 对 象 的 方式 来 操作 关系 数据 库 。 因 为 有 了 Hibernate 的 支持 ， 使 得 Java EE 应 用 的 OOA 面向 
对 象 分 析 )、OOD (面向 对 象 设计 ) 和 OOP (面向 对 象 编程 ) 三 个 过 程 一 脉 相 承 ， 成 为 一 个 整体 。 


5.1 ORM 和 Hibernate 


目前 流行 的 编程 语言 ， 如 Java、C# 等 , 它们 都 是 面向 对 象 的 编程 语言 ,而 目前 主流 的 数据 库 产品 ， 
例如 Oracle、DB2 等 ， 依 然 是 关系 数据 库 。 编 程 语言 和 底层 数据 库 的 发 展 不 协调 ， 傣 生出 了 ORM 框 
架 。ORM 框架 可 作为 面向 对 象 编程 语言 和 数据 库 之 间 的 桥梁 。 


》>》》>5.1.1 对 象 /关系 数据 库 映射 (ORM ) 


ORM 的 全 称 是 ObjecvRelation Mapping， 对 象 /关系 数据 库 映 射 。ORM 可 理解 成 一 种 规范 ， 它 概 
述 了 这 类 框架 的 基本 特征 : 完成 面向 对 象 的 编程 语言 到 关系 数据 库 的 映射 。 当 ORM 框架 完成 映射 后 ， 
既 可 利用 面向 对 象 程序 设计 语言 的 简单 易 用 性 , 又 可 利用 关系 数据 库 的 技术 优势 .因此 ,我 们 可 把 ORM 
框架 当成 应 用 程序 和 数据 库 的 桥 妇 。 

当 我 们 使 用 一 种 面向 对 象 的 程序 设计 语言 来 进行 应 用 开发 时 ， 从 项 目 开 始 起 一 直 采 用 的 是 面向 对 
象 分 析 、 面 向 对 象 设计 、 面 向 对 象 编程 ， 但 到 了 持久 层 数据 库 访 问 时 ， 又 必须 重 返 关系 数据 库 的 访问 
方式 ， 这 是 一 种 非常 粮 糕 的 感觉 。 于 是 我 们 需要 一 种 工具 ， 它 可 以 把 关系 型 数据 库 包 装 成 面向 对 象 的 
模型 ， 人 ORM 框架 。 


:其实 Java EE 规范 里 的 JPA 规范 就 是 一 种 ORM 规范 , JPA 规范 并 不 提供 任何 ORM 实 | 
现 ，JPA 规范 提供 了 系列 面向 的 编程 接口 ， 而 JPA 实现 ( 本 质 上 就 是 ORM 框架 ) 则 负责 
| ”为 这 些 编程 接口 提供 实现 .如 果 开发 者 面向 JPA 编程 ， 那 么 应 用 程序 底层 可 以 在 不 同 的 ”| 
ORM 框架 之 间 自由 切换 。 关于 JPA 的 详细 介绍 和 用 法 请 参考 本 书 姊妹 篇 《经 典 Java EE 企 “ 
| 。 业 应 用 实战 | 
ORM 框架 是 面向 对 象 程序 设计 语言 与 关系 数据 库 发 展 不 同步 时 的 中 间 解 决 方案 。 笔 者 认为 ， 随 
着 面向 对 象 数据 库 的 发 展 ， 其 理论 逐步 完善 ， 最 终 会 取代 关系 数据 库 。 只 是 这 个 过 程 不 可 一 中 ! 而 就， 
ORM 框架 在 此 期 间 内 会 鞍 勃 发 展 。 但 随 着 面向 对 象 数据 库 的 广泛 使 用 ，ORM 工具 会 自动 消亡 。 
对 时 下 所 有 流行 的 编程 语言 而 言 ， 面 向 对 象 的 程序 设计 语言 代表 了 目前 程序 设计 语言 的 主流 和 起 
势 ， 具 备 非常 多 的 优势 。 比 如 : 
> ”面向 对 象 的 建 模 、 操 作 。 
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> 多 态 、 继 承 。 

> ” 握 弃 难以 理解 的 过 程 。 

> 简单 易 用 ， 易 理解 。 

但 数据 库 的 发 展 并 未 与 程序 设计 语言 同步 ， 而 且 关 系数 据 库 系统 的 某 些 优势 也 是 面向 对 象 的 语言 
目前 无 法 比拟 的 。 比 如 : 

> 大量 数 据 查找 、 排 序 。 

> 集合 数据 连接 操作 、 映 射 。 

> ”数据 库 访问 的 并 发 、 事 务 。 

> ”数据 库 的 约束 、 隔 离 。 

面 对 这 种 面向 对 象 关系 数据 库 系统 并 存 的 局 面 ， 采 用 ORM 就 变 成 一 种 必然 。 只 要 我 们 还 
是 采用 面向 对 象 程序 设 层 依然 采用 关系 数据 库 , 中 间 就 少不了 ORM 工具 。 当 我 们 采用 ORM 
框架 之 后 ， 应 用 程序 不 再 直接 访问 底层 数据 库 ， 而 是 以 面向 对 象 的 方式 来 操作 持久 化 对 象 〈《 例 如 创建 、 
修改 、 删 除 等 )， 而 ORM 框架 则 将 这 些 面向 对 象 的 操作 转化 成 底层 的 SQL 操作 。 

图 5.1 显示 了 ORM 工具 作用 的 示意 图 。 


保存 基 除 和 ， 


图 5.1 ORM 工具 作用 的 示意 图 


正如 图 5.1 所 示 ，ORM 工具 的 唯一 作用 就 是 : 把 对 持久 化 对 象 的 保存 、 删 除 、 修 改 等 操作 ， 转 换 
成 对 数据 库 的 操作 。 从 此 ， 程 序 员 可 以 以 面向 对 象 的 方式 操作 持久 化 对 象 ， 而 ORM 框架 则 负责 转换 
成 对 应 的 SQL〈 结 构 化 查询 语言 ) 操作 。 


>>5.1.2 基本 映射 方式 


ORM 工具 提供 了 持久 化 类 和 数据 表 之 间 的 映射 关系 ， 通 过 这 种 映射 关系 的 过 渡 ， 我 们 可 以 很 方 
便 地 通过 持久 化 类 实现 对 数据 表 的 操作 。 实 际 上 ， 所 有 的 ORM 工具 大 致 上 都 遵循 相同 的 映射 思路 ， 
ORM 基本 映射 有 如 下 几 条 映射 关系 。 
> ”数据 表 映 射 类 : 持久 化 类 被 映射 到 一 个 数据 表 。 当 我 们 使 用 这 个 持久 化 类 来 创建 实例 、 修 改 属 
性 、 删 除 实例 时 ， 系 统 自动 会 转换 为 对 这 个 表 进 行 CRUD 操作 。 图 5.2 显示 了 这 种 映射 关系 。 
Ac 


数据 表 Model 类 
图 5.2 数据 表 对 应 Model 类 
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正如 图 5.2 所 示 ， 受 ORM 管理 的 持久 化 类 (就 是 一 个 普通 Java 类 ) 对 应 一 个 数据 表 ， 只 要 我 们 
对 这 个 持久 化 类 进行 操作 ， 系 统 可 以 转换 成 对 对 应 数据 表 的 操作 。 

> ”数据 表 的 行 映射 对 象 〈 即 实例 ) : 持久 化 类 会 生成 很 多 实例 ， 每 个 实例 就 对 应 数据 表 中 的 一 
行 记录 。 当 我 们 在 应 用 中 修改 持久 化 类 的 某 个 实例 时 ，ORM 工具 将 会 转换 成 对 对 应 数据 表 
中 特定 行 的 操作 。 每 个 持久 化 对 象 对 应 数据 表 的 一 行 记录 的 示意 图 如 图 5.3 所 示 。 

> ”数据 表 的 列 (字段 ) 映射 对 象 的 属性 : 当 我 们 在 应 用 中 修改 某 个 持久 化 对 象 的 指定 属性 时 ( 持 
久 化 实例 映射 到 数据 行 ) ，ORM 将 会 转换 成 对 对 应 数据 表 中 指定 数据 行 、 指 定 列 的 操作 。 
数据 表 的 列 被 映射 到 对 象 属性 的 示意 图 如 图 5.4 所 示 。 


对 应 实例 
= ) 
实例 二 
应 
/RN 
\ 有 \ 
i 内 性 二 RE 局 性 三 
图 5.3 数据 表 中 的 记录 行 对 应 持久 化 对 象 图 5.4 数据 表 中 的 列 对 应 对 象 的 属性 


基于 这 种 基本 的 映射 方式 ，ORM 工具 可 完成 对 象 模型 和 关系 模型 之 间 的 相互 映射 。 由 此 可 见 ， 
在 ORM 框架 中 ， 持久 化 对 象 是 一 种 中 间 媒 介 ， 应 用 程序 只 需 操作 持久 化 对 象 ， ORM 框架 则 负责 将 这 
种 操作 转换 为 底层 数据 库 操作 一 一 这 种 转换 对 开发 者 透明 ， 无 须 开发 者 关心 。 从 而 将 开发 者 从 关系 模 
型 中 释放 出 来 ， 使 得 开发 者 能 以 面向 对 象 的 思维 操作 关系 数据 库 。 


>>5.1.3 流行 的 ORM 框架 简介 


目前 ORM 框架 的 产品 非常 多 ， 除 了 各 大 著名 公司 、 组 织 的 产品 外 ， 甚 至 其 他 一 些小 团队 也 都 扒 
出 自己 的 ORM 框架 。 目 前 流行 的 ORM 框架 有 如 下 这 些 产品 。 
> ”JPA: JPA 本 身 只 是 一 种 ORM 规范 ， 并 不 是 ORM 产品 。 它 是 Java EE 规范 制定 者 向 开源 
世界 学 习 的 结果 。JPA 实体 与 Hibernate PO 十 分 相似 , 甚至 JPA 实体 完全 可 作为 Hibernate 
PO 类 使 用 。 相 对 于 其 他 开源 ORM 框架 ，JPA 的 最 大 优势 在 于 它 是 官方 标准 ， 因 此 具有 通 
用 性 ， 如 果 应 用 程序 面向 JPA 编程 ， 那 么 应 用 程序 就 可 以 在 各 种 ORM 框架 之 前 自由 切换 ; 
Hibernate? TopLink? OpenJPA? 随 你 喜欢 就 行 。 实 际 上 JPA 的 市 场 用 户 程度 甚至 会 超过 
Hibernate， 连 与 Hibernate 同属 于 JBoss 的 jBPM (工作 流 框架 ) 也 在 官方 文档 中 表示 : 未 
来 的 jBPM 将 会 采用 JPA 作为 持久 层 解决 方案 。 
> ” Hibernate: 目前 最 流行 的 开源 ORM 框架 ， 已 经 被 选 作 JBoss 的 持久 层 解决 方案 。 整个 
Hibernate 项 目 也 一 并 投入 了 JBoss 的 怀抱 ， 而 JBoss 又 加 入 了 Red Hat 组 织 。 因 此 ， 
Hibernate 是 属于 Red Hat 组 织 的 一 部 分 。Hibernate 灵巧 的 设计 、 优 秀 的 性 能 ， 还 有 丰富 的 
文档 都 是 其 风靡 全 球 的 重要 因素 。 
> iBATIS:Apache 软件 基金 组 织 的 子 项 目 。 与 其 称 它 是 一 种 ORM 框架 ,不 如 称 它 是 一 种 “SQL 
Mapping" 框 架 。 曾 经 在 J2EE 开发 中 扮演 非常 重要 的 角色 ， 但 因为 并 不 支持 纯粹 的 面向 对 象 
的 操作 ， 因 此 现在 逐渐 开始 被 取代 。 但 在 一 些 公司 ， 依 然 占 有 一 席 之 地 。 特 别 是 一 些 对 数据 
访问 特别 灵活 的 地 方 ，iBATIS 更 加 灵活 ， 它 允许 开发 人 员 直接 编写 SQL 语句 。 
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> ”TopLink: 是 Oracle 公司 的 产品 , 早年 单独 作为 ORM 框架 使 用 时 一 直 没 有 赢得 广泛 的 市 场 ， 
现在 主要 作为 JPA 实现 。GlassFish 服务 器 的 JPA 实现 就 是 TopLink。 


>>5.1.4 Hibernate 概述 


Hibernate 是 一 个 面向 Java 环境 的 对 象 /关系 数据 库 映射 工具 ， 用 来 把 对 象 模型 表示 的 对 象 映射 到 
基于 SQL 的 关系 模型 数据 结构 中 去 。Hibernate 的 目标 是 释放 开发 者 通常 的 数据 持久 化 相关 的 编程 任 
务 的 95%。 对 于 以 数据 为 中 心 的 程序 而 言 ， 往 往 在 数据 库 中 使 用 存储 过 程 实现 商业 逻辑 ，Hibernate 可 
能 不 是 最 好 的 解决 方案 ; 但 对 于 那些 基于 Java 的 中 间 件 应 用 ， 设 计 采 用 面向 对 象 的 业务 模型 和 商业 过 
辑 ，Hibernate 是 最 有 用 的 。 不 管 怎样 ，Hibernate 能 消除 那些 针对 特定 数据 库 厂商 的 SQL 代码 ， 并 且 

把 结果 集 从 表格 式 的 形式 转换 成 值 对 象 的 形式 。 

Hiberate 不 仅仅 管理 Java 类 到 数据 库 表 的 映射 〈 包 括 Java 数据 类 型 到 SQL 数据 类 型 的 映射 )， 
还 提供 数据 查询 和 获取 数据 的 方法 ， 可 以 大 幅度 减少 开发 时 人 工 使 用 SQL 和 JDBC 处 理 数据 的 时 间 。 

Hibernate 能 在 众多 的 ORM 框架 中 脱颖而出 , 因为 Hibernate 与 其 他 ORM 框架 对 比 具有 如 下 优势 : 

> ”开源 和 免费 的 License， 方 便 需 要 时 研究 源 代码 ， 改 写 源 代码 ， 进 行 功 能 定制 。 

> 轻 量 级 封装 ， 避 免 引 入 过 多 复杂 的 问题 ， 调 试 容易 ， 减 轻 程 序 员 人 负担 。 

> 有 可 扩展 性 ，API 开放 。 功 能 不 够 用 的 时 候 ， 自 己 编码 进行 扩展 。 

> ”开发 者 活跃 ， 产 品 有 稳定 的 发 展 保障 。 


5.2 Hibernate 入 门 


Hibernate 用 法 非常 简单 ， 当 我 们 在 Java 项 目 中 引入 Hibernate 框架 之 后 ， 就 能 以 面向 对 象 的 方式 
操作 关系 数据 库 。 


>>5.2.1 Hibernate 下 载 和 安装 


笔者 成 书 之 时 ，Hibernate 的 最 新 产品 版 本 是 3.6.0 Final， 本 章 所 用 的 代码 也 是 基于 该 版 本 测试 通 
过 的 。 目 前 ，Hibernate 加 入 了 JBoss， 而 JBoss 又 加 入 了 Red Hat， 因 此 登录 www.hibernate.org、 
wwwjboss.org 都 可 看 到 Hibernate 的 链接 ， 都 可 下 载 Hibernate 发 布 版 。 

下 载 和 安装 Hibernate 请 按 如 下 步骤 进行 。 

人 @C 登录 http://www.hiberate.org/downloads 站 点 ， 看 到 一 系列 的 下 载 列表 ， 这 里 只 需要 下 载 
Hibernate 的 核心 部 分 即 可 。 也 就 是 单 击 Hibernate Core 超级 链接 ， 下 载 Hibernate 的 压缩 包 。Windows 
平台 下 载 .zip 包 ，Linux 平台 下 载 .tar 包 。 

Fr 推荐 使 用 Hibernate 3.6.0 Final 版 ， 因 为 Hibernate 各 版 本 之 间 可 能 存在 一 一 些 细节 盖 民 ，] 
对 于 初学 者 而 言 , 如果 学 习 过 程 中 遇 到 由 于 Hibernate 版 本 导致 的 错误 将 会 造成 巨大 的 挫折 | 
| 。 感 ， 不 利于 初学 者 学 习 。 


全 解压 缩 刚 下 载 的 压缩 包 ， 解 压缩 得 到 一 个 名 为 hibernate-distribution-3.6.0.Final 的 文件 夹 ， 该 
文件 夹 下 包含 如 下 文件 结构 
> ”documentation: 该 路 径 下 存放 了 Hibernate 的 相关 文档 ， 包 括 Hibernate 的 参考 文档 和 API 
文档 等 。 
> lib: 该 路 径 下 存放 了 Hibernate 3.6 编译 和 运行 所 依赖 的 第 三 方 类 库 。 其 中 lib 路 径 下 的 
required 子 目录 下 保存 了 运行 Hibernate 3.6 项 目 必需 的 第 三 方 类 库 。 
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> ”project: 该 路 径 下 存放 了 Hibernate 各 种 相关 项 目的 源 代码 。 
> _ hibernate3.jar: 这 个 文件 是 Hibernate 3.6 核心 JAR 包 。 不 管 是 使 用 Hibernate 框架 ， 还 是 
使 用 Hibernate JPA 实现 都 需要 这 个 JAR 包 。 
> ”lgpl.txt、logo 等 杂项 文件 。 
人 将 解压 缩 路 径 中 hibernate3.jar 和 lib 路 径 下 的 required、bytecode、jpa 子 目 录 下 所 有 JAR 包 添 
加 到 应 用 的 类 加 载 路 径 中 一 一 既 可 通过 添加 环境 变量 的 方式 来 添加 ， 也 可 使 用 Ant 或 IDE 工具 来 管理 
应 用 程序 的 类 加 载 路 径 。 
@ 如 果 直 接 在 控制 台 编译 时 使 用 了 Hibernate API 的 类 ， 则 需要 将 hibernate3.jar 文件 位 置 添 加 到 
CLASSPATH 里 。 如 果 使 用 Ant 工具 或 者 Eclipse 等 IDE 工具 ， 则 无 须 修改 环境 变量 。 
经 过 上 面 的 步骤 ， 就 可 以 在 应 用 中 利用 Hibernate 框架 的 功能 了 。 
人 


注意 :4 - 
由 于 Hibemate 底层 依然 是 基于 JDBC 的 ， 因 此 在 应 用 程序 中 使 用 Hibernate 执行 持久 化 


时 一 定 少不了 JDBC 驱动 .本 示例 程序 底层 采用 MySQL 数据 库 ， 因 此 还 需要 将 MySQL 数据 < 
库 驱动 添加 到 应 用 的 关 加 载 路 径 中 守 


》》5.2.2 Hibernate 的 数据 库 操 作 


前 面 已 经 介绍 了 ， 在 所 有 ORM 框架 中 有 一 个 非常 重要 的 媒介 : PO 〈Persistent Object， 持 久 化 对 
象 )， 持 久 化 对 象 的 作用 是 完成 持久 化 操作 ， 简 单 地 说 ， 通 过 该 对 象 可 对 数据 执行 增 、 删 、 改 的 操作 
一 一 以 面向 对 象 的 方式 操作 数据 库 。 

应 用 程序 无 须 直 接 访问 数据 库 ， 甚 至 无 须 理会 底层 数据 库 采用 何 种 数据 库 一 一 这 一 切 对 应 用 程序 
完全 透明 ， 应 用 程序 只 需 创建 、 修 改 、 删 除 持久 化 对 象 即 可 ， 与 此 同时 ，Hibernate 则 负责 把 这 种 操作 
转换 为 对 指定 数据 表 的 操作 。 

Hibernate 里 的 PO 是 非常 简单 的 , 前 面 已 经 说 过 Hibernate 是 低 侵 入 式 的 设计 , 完全 采用 普通 Java 
对 象 作为 持久 化 对 象 使 用 ， 看 下 面 的 POJO (普通 Java 对 象 ) 类。 

程序 清单 : codes\05\5.2\HibernateQs\src\org\crazyitapp\domain\News.java 

public class News 


// 消 息 类 的 标识 属性 
private Integer id; 
// 消 息 标题 
private String title; 
// 消 息 内 容 
private String content; 
//id 属性 的 setter 和 getter 方法 
Ppublic void setId(Integer id) 
{ 
this.id = id; 


} 
Public Integer getId() 
{ 

return this.id; 


jitle 属性 的 setter 和 getter 方法 
public void setTitlel(String title) 
2 this.title = titles 

上 String getTitlet) 

return this.title; 
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} 
//content 属性 的 setter 和 getter 方法 
public void setContent (String content) 


{ 
this.content = content; 


} 
public String getContent () 
{ 


return this.content; 
A 
仔细 看 上 面 这 个 类 的 代码 ， 无 法 发 现 这 个 类 与 普通 的 JavaBean 有 任何 区 别 。 实 际 上 ，Hibernate 
直接 采用 了 POJO 普通 、 传 统 Java 对 象 ) 作 为 PO， 这 就 是 Hibernate 被 称 为 低 侵入 式 设计 的 原因 ， 
Hibernate 不 要 求 持久 化 类 继承 任何 父 类 ， 或 者 实现 任何 接口 ， 这 样 可 保证 代码 不 被 污染 。 
这 个 普通 的 JavaBean 目前 还 不 具备 持久 化 操作 的 能 力 ， 为 了 使 其 具备 持久 化 操作 的 能 力 ， 
Hibernate 采用 XML 映射 文件 ， 该 映射 文件 也 是 非常 简单 的 。 下 面 提 供 该 XML 文件 的 全 部 代码 。 
程序 清单 : codes\05\5.2\HibernateQs\src\org\crazyit\app\domain\News.hbm.xml 
9xml version="1.0" encoding="gb2312"?> 
<!-- 指定 Hibernate3 映射 文件 的 DTD 信息 --> 
<1DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
whttp://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- hibernate-mapping 是 映射 文件 的 根 元 素 --> 
<hibernate-mapping package="org,crazyit.app.domain"> 
<!-~ 每 个 class 元 素 对 应 一 个 持久 化 对 象 -> 
<class name="News" table="news_table"> 
<1-- id 元素 定义 持久 化 美的 标识 属性 -> 
<id name="id"> 
<!-- 指定 主键 生成 策略 --> 
<generator class="identity"/> 
</id> 
<!-- property 元素 定义 常规 属性 --> 
<property name="title"/> 
<property name="content"/> 
</class> 
</hibernate-mapping> 
对 这 个 文件 简单 地 解释 一 下 : 映射 文件 的 第 1 行 属于 XML 声明 部 分 , 它 指定 了 XML 文件 的 版 本 、 
编码 所 用 的 字符 集 信息 ， 映 射 文件 的 第 2、3、4 行 指定 了 Hibernate 映射 文件 的 DTD 信息 ， 这 4 行 对 
于 所 有 Hibernate 3.6 的 映射 文件 全 部 相同 。<hibernate-mapping... 人 > 元 素 是 所 有 Hibernate 映射 文件 的 根 
元 素 ， 这 个 根 元 素 对 所 有 的 映射 文件 都 是 相同 的 。 
<hibernate-mapping.… 人 > 元 素 下 有 class 子 元 素 ， 每 个 class 子 元 素 映射 一 个 PO， 更 准确 地 说 ， 应 该 
是 持久 化 类 。 可 以 看 到 : 
PO = POJO + 映射 文件 
现在 就 可 以 通过 这 个 持久 化 类 来 完成 对 数据 库 的 操作 了 ， 即 插入 一 条 消息 。 
通过 上 面 的 映射 文件 ，Hibernate 可 以 理解 持久 化 类 和 数据 表 之 间 的 对 应 关系 ， 也 可 以 理解 持久 化 
类 属性 与 数据 表 列 之 间 的 对 应 关系 。 但 无 法 知道 连接 哪个 数据 库 ， 以 及 连接 数据 库 时 所 用 的 连接 池 、 
用 户 名 和 密码 等 详细 信息 。 这 些 信息 对 于 所 有 的 持久 化 类 都 是 通用 的 ， 我 们 把 这 些 通 用 信息 称 为 
Hibernate 配置 信息 ， 配 置信 息 使 用 配置 文件 指定 。 
Hibernate 配置 文件 既 可 以 使 用 *.properties 的 属性 文件 ， 也 可 以 使 用 XML 文件 配置 。 在 实际 应 用 
中 ， 通常 使 用 XML 文件 配置 。 下 面 是 本 应 用 中 XML 配置 文件 的 详细 代码 。 
程序 清单 : codes\0S\5.2\HibernateQs\src\hibernate.cfeg.xml 


<3xml version="1.0" encoding="GBK"?> 
<!-~ 指定 Hibernate 配置 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-configuration PUBLIC 
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"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 

“http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 
<!-- hibernate- configuration 是 连接 配置 文件 的 根 元 素 -> 
<hibernate-configuration> 

<session-factory> 


<!--~ 指定 连接 数据 库 所 用 的 驱动 --> 

<property name="connection.driver. class">com.mysql.jdbc.Driver</property> 
<!-- 指定 连接 数据 库 的 url，hibernate 连接 的 数据 库 名 --> 

<Property name="connection.url">jdbc:mysql://localhost/hibernate</property> 
<!-- 指定 连接 数据 库 的 用 户 名 --> 

<property name="connection.username">root</property> 
<!-- 指定 连接 数据 库 的 密码 一 > 

<p name="connection.password">32147</property> 
<!-- 指定 连接 池 里 最 大 连接 数 -> 

<property name="hibernate.c3p0.max_size">20</property> 
<!-- 指定 连接 池 里 最 小 连接 数 > 

<property name="hibernate.c3p0.min size">1</property> 


<!~~ 指定 连接 池 里 连接 的 超时 时 长 -> 
<property name="hibernate. c3p0. timeout ">5000</property> 
<!-- 指定 连接 池 里 最 大 缓存 多 少 个 Statement 对 象 --> 
<property name="hibernate.c3p0,max_statements">100</property> 
<property name="hibernate.c3p0.idle_test_period">3000</property> 
‘<property name="hibernate.c3p0.acquire_ increment">2</property> 
<property name="hibernate.c3p0.validate">true</property> 
<!-- 指定 数据 库 方言 --> 
<property name="dialect">org.hibernate .dialect.MySQLInnoDBDialect</property> 
<!-- 根据 需要 自动 创建 数据 表 一-> 
<property name="hbm2ddl .auto">update</Property><!--(--> 
<!-- 罗列 所 有 的 映射 文件 -> 
resource="org/crazyit/app/domain/News .hbm. xml1"/> 
</session-factory> 
</hibernate-configuration> 


Hibernate 配置 文件 的 默认 文件 名 为 hibernate.cfg.xml, 当 程序 调用 Configuration 对 象 的 configure() 
方法 时 ，Hibernate 将 自动 加 载 该 文件 。 

Hibernate 映射 文件 也 是 一 个 XML 文件 ， 所 以 该 文件 第 一 行 一 样 是 XML 文件 声明 ， 指 定 该 XML 
文件 的 版 本 和 编码 所 用 的 字符 集 。 

Hibemate 配置 文件 的 根 元 素 是 <hibernate-configuration.../>, 根 元 素 里 有 <session-factory.../> 子 元 素 ， 
该 元 素 依次 有 很 多 <property.… 人 > 子 元 素 ， 这 些 <property../> 子 元 素 配置 Hibernate 连接 数据 的 必要 信息 ， 
如 连接 数据 库 的 驱动 、URL、 用 户 名 、 密 码 等 信息 ， 如 上 面 的 配置 文件 中 前 4 行 粗 体 字 代码 所 示 。 

除 此 之 外 ，Hibernate 并 不 推荐 采用 DriverManager 来 连接 数据 库 ， 而 是 推荐 使 用 数据 源 来 管理 数 
据 库 连接 ， 这 样 能 保证 最 好 的 性 能 。Hibernate 推荐 使 用 C3P0 数据 源 ， 上 面 的 配置 文件 中 斜体 字 代码 
指定 C3P0 数据 源 的 配置 信息 ， 包 括 最 大 连接 数 、 最 小 连接 数 等 信息 。 
提示 ;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 


当 程序 创建 才 据 源 实 例 时 ， 系统 会 一 次 性 地 创建 多 个 数据库 连接 ， 并 可 这 此 可 据 库 过 技 人 | 
| 。 存在 连接 池 中 。 当 程序 需要 进行 数据 库 访问 时 ， 无 须 进 行 重新 获得 数据 库 连接 ， 而 是 从 连 ， 
: 。 接 池 中 取出 一 个 空 用 的 数据 库 连 接 。 当 程序 使 用 数据 库 连 接 访问 数据 库 结束 后 ， 无 须 关闭 | 
| 。 数据 库 连 接 ， 而 是 将 数据 库 连 接 归还 给 连接 池 即 可 .通过 这 种 方式 ， 就 可 避免 频繁 地 获取 ， 
数据 库 连接 、 关 闭 数 据 库 连接 所 导致 的 性 能 下 降 。 | 


由 于 上 面 的 程序 需要 使 用 C3P0 连接 池 ， 因 此 我 们 还 需要 将 hibernate-distribution-3.6.0.Final\ib 的 
optional 子 目录 下 的 c3p0 目录 下 的 JAR 包 也 添加 到 系统 的 类 加 载 路 径 下 。 

除 此 之 外 ， 由 于 Hibemate 3.6 改 为 使 用 SLF4J 作为 日 志 工具 〈 可 以 在 libvequired 子 目录 下 看 到 
slf4j-api-1.6.1.jar)， 但 Hibernate 项 目下 默认 只 有 SLF4J 日 志 工具 的 API 包 ， 并 没有 实现 包 。 读 者 可 以 
登录 http:/hwww.slf4j.org/download.html, 自行 下 载 SLF4] 日 志 工 具 , 下 载 完 成 后 得 到 一 个 slf4j-1.6.1.zip 
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压缩 包 ， 再 将 该 压缩 包 中 包含 的 slf4j-nop-1.6.1;jar 也 添加 到 系统 的 类 加 载 路 径 下 。 
本 程序 所 用 到 的 JAR 文件 如 图 5.5 所 示 。 


rr 


| 


图 5.5 运行 Hibernate 应 用 的 必需 类 库 


上 面 的 配置 文件 的 号 粗 体 字 代码 指定 了 hbm2ddl.auto 属性 , 该 属性 指定 是 否 需 要 Hibernate 根据 
映射 文件 来 自动 创建 数据 表 一 一 本 应 用 指定 update， 即 表示 Hibernate 会 根据 映射 文件 创建 数据 表 。 

<session-factory .…/> 元 素 还 可 接受 多 个 <mapping ,… 亿 元素， 每 个 <mapping … 人 > 元 素 指定 一 个 映射 
文件 ，<mapping .… 人 元 素 可 以 指定 一 个 resource 属性 ， 该 属性 指定 Hibernate 映射 文件 的 文件 名 。 如 果 
有 多 个 持久 化 映射 文件 ， 在 此 处 罗列 多 个 <mapping .…/> 元 素 即 可 。 

下 面 是 完成 消息 插入 的 代码 。 

程序 清单 :codes\05\5.2\HibernateQs\src\lee\NewsManagerjava 


public class NewsManager 
{ 
public static void main(String[] args) throws Exception 
{ 


// 实 例 化 Configuration， 
Configuration conf = new Configuration() 
// 下 面 的 方法 默认 加 载 hibernate.cfg.xml 文件 
:configure(); 
// 以 configuration 创建 SessionFactory 
SessionFactory sf = conf.buildSsessionFactory(); 
// 创 建 Session 
Session sess = sf.openSession(); 
// 开 始 事务 
Transaction tx = sess.beginTransaction(); 
// 创 建 消息 实例 
News n = new News(); 
// 设 置 消息 标题 和 消息 内 容 
n.setTitle(" 烘 疗 Java 钳 久 成 这 三") 7 
n.setContent (" 鼎 闻 Java 有 鹏 成 立 7，” 
+ " 语 埋 岗 岩 http://www. crazyit.org"); 
// 保 存 消息 
sess. save (n); 
// 提 交 事务 
tx.commit(); 
// 关 闭 Session 
sess.close(); 
sf.close(); 
} 
} 


上 面 的 持久 化 操作 的 代码 非常 简单 ， 保 存 消息 只 需要 程序 中 斜体 字 所 示 的 代码 : 程序 先 创 建 一 个 
News 对 象 ， 再 使 用 Session 的 save 方法 来 保存 News 对 象 即 可 ， 这 是 完全 对 象 化 的 操作 方式 ， 可 以 说 
是 非常 简单 、 明 了 。 当 Java 程序 以 面向 对 象 的 方式 来 操作 持久 化 对 象 时 ，Hibernate 负责 将 这 种 操作 转 
换 为 底层 SQL 操作 。 

因此 当 上 面 的 程序 运行 结束 后 , 我 们 将 可 以 看 到 Hibernate 数据 库 中 多 了 一 个 数据 表 : news_table， 
且 该 表 中 包含 了 News 实例 对 应 的 记录 ， 如 图 5.6 所 示 。 
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mysql> select * from news table: 
be et 


| id | title | content 


图 5.6 使 用 Hibemate 成 功 插入 记录 


上 面 程序 中 粗 体 字 代码 显示 : 执行 session.save(News) 之 前 ， 先 要 获取 Session 对 象 。PO 只 有 在 
Session 的 管理 下 才 可 完成 数据 库 访问 。 为 了 使 用 Hibernate 进行 持久 化 操作 ， 通 常 有 如 下 操作 步骤 。 

人 开发 持久 化 类 ， 由 POJO 加 映射 文件 组 成 。 

人 获取 Configuration。 

@ 获取 SessionFactory 。 

@ 获取 Session， 打 开 事务 。 

外 用 面向 对 象 的 方式 操作 数据 库 。 

多 关闭 事务 ， 关 闭 Session。 

随 PO 与 Session 的 关联 关系 ，PO 可 有 如 下 三 种 状态 。 

> 瞬 态 : 如 果 PO 实例 从 未 与 Session 关联 过 ， 该 PO 实例 处 于 瞬 态 状态 。 

> ”持久 化 :如果 PO 实例 与 Session 关联 起 来 ， 且 该 实例 对 应 到 数据 库 记录 ， 则 该 实例 处 于 持 

久 化 状态 。 
> ” 脱 管 ， 如 果 PO 实例 曾经 与 Session 关联 过 ， 但 因为 Session 的 关闭 等 原因 ，PO 实例 脱离 
了 Session 的 管理 ， 这 种 状态 被 称 为 脱 管状 态 。 

对 PO 的 操作 必须 在 Session 管理 下 才能 同步 到 数据 库 。Session 由 SessionFactory 工厂 产生 ， 
SessionFactory 是 数据 库 编译 后 的 内 存 镜像 ,通常 一 个 应 用 对 应 一 个 SessionFactory 对 象 .SessionFactory 
对 象 由 Configuration 对 象 生成 ，Configuration 对 象 负责 加 载 Hibernate 配置 文件 。 

上 面 是 使 用 Hibemate 添加 了 一 条 记录 ， 对 比 Hibernate 和 JDBC 两 种 操作 数据 库 的 方式 ， 不 难 发 
现 Hibernate 的 两 个 显著 优点 : 

> 不 再 需要 使 用 编写 SQL 语句 ， 而 是 允许 采用 OO 方式 来 访问 数据 库 。 

> JDBC 访问 过 程 中 大 量 的 checked 异常 被 包装 成 Hibernate 的 Runtime 异常 ， 从 而 不 再 要 求 

程序 必须 处 理 所 有 异常 。 


> >5.2.3 在 Eclipse 中 使 用 Hibernate 


正如 前 面 已 经 提 到 的 ， 使 用 任何 IDE 工具 来 辅助 开发 之 前 ， 应 该 很 清楚 不 使 用 工具 如 何 使 用 该 技 
术 。IDE 工具 仅 用 于 辅助 开发 ， 提 高 开发 效率 ， 绝 对 无 法 弥补 开发 者 的 知识 缺陷 。 

在 Eclipse 中 开发 Hibemate， 可 以 借助 于 一 些 插件 ， 例 如 Middle Gen、Synchronizer 等 。 事 实 上 ， 
使 用 这 些 工具 无 非 是 根据 数据 表 生 成 POJO， 或 者 根据 POJO 生成 配置 文件 等 。 这 些 工具 完成 的 功能 
仅仅 是 提高 了 开发 者 的 开发 效率 ， 并 不 能 真正 代替 开发 者 思考 。 

如 果 不 借助 任何 插件 ， 使 用 Eclipse 开发 Hibemate 应 用 与 不 借助 任何 开发 工具 的 开发 完全 类 似 。 
下 面 以 Hibernate 官方 站 点 提供 的 HibernateTools 作为 插件 来 开发 Hibernate 应 用 。 

下 载 和 安装 HibernateTools 请 按 如 下 步骤 进行 。 

人 。 登录 http://wwwjboss.org/tools/download/stable/3_1_GA.html 站 点 ， 单 击 “Hibemate Tools” 对 
应 的 链接 ， 下 载 Hibernate Tools 的 最 新 版 ， 该 工具 的 最 新 版 本 是 HibernateTools-3.3.1。 

人 @ 将 下 载 到 的 zip 压缩 包 解压 缩 , 解压 缩 路 径 下 包含 两 个 路 径 : features 和 plugins。 可 见 Hibernate 
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Tools 就 是 Eclipse 插件 。 

@ 使 用 扩展 安装 的 方式 将 该 插件 安装 在 Eclipse 中 (关于 扩展 安装 的 方法 ， 请 参阅 第 1 章 部 分 内 
容 )。 

安装 了 Hibernate Tools 插件 后 ， 请 按 如 下 步骤 开发 Hibernate 应 用 。 

人 G 单 击 Eclipse 主 菜单 中 的 “File” 一 “New” 一 “Java Project” 菜 单项 ， 出 现 如 图 5.7 所 示 的 新 
建 项 目 对 话 框 。 在 该 对 话 框 中 输入 项 目 名 ， 这 里 输入 项 目 名 为 HibernateDemo， 如 图 5.7 所 示 。 

人 单 击 如 图 5.7 所 示 对 话 框 中 的 “Finish” 按 钮 ， 项 目 建立 成 功 。 建 立成 功 后 ， 可 以 看 到 Eclipse 
左上 角 的 界面 如 图 5.8 所 示 。 


图 5.7 输入 项 目 名 图 5.8 新 建 项 目的 包 结构 图 
@ 右 击 如 图 5.8 所 示 的 HibernateDemo 节点 (图 5.8 中 选 蓝 节点 )， 在 出 现 的 菜单 中 单 击 “Build 


Path” 菜 单项 ， 在 出 现 的 下 一 级 菜单 中 单 击 “Configure Build Path.…” 菜 单项 ， 将 出 现 如 图 5.9 所 示 的 
对 话 框 。 


图 5.9 编辑 项 目 Build Path 的 对 话 框 


@ 如 图 5.9 所 示 的 对 话 框 主要 用 于 设置 编译 和 运行 该 项 目 所 需 的 第 三 方 类 库 。 单 击 右边 的 “Add 
Library” 按 钮 ， 在 出 现 的 对 话 框 中 选中 “User Library”， 并 单 击 “Next” 按 钮 ， 将 出 现 如 图 5.10 所 示 
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和 


的 选择 用 户 库 对 话 框 一 一 这 个 过 程 表 示 将 选择 一 个 用 户 库 ， 一 个 用 户 库 可 包含 多 个 JAR 文件 。 


提示 : 
读者 可 能 见 到 如 图 5.10 所 示 的 对 话 框 中 已 经 有 了 一 个 或 多 个 用 户 库 ， 这 些 用 户 库 是 笔 。 
者 之 前 添加 的 一 一 添加 用 户 库 的 作用 是 可 以 重复 使 用 。 如 果 读 者 是 第 一 次 进入 该 界面， 应 | 
| 。 该 没有 任何 的 用 户 库 。 


@ 如 果 读者 的 Eclipse 中 没有 任何 用 户 库 , 则 需要 添加 自己 的 用 户 库 。 单 击 如 图 5.10 所 示 的 对 话 
框 右边 的 “User Libraries” 按 钮 ， 将 出 现 如 图 5.11 所 示 的 编辑 用 户 库 对 话 框 。 

人 @ 如 果 需 要 新 增 自己 的 用 户 库 ， 应 该 单 击 “New..” 按 钮 ， 将 出 现 输入 用 户 库 名 字 对 话 框 ， 如 图 
5.12 所 示 。 


er rece we 
er ores an be edted to sj Peld pm end we mrt eae 
am at ede a mp met 
mena ne rome 


图 5.11 编辑 用 户 库 对 话 框 图 5.12 输入 用 户 库 的 名 学 
人 @ 在 如 图 5.12 所 示 的 对 话 框 中 输入 用 户 库 的 名 字 ， 然 后 单 击 “OK” 按 钮 ， 将 返回 如 图 5.11 所 
示 的 对 话 框 。 
味 . 
pp -注意 1 间 入 a 


| 新 建 的 用 户 库 仅 有 一 个 用 户 库 名 ， 并 不 包含 任何 的 JAR 文件 
来 为 用 户 库 添 加 所 需 的 JAR 文件 


人 @ 选中 如 图 5.12 所 示 对 话 框 中 需要 编辑 的 用 户 库 的 名 字 ， 然 后 单 击 “Add JARs...” 按 钮 ， 将 出 
现 一 个 文件 浏览 对 话 框 ， 在 该 文件 对 话 框 中 选中 hibernate3.jar 文件 ， 重 复 该 操作 ， 选 中 编译 和 运行 
Hibernate 所 需 的 全 部 JAR 文件 。 

人 @ 单 击 如 图 5.11 所 示 对 话 框 中 的 “OK” 按 钮 ， 将 返回 如 图 5.10 所 示 的 对 话 框 ， 勾 选 所 需 的 用 
户 库 ， 然 后 单 击 “Finish” 按 钮 ， 返 回 Eclipse 主 界面 。 
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@ 重复 第 4 步 到 第 10 步 的 操作 ， 为 该 项 目 添加 数据 库 驱动 。 添 加 所 有 的 Hibernate 编译 和 运行 

所 需要 的 JAR 文件 后 ， 看 到 Eclipse 左上 角 的 包 结构 图 如 图 5.13 所 示 。 
关注 意 : 一 

刚才 所 添加 的 Eclipse 用 户 库 只 能 保证 在 Eclipse 下 编译、 运行 该 程序 可 找到 相应 的 
类 库 ; 如 果 需 要 发 布 该 应 用 ， 则 还 需要 将 刚刚 添加 的 用 户 库 所 引用 的 JAR 文件 随 应 用 一 
起 发 布 . 对 于 一 个 Web 应 用 ,由 于 Eclipse 部 署 Web 应 用 时 不 会 将 用 户 库 的 JAR 文件 复 
制 到 Web 应 用 的 WEB-INF/lib 路 径 下 ， 所 以 我 们 需要 主动 将 用 户 库 所 引用 的 JAR 文件 
复制 到 Web 应 用 的 WEB-l INF/ib 小 径 下 。 


是 右 击 如 图 5.13 所 示 的 “HibemateDemo” 节 点 ， 在 出 现 的 菜单 中 单 击 “New” 菜 单项 ， 在 出 现 
的 下 一 级 菜单 中 单 击 “Others…” 菜 单项 ，Eclipse 出 现 新 建 项 目 或 文件 的 对 话 框 ， 单 击 该 对 话 框 中 的 
“Hibernate” 节 点 ， 并 选中 该 节点 的 “Hibernate Configuration File(cfg.xml)” 子 节点 ， 然 后 单 击 “Next” 
按钮 ， 将 贞观 前 几 < 14 所 示 的 对 话 框 。 


EE IE Td) 


Ee 
外 


生生 


图 5.13 ”添加 完 编译 和 运行 Hiberate 的 JAR 文件 后 的 包 结构 图 图 5.14 新 建 hibemate.cfg.xml 配置 文件 


全 图 5.14 所 示 对 话 框 最 上 面 的 文本 框 用 于 设置 hibermate cfg.xml 文件 的 保存 位 置 , 该 文件 通常 保 
存在 sre 路 径 下 ， 如 图 5.14 所 示 。Hibernate 的 配置 文件 名 通常 是 hibemnate.cfg.xml 文件 ， 因 此 下 面 的 
文本 框 无 须 修改 。 单 击 “Next” 按 钮 ， 将 出 现 如 图 5.15 所 示 的 对 话 框 


图 5.15 设置 Hibernate 配置 文件 的 属性 
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六 


全 图 5.15 用 于 设置 Hibernate 配置 文件 的 属性 ， 这 里 输入 的 数据 将 用 于 生成 hibemate.cfg.xml 文 
件 。 在 该 对 话 框 中 分 别 输入 数据 库 方言 、 数 据 库 驱 动 、 数 据 库 服务 的 URL、 用 户 名 、 密 码 等 信息 。 最 
后 单 击 “Finish” 按 钮 ，Hibernate 配置 文件 建立 成 功 。 

经 过 漫长 的 “下 一 步 ““ 下 一 步 ”操作 ，Eclipse 终于 帮 我 们 生成 了 一 个 hibernate.cfg.xml 文件 。 
如 果 开 发 者 需要 增加 其 他 额外 的 配置 属性 ， 可 通过 手动 编辑 该 文件 来 添加 属性 。 做 这 些 工 作 实际 上 就 
是 为 了 得 到 一 份 hibernate.cfg.xml 文件 ， 至 于 这 份 文档 是 IDE 工具 帮 有 我 们 生成 的 ， 还 是 开发 者 自己 通 
过 编辑 工具 编写 的 ， 这 不 重要 。 

如 果 读 者 希望 该 Hibernate 应 用 能 显示 SQL 语句 ， 能 自动 建 表 ， 可 以 为 hibernate.cfg.xml 文件 添加 
hibernate.show_sql 和 hibernate.hbm2ddl.auto 两 个 属性 。 


提示 : 
Fas 事实 上 , 笔者 根本 不 喜欢 这 个 可 视 化 配置 界面 .因为 这 个 可 视 化 配置 界面 非常 不 灵活 ， | 


名 增加 一 个 配置 属性 ， 就 需要 单 击 “Add...” 按 钮 ， 要 增加 映射 文件 ， 也 需要 单 击 “Add.…” | 
| ”按钮 , 远 不 如 笔者 自己 复制 、 粘贴 一 一 这 样 不 仅 没有 提高 开发 效率 ， 反 而 降低 了 开发 效率 。 : 
: ”对 于 初学 者 而 言 ， 可 能 很 喜欢 这 种 可 视 化 编辑 界面 ， 但 随 着 开发 者 对 技术 的 熟悉 ， 应 该 可 | 
| ”以 使 用 任何 的 文本 编辑 器 来 编辑 Hibernate 配置 文件 了 . 因为 笔者 一 直 认为 ,开发 者 可 以 利 : 

用 开发 工具 ， 但 绝 不 能 依赖 于 编辑 工具 .。 | 


全 下 面 可 以 开发 Hibernate 所 需要 的 POJO 文件 了 , 在 Eclipse 中 新 建 一 个 普通 类 文件 的 过 程 ， 相 
信 读 者 已 经 掌握 ， 笔 者 就 不 再 著述 了 。 新 建 一 个 News POJO 持久 化 类 ， 该 类 的 代码 与 前 面 的 News 持 
久 化 类 的 代码 完全 一 样 。 

企 再 次 单 击 主 菜单 中 的 “File” 菜 单 ， 然 后 单 击 “New” 菜 单项 ， 选 择 新 建 Hibernate 映射 文件 。 
即 在 新 建 项 目 或 文件 的 对 话 框 中 选中 “Hibernate” 节 点 的 “Hibernate XML Mapping file(hbm.xml)” 子 
节点 后 ， 单 击 “Next” 按 钮 ，Eclipse 将 出 现 如 图 5.16 所 示 对 话 框 。 


Create WPerate om Wapping mo] 
Ep acnnemn re ooprel 


图 5.16 选择 持久 化 类 


全 在 图 5.16 所 示 的 对 话 框 中 添加 需要 生成 映射 文件 的 类 ， 如 News 类 ， 然 后 单 击 图 5.16 所 示 对 
话 框 中 的 “Finish” 按 钮 ，Eclipse 将 会 为 News 类 生成 一 个 News.hbm.xml 映射 文件 ， 该 映射 文件 与 
Newsjava 位 于 同一 个 目录 下 。 , 

至 此 ，Eclipse 又 帮 我 们 生成 了 PO 类 所 需 的 映射 文件 ， 不 过 系统 总 是 按 某 种 规则 生成 映射 文件 ， 
如 果 读者 觉得 这 份 映射 文件 某 些 地 方 不 太 合适 ， 同 样 可 以 选择 手动 修改 。 

人 @ 返回 Eclipse 的 hibemate.cfg.xml 配置 文件 的 的 编辑 界面 ， 将 刚刚 编辑 生成 的 映射 文件 添加 到 
配置 文件 中 。 然后 在 Eclipse 中 新 建 一 个 主 程序 ， 该 主 程序 的 代码 与 前 面 主 程序 的 代码 完全 相同 ， 此 处 
不 再 著述 。 运 行 该 主 程序 ， 发 现 该 程序 与 前 面 程序 的 运行 结果 完全 一 样 。 
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EE 当 该 程序 运行 结束 后 ， 如果 发 现 底层 数据 库 又 多 了 一 个 数据 表 ， 那 就 是 该 程序 中 News 1 

实体 映射 数据 表 与 前 一 个 程序 映射 的 数据 表 并 不 相同 ， 因 此 又 生成 了 一 个 数据 表 。 如 果 读 

| 。 者 发 现 数据 库 依然 只 有 一 个 news_table 表 ， 而 且 该 表 中 只 有 一 条 数据 记录 ， 这 可 能 是 因为 | 

: hibernate.cfe.xml 文件 中 设置 了 hibernate.hbm2ddl.auto 为 create, 这 表明 Hibernate 总 是 重新 | 

| 创建 数据 表 ， 所 以 原来 数据 表 中 的 记录 将 全 部 丢失 . 如 果 读者 不 希望 Hibernate 保留 原来 的 。 
数据 记录 ， 则 应 该 将 该 属性 设置 为 update- | 


5.3 Hibernate 的 体系 结构 


通过 前 面 的 介绍 ， 我 们 知道 了 一 个 概念 Hibernate Session， 只 有 处 于 Session 管理 下 的 POJO 才 有 
持久 化 操作 的 能 力 。 当 应 用 程序 对 处 于 Session 管理 下 的 POJO 实例 执行 操作 时 ，Hibernate 将 这 种 面 
向 对 象 的 操作 转换 为 持久 化 操作 。 图 5.17 ( 注 : 该 图 来 自 于 Hibernate 官方 参考 文档 ) 显示 了 Hibernate 
简要 的 体系 架构 。 

通过 图 5.17 可 以 看 出 ，Hibernate 需要 一 个 hibemate.properties 文件 ， 该 文件 用 于 配置 Hibernate 和 
数据 库 的 连接 信息 。 还 需要 一 个 XML 映射 文件 ， 该 文件 确定 持久 化 类 和 数据 表 、 数 据 列 之 间 的 对 应 
关系 。 

-大 YE ， es 

在 前 面 的 Hibernate 入 门 中 ， 我 们 都 : 
另 一 种 形式 的 配置 文件 :*.cfg.xml 文件 。 在 实际 应 用 中 ， 采 用 XML 配置 文件 的 方式 更 有 

问 中 释 


有 使 用 hibernate.properties 文件 ， 而 是 采用 了 


- 
i 
| 加 广泛 。 两 种 配置 文件 的 实质 是 一 样 的 ， 只 是 文件 形式 不 同 而 已 。 


正如 从 前 面 所 介绍 的 应 用 中 看 到 的 ， Hibemate 的 持久 化 解决 方案 将 用 户 从 原始 的 JDBC 
放出 来 ， 用 户 无 须 关 注 底层 的 JDBC 操作 ， 而 是 以 面向 对 象 的 方式 进行 持久 层 操作 。 底 层 数据 连接 的 
获得 、 数 据 访问 的 实现 、 事 务 控制 都 无 须 用 户 关心 。 这 是 一 种 “全 面 解决 ”的 体系 结构 方案 ， 将 应 用 
层 从 底层 的 JDBC/JTA API 中 抽象 出 来 。 通 过 配置 文件 管理 底层 的 JDBC 连接 ， 让 Hibernate 解决 持久 
化 访问 的 实现 。 这 种 “全 面 解决 ”方案 的 体系 架构 如 图 5.18 ( 注 : 该 图 来 自 于 Hibernate 官方 参考 文档 ) 
所 示 。 


| 


图 5.17 简要 的 Hibemate 体系 架构 图 5.18 ”Hibemate 全 面 解决 方案 体系 架构 


下 面 就 图 5.18 中 各 对 象 逐 一 进行 解释 。 
> SessionFactory: 这 是 Hibernate 的 关键 对 象 ， 它 是 单个 数据 库 映 射 关系 经 过 编译 后 的 内 存 
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A 


镜像 , 它 也 是 线程 安全 的 。 它 是 生成 Session 的 工厂 , 本 身 需 要 依赖 于 ConnectionProvider。 
该 对 象 可 以 在 进程 或 集群 的 级 别 上 ， 为 那些 事务 之 间 可 以 重用 的 数据 提供 可 选 的 二 级 缓存 。 

> ”Session: 它 是 应 用 程序 与 持久 储存 层 之 间 交 互 操作 的 一 个 单线 程 对 象 。 它 也 是 Hibernate 持 
久 化 操作 的 关键 对 象 ， 所 有 的 持久 化 对 象 必 须 在 Session 管理 下 才 可 以 进行 持久 化 操作 。 此 
对 象 生存 期 很 短 。 它 底层 封装 了 JDBC 连接 ， 它 也 是 Transaction 的 工厂 。Session 对 象 持 
有 一 个 必 选 的 一 级 缓存 ， 显 式 执行 fush 之 前 ， 所 有 持久 化 操作 的 数据 都 在 缓存 中 Session 
对 象 处 。 

> ”持久 化 对 象 : 系统 创建 的 POJO 实例 ， 一 旦 与 特定 的 Session 关联 ， 并 对 应 数据 表 的 指定 记 
录 ， 该 对 象 就 处 于 持久 化 状态 ， 这 一 系列 对 象 都 被 称 为 持久 化 对 象 。 在 程序 中 对 持久 化 对 象 
执行 的 修改 ， 都 将 自动 被 转换 为 持久 层 的 修改 。 持 久 化 对 象 完全 可 以 是 普通 的 
JavaBeans/POJO， 唯 一 特殊 的 是 它们 正 与 一 个 Session 关联 。 

> ”有 瞬 态 对 象 和 脱 管 对 象 ， 系 统 通过 new 关键 字 创 建 的 Java 实例 ， 没 有 与 Session 相关 联 ， 此 
时 处 于 瞬 态 。 瞬 态 实例 可 能 是 在 被 应 用 程序 实例 化 后 ， 尚 未 进行 持久 化 的 对 象 。 如 果 一 个 曾 
经 持久 化 过 的 实例 ， 但 因为 Session 的 关闭 则 转化 为 脱 管状 态 。 

> 事务 (Transaction) : 代表 一 次 原子 操作 ， 它 具有 数据 库 事务 的 概念 。Hibernate 事务 是 对 
底层 具体 的 JDBC、JTA 以 及 CORBA 事务 的 抽象 。 在 某 些 情况 下 ， 一 个 Session 之 内 可 能 
包含 多 个 Transaction 对 象 。 虽 然 事务 操作 是 可 选 的 ， 但 所 有 持久 化 操作 都 应 该 在 事务 管理 
下 进行 ， 即 使 是 只 读 操作 。 

> ”连接 提供 者 ConnectionProvider) : 它 是 生成 JDBC 连接 的 工厂 ， 它 通过 抽象 将 应 用 程序 
与 底层 的 DataSource 或 DriverManager 隔离 开 。 这 个 对 象 无 须 应 用 程序 直接 访问 ， 仅 在 应 

程序 需要 扩展 时 使 用 。 


总 ， 实际 应 用 中 很 少 会 直接 使 用 DriverManager 来 获取 数据 库 连 接 ， 通 常 都 会 使 用 
DataSource 未 获取 数据 库 连 接 ， 因 此 实际 应 用 中 ConnectionProvider 通常 由 DataSource 充 | 
| 。 当 , 由 于 SessionFactory 底层 封装 了 ConnectionProvider, 因此 在 实际 应 用 中 , SessionFactory ， 
底层 封装 了 DataSource. | 


> 事务 工厂 (TransactionFactory ) : 它 是 生成 Transaction 对 象 实例 的 工厂 。 该 对 象 也 无 须 
应 用 程序 直接 访问 。 它 负责 对 底层 具体 的 事务 实现 进行 封装 、 将 底层 具体 的 事务 抽象 成 
Hibernate 事务 。 


5.4 深入 Hibernate 的 配置 文件 


通过 上 面 的 介绍 ， 我 们 知道 Hibernate 进行 持久 化 操作 离 不 开 SessionFactory 对 象 ， 这 个 对 象 是 整 
个 数据 库 映射 关系 经 过 编译 后 的 内 存 镜像 ， 该 对 象 的 openSession 方法 可 打开 Session 对 象 。 该 对 象 通 
常 由 Configuration 对 象 来 产生 。 

每 个 Hibemate 配置 文件 对 应 一 个 Configuration 对 象 。 在 极端 的 情况 下 ， 不 使 用 任何 配置 文件 ， 
也 可 创建 Configuration 对 象 。 


>>5.4.1 创建 Configuration 对 象 


org.hibernate.cfg.Configuration 实例 代表 了 应 用 程序 到 SQL 数据 库 的 映射 配置 ， Configuration 对 
象 提供 了 一 个 buildSessionFactory 方法 ， 该 方法 可 以 产生 一 个 不 可 变 的 SessionFactory 对 象 。 


377 


http://521 a taobao.com 
粮 量 雏 Java EE 企业 应 用 实战 (第 3 版 ) 一 


也 可 以 直接 实例 化 Configuration 来 获取 一 个 实例 ， 并 为 它 指定 Hibernate 映射 定义 文件 。 如 果 映 
射 定义 文件 在 类 加 载 路 径 中 ， 则 可 使 用 addResource0 方 法 来 添加 映射 定义 文件 。 现 在 的 问题 是 ， 如 何 
创建 Configuration 对 象 ? 

随 着 Hibernate 所 使 用 配置 文件 的 不 同 ， 创 建 Configuration 对 象 的 方式 也 不 相同 。 通 常 有 如 下 几 
种 配置 Hibernate 的 方式 : 

> ”使 用 hibernate.properties 文件 作为 配置 文件 。 

> ”使 用 hibernate.cfg.xml 文件 作为 配置 文件 。 

> ”不 使 用 任何 配置 文件 ， 以 编码 方式 创建 Configuration 对 象 。 

Configuration 实例 的 唯一 作用 是 创建 SessionFactory 实例 ， 所 以 它 被 设计 成 启动 期 间 对 象 ， 一 旦 
SessionFactory 创建 完成 ， 它 就 被 丢弃 了 。 

1. 使 用 hibernate.properties 作为 配置 文件 

对 于 使 用 hibernate.properties 作为 配置 文件 的 方式 , 比较 适合 于 初学 者 。 因为 初学 者 往往 很 难 记 住 
Hibernate 配置 文件 的 详细 格式 ， 以 及 具体 需要 哪些 属性 。 在 Hibernate 发 布 包 的 projectvetc 路 径 下 ， 
提供 了 一 个 hibernate.propertis 文件 ， 该 文件 详细 列 出 了 Hibernate 配置 文件 的 所 有 属性 。 每 个 配置 段 
都 给 出 了 大 致 的 注释 , 用 户 只 需 取 消 所 需 配 置 段 的 注释 , 就 可 以 快速 配置 Hibernate 与 数据 库 的 连接 。 
关于 常用 的 连接 属性 ， 将 在 下 一 节 给 出 。 此 处 给 出 使 用 hibernate.properties 文件 创建 Configuration 
的 方法 。 

// 实 例 化 Configuration 

Configuration cfg = new Configuration() 

// 多 次 调用 addResource 方法 ， 添 加 映射 文件 


"addResource ("Item.hbm.xml") 
-addResource ("Bid.hbm. xm1"); 


查看 hibernate.properties 配置 文件 发 现 ， 该 文件 没有 提供 添加 Hibernate 映射 文件 的 方式 。 因 此 使 
用 hibernate.properties 作为 配置 文件 时 ， 必 须 调 用 Configuration 对 象 的 addResource 方法 ， 使 用 该 方法 
添加 映射 文件 。 


| 正如 上 面 代码 中 见 到 的 ,使 用 hibernate.properties is 文件 配置 Hibermate 属性 虽然 简单 
| 但 因为 需要 在 代码 中 手动 添加 映射 文件 一 一 这 是 非常 仿 人 肖 责 的 事情 ， 如 果 只 有 两 个 映 
射 文件 ， 当 然 问题 不 大 ,但 如 果 有 100 个 映射 文件 ?或 者 更 多 ? 那 将 是 非常 无 趣 的 工作 。 
笔者 宁愿 在 配置 文件 中 添加 映射 文件 ， 也 不 愿意 在 代码 中 手动 添加 。 这 就 是 实际 开发 中 可 


不 使 用 hibernate.properties 文件 作为 配置 文件 的 原因 . 


有 男 一 种 添加 映射 文件 的 策略 ， 因 为 映射 文件 和 持久 化 类 往往 是 一 一 对 应 的 ， 可 以 通过 
向 Configuration 对 象 添 加 持久 化 类 ， 让 Hibernate 自己 搜索 映射 文件 。 代 码 片段 如 下 : 
// 实 例 化 Configuration 
Configuration cfg = new Configuration() 
// 多 次 调用 addclass 方法 ， 直 接 添加 持久 化 类 


-addclass (lee.Item.class) 
-addclass (lee.Bid.class); 


在 这 种 方式 下 ， 所 有 的 映射 文件 应 该 放 在 持久 化 类 文件 相同 的 包 路 径 下 ; 否则 ， 
Hibernate 将 不 能 正确 搜索 到 对 应 的 映射 文件 . 采用 这 种 方式 的 优点 是 : 消除 了 系统 对 文 四 
件 名 的 硬 编码 克 合 。 Ed 
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ED 


2. 使 用 hibernate.cfg.xml 作为 配置 文件 

前 面 已 经 看 到 ， 对 于 使 用 hibernate.cfg.xml 配置 文件 的 情形 。 因 为 hibernate.cfg.xml 文件 中 已 经 添 
加 了 Hibernate 映射 文件 ， 因 此 无 须 通 过 编程 方式 添加 映射 文件 。 采 用 这 种 配置 文件 创建 Configuration 
实例 可 通过 如 下 代码 实现 : 

// 实 例 化 Configuration 

Configuration cfg = new Configuration() 


//configure () 方 法 将 会 负责 加 载 hibernate.cfg.xml 文件 
.configure(); 


要 
-关注 意 :站 
通过 new 关键 字 创 建 Configuration 对 象 之 后 ， 不 要 ， 


3. 不 使 用 配置 文件 创建 Configuration 实例 
这 是 一 种 极端 的 情况 ， 通 常 不 会 通过 这 种 方式 创建 Configuration 实例 。Configuration 对 象 提供 了 
如 下 三 个 方法 。 
> Configuration addResource(String resourceName): 用 于 为 Configuration 对 象 添 加 一 个 映 
射 文件 。 
> “Configuration setProperties(Properties properties): 用 于 为 Configuration 对 象 设 着 一 系列 属 
性 ， 这 系列 属性 通过 Properties 实例 传 入 。 
> Configuration setProperty(String propertyName, String value): 用 于 为 Configuration 对 象 
设置 一 个 单独 的 属性 。 
正 是 通过 如 上 三 个 方法 , 可 以 无 须 任何 配置 文件 支持 , 直接 通过 编程 方式 创建 Configuration 实例 。 
具体 的 代码 片段 如 下 。 
程序 清单 ，codes\05\5.4\noConfig\src\lee\NewsManagerjava 
public class NewsManager 


{ 
public static void main(String[] args) throws Exception 


{ 
// 实 例 化 Configuration， 不 加 载 任何 配置 文件 
Configuration conf = new Configuration() 
// 通 过 addclass 方法 添加 持久 化 类 
-addclass (org. crazyit. app. domain.News.class) 
// 通 过 setProperty 设置 Hibernate 的 连接 属性 。 
.setProperty ("hibernate. connection.dri' 


.setProperty ("hibernate. connection.username" , "root") 


-setProperty ("hibernate.c3p0.idle_test_period"” , "3000") 
.setproperty ("hibernate.c3p0.acquire_increment” , "2") 
-setProperty ("hibernate.c3p0.validate" , "true") 
.setProperty ("hibernate.dialect" , "org.hibernate.dialect. 
MySQLInnoDBDialect") 
-setProperty ("hibernate.hbm2ddl auto , "create"); 

// 以 configuration 创建 SessionFactory 

SessionFactory sf = conf.buildSessionFactory(); 

// 实 例 化 Session 

Session sess = sf.openSsession(); 

// 开 始 事 务 


Transaction tx = sess.beginTransaction(); 
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// 创 建 消息 实例 
News n = new News(); 
// 设 置 消息 标题 和 消息 内 容 
n.setTitle ("疯狂 Java 联盟 成 立 了 "); 
n.setContent (" 瘦 狂 Java 联盟 成 立 了 ，" 
+ "网 站 地 址 http://www.crazyit.org"); 
// 保 存 消息 
sess.save (n); 
// 提 交 事务 
tx,commit () 7 
// 关 闭 session 
sess.close(); 
} 
上 


从 上 面 的 代码 片段 中 可 以 看 出 ， 使 用 这 种 代码 方式 来 创建 Configuration 实例 是 一 件 极度 烦琐 的 事 

情 。 因 为 需要 将 Hibemate 所 有 的 配置 属性 都 通过 代码 设置 ， 并 需要 在 代码 中 手动 加 载 所 有 映射 文件 。 
对 于 一 个 大 项 目 ， 创 建 一 个 Configuration 实例 可 能 需要 一 大 段 代码 。 这 种 方式 既 不 利于 编程 实现 ， 也 
不 利于 后 期 代码 维护 ， 因 此 实际 开发 中 不 推荐 使 用 这 种 策略 
人 2 提示 

CC) 和 实际 上 ， 在 代码 中 设置 Hibemate 配置 属性 也 并 非 完全 没有 用 处 . 这 种 策略 可 与 前 面 两 : 
种 策略 结合 ， 将 部 分 关键 配置 属性 放 在 代码 中 添加 。 | 


和 >5.4.2 ”hibernate.properties 文件 与 hibernate.cfg.xml 文件 


如 果 使 用 ete 路 径 下 的 hibernate.properties 文件 作为 配置 文件 的 模板 ， 修 改 此 模板 文件 作为 
Hibernate 配置 文件 ， 这 种 方式 的 确 是 快速 进入 Hibernate 开发 的 方法 。 但 对 于 实际 项 目的 开发 ， 通 常 
都 会 使 用 hibernate.cfg.xml 文件 作为 配置 文件 。 

深入 对 比 hibernate.properties 文件 和 hibernate.cfg.xml 文件 后 ,看 如 下 hibernate.properties 文件 的 一 
个 配置 属性 : 


// 指 定数 据 库 的 方言 
hibernate.dialect org.hibernate.dialect .MysQLDialect 


上 面 一 行 代码 是 典型 的 Properties 文件 的 格式 ， 前 面 的 key 为 hibernate.dialect， 后 面 的 value 为 
org.hibernate.dialect.MySQLDialect。 它 指定 Hibernate 的 dialect 属性 值 为 org.hibernate.dialect.MySQL 
Dialect。 再 查看 hibernate.cfg.xml 文件 中 的 对 应 配置 : 

<property name="dialect">org.hibernate.dialect .MySQLINnoDBDialect</property> 

同样 指定 了 Hibernate 的 dialect 属性 值 为 org.hibemate.dialect.MySQLDialect。 对 比 两 种 配置 文件 ， 
发 现 两 个 文件 虽然 格式 不 同 ， 但 其 实质 完全 一 样 。 

下 面 分 类 介绍 Hibernate 配置 文件 中 常用 属性 的 意义 。 


>>》5.4.3 JDBC 连接 属性 


Hibernate 需要 进行 数据 库 访 问 ， 因 此 必须 设置 连接 数据 库 的 相关 属性 。 所 有 Hibernate 属性 的 名 
字 和 语义 都 在 org.hibernate.cfg.Environment 中 定义 。 

下 面 是 关于 JDBC 连接 配置 中 最 重要 的 设置 。 

> hibernate.connection.driver_class: 设置 连接 数据 库 的 驱动 。 

> hibernate.connection.url， 设置 所 需 连接 数据 库 服 务 的 URL。 

> hibernate.connection.usermame: 连接 数据 库 的 用 户 名 。 

> hibernate.connection.password: 连接 数据 库 的 密码 。 
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> hibernate.connection.pool_size: 设置 Hibernate 数据 库 连 接 池 的 最 大 并 发 连接 数 。 

> hibernate.dialect: 设置 连接 数据 库 所 使 用 的 方言 。 

如 果 在 hibernate.cfg.xml 或 hibernate.properties 文件 中 设置 如 上 属性 ，Hibernate 将 可 以 处 理 底层 数 
据 库 连接 细节 。 

上 面 配置 了 Hibernate 数据 库 连接 池 的 最 大 并 发 连接 数 , 但 Hibernate 自 带 的 连接 池 仅 有 测试 价值 
并 不 推荐 在 实际 项 目 中 使 用 。 实际 项 目 中 可 以 使 用 C3P0 或 Proxool 连接 池 , 为 了 使 用 C3P0 或 Proxool 
连接 池 ， 只 需要 用 这 些 连 接 池 配置 代替 hibernate.connection.pool_size 配置 属性 即 可 。 

下 面 是 配置 C3P0 连接 池 的 配置 片段 。 


<!-- 设置 连接 数据 库 的 驱动 。 一 > 
<property name="connection.driver_class"Scom.mysql. jdbc.Driver</property> 


<!-- 设 置 所 需 连 接 数据 库 服务 的 URL。--> 

<property name="connection.url">jdbe:mysql://localhost/hibernate</property> 
<! -连接 数据 库 的 用 户 名 。--> 

<property name="connection.username">root</property> 

<!-- 设置 连接 数据 库 的 驱动 。--> 

<property name="connection.password">32147</property> 


<!-- C3P0 连接 池 的 最 大 连接 数 --> 
perty name="hibernate.c3p0.max_size">20</property> 
<!-- C3P0 连接 池 的 最 小 连接 数 -> 
<property name="hibernate.c3p0.min_size">1</property> 


<!-- C3P0 连接 池 中 连接 的 超时 时 长 -> 
<property name="hibernate.c3p0.timeout">1800</property> 


<!-~ C3P0 缓存 Statement 的 数量 --> 
<property name="hibernate.c3p0.max_statements">50</property> 


》>>5.4.4 数据 库 方言 


Hibernate 底层 依然 使 用 SQL 语句 来 执行 数据 库 操作 ,虽然 所 有 关系 型 数据 库 都 支持 使 用 标准 SQL 
语句 , 但 所 有 数据 库 都 对 标准 SQL 进行 了 一 些 扩展 , 所 以 在 语法 细节 上 存在 一 些 差异 ,因此 Hibernate 

举例 来 说 ， 我 们 在 MySQL 数据 库 里 进行 分 页 查询 ， 只 需 使 用 limit 关键 字 就 可 以 了 ; 而 标准 SQL 
并 不 支持 limit 关键 字 ， 例 如 Oracle 则 需要 使 用 行内 视图 的 方式 来 进行 分 页 。 同 样 的 应 用 程序 ， 当 我 
们 在 不 同 数据 库 之 间 迁 移 时 ,底层 数据 库 的 访问 细节 会 发 生 改变 , 而 Hibernate 也 为 这 种 改变 做 好 了 准 
备 ,现在 我 们 需要 做 的 是 : 告诉 Hibernate 应 用 程序 的 底层 即将 使 用 哪 种 数据 库 一 一 这 就 是 数据 库 方言 。 

一 旦 我 们 为 Hibernate 设置 了 合适 的 数据 库 方言 ，Hibermate 将 可 以 自动 应 付 底层 数据 库 访 问 所 存 
在 的 细节 差异 。 

不 同 数据 库 所 应 使 用 的 方言 如 表 5.1 所 示 。 

表 5.1 不 同 数据 库 及 其 对 应 方言 


关系 数据 库 方言 
DB2 org hiberate dialect DB2Dialect 
DB2 AS/400 org hibemate dialect DB2400Dialect 
DB2 0S390 org.hibemate dialect DB2390Dialect 
PostgreSQL org-hibemate.dialect PostgreSQL Dialect 
MySQL org hibemate dialect MySQLDialect 
MySQL with InnoDB org hibemate dialecLMySQLInnoDBDialect 


MySQL with MyISAM 


omghibemate dialect MySQLMyISAMDialect 


Oracle (any version) org hibemate dialect. OracleDialect 
Oracle 9i org hibemate.dialect. Oracle9iDialect 
Oracle 10g org hibemate.dialect. Oracle1 OgDialect 
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续 表 
关系 数据 库 言 
Sybase org hibemate.dialect SybaseDialect 
Sybase Anywhere org hibernate dialect SybaseAnywhereDialect 
Microsoft SQL Server org hiberate dialect SQLServerDialect 
SAP DB org hibemate dialect SAPDBDialect 
Informix org hibemnate dialect InformixDialect 
HypersonicSQL org hibernate.dialect HSQLDialect 
Ingres org hibemate dialect IngresDialect 
Progress org hibemate dialect ProgressDialect 
Mckoi SQL org hibemate.dialect MekoiDialect 
Interbase org hibemate dialect InterbaseDialect 
Pointbase org hibemate dialect PointbascDialect 
FrontBase org hibernate dialect FrontbaseDialect 
Firebird org hibemate dialect FirebirdDialect 


》》5.4.5 JNDI 数据 源 的 连接 属性 


如 果 无 须 Hibernate 自己 管理 数据 源 , 而 是 直接 访问 容器 管理 数据 源 , Hibernate 可 使 用 JNDI (Java 
Naming Directory Interface，Java 命名 目录 接口 ) 数据 源 的 相关 配置 。 下 面 是 连接 JNDI 数据 源 的 主要 
配置 属性 。 
> hibernate.connection.datasource: 指定 数据 源 JNDI 名 字 。 
> _ hibernate.jndi.url， 指定 JNDI 提供 者 的 URL， 该 属性 是 可 选 的 。 如 果 JNDI 与 Hibernate 持 
久 化 访问 的 代码 处 于 同一 个 应 用 中 ， 则 无 须 指定 该 属性 。 

> hibernate.jndi.class: 指定 JNDI InitialContextFactory 的 实现 类 ， 该 属性 也 是 可 选 的 。 如 果 
JNDI 与 Hibernate 持久 化 访问 的 代码 处 于 同一 个 应 用 中 ， 则 无 须 指定 该 属性 。 

> hibernate.connection.username: 指定 连接 数据 库 的 用 户 名 ， 该 属性 是 可 选 的 。 

> hibernate.connection.password: 指定 连接 数据 库 的 密码 ， 该 属性 是 可 选 的 。 


po ee 
即使 使 用 JNDI 数据 源 ， 一 样 需要 指定 连接 数据 库 的 方言 。 虽 然 设置 数据 库 方言 并 
: 需 的 ， 但 对 于 优化 持久 


by 


下 面 是 配置 Hibernate 连接 Tomcat 中 数据 源 的 配置 片段 。 


<!-- 配置 JNDI 数据 源 的 JNDI 名 --> 

<property name="connection.datasource">java:comp/env/jdbc/dstest</property> 
<!-- 配置 连接 数据 库 的 方言 --> 

<property name="dialect">org.hibernate.dialect.MySQLDialect</property> 


如 果 数 据 源 所 在 容器 支持 跨 事 务 资源 的 全 局 事务 管理 ， 从 JNDI 数据 源 获得 的 JDBC 连接 ， 可 自 
动 参与 容器 管理 的 全 局 事务 ， 而 不 仅仅 是 Hibernate 的 局 部 事务 。 


> >5.4.6 ” Hibernate 事务 属性 


事务 也 是 Hibernate 持久 层 访问 的 重要 方面 ，Hibernate 不 仅 提供 了 局 部 事务 支持 ， 也 允许 使 用 容 
器 管理 的 全 局 事务 。Hibernate 关于 事务 管理 的 属性 有 如 下 几 个 。 
> _ hibernate.transaction.factory_class: 指定 Hibernate 所 用 的 事务 工厂 的 类 型 ， 该 属性 值 必须 
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是 TransactionFactory 的 直接 或 间接 子 类 。 

> jta.UserTransaction: 该 属性 值 是 一 个 JNDI 名 ，Hibernate 将 使 用 JTATransactionFactory 
从 应 用 服务 器 获取 JTA UserTransaction。 

> hibernate transaction.manager lookup_class: 该 属性 值 应 为 一 个 TransactionManagerLookup 
类 名 ， 当 使 用 JVM 级 别 的 缓存 时 ， 或 在 JTA 环境 中 使 用 hilo 生成 器 策略 时 ， 需 要 该 类 。 

> _ hibernate.transaction.flush_before_completion: 指定 Session 是 否 在 事务 完成 后 自动 将 数 
据 刷新 (flush ) 到 底层 数据 库 。 该 属性 值 只 能 为 true 或 false.。 现在 更 好 的 方法 是 使 用 Context 
相关 的 Session 管理 。 

> hibernate.transaction.auto_close_session: 指定 是 否 在 事务 结束 后 自动 关闭 Session。 该 属 
性 值 只 能 是 true 或 false。 现 在 更 好 的 方法 是 使 用 Context 相关 的 Session 管理 。 


>》》5.4.7 二 级 缓存 相关 属性 


Hibernate 的 SessionFactory 可 持 有 一 个 可 选 的 二 级 缓存 ,通过 使 用 这 种 二 级 缓存 可 以 提高 Hibernate 
的 持久 化 访问 的 性 能 。Hibernate 关于 二 级 缓存 的 属性 有 如 下 几 个 。 

> hibernate.cache.provider_class:， 该 属性 用 于 设置 二 级 缓存 CacheProvider 的 类 名 。 

> hibernate.cache.use_minimal_puts: 以 频繁 的 读 操作 为 代价 , 优化 二 级 缓存 以 实现 最 小 化 写 
操作 。 在 Hibernate 3 中 ， 这 个 设置 对 集群 缓存 非常 有 用 ， 对 集群 缓存 的 实现 而 言 ， 默 认 是 
开启 的 。 

> hibernate.cache.use_query_cache: 设置 是 否 允 许 查询 缓存 。 个别 查 询 仍然 需要 显 式 设置 为 
可 缓存 的 。 

> hibernate.cache.use_second _ level_cache: 用 于 设置 是 否 启用 二 级 缓存 ， 该 属性 可 完全 禁 
止 使 用 二 级 缓存 。 对 那些 在 映射 文件 中 指定 了 <cache.…./> 的 持久 化 类 , 则 默认 开启 二 级 缓存 。 

> hibernate.cache.query_cache_factory: 设置 查询 缓存 工厂 的 类 名 ， 查 询 缓存 工厂 必须 实现 
QueryCache 接口 。 该 属性 值 默认 为 内 建 的 StandardQueryCache 。 

> hibernate.cache.region_prefix: 设置 二 级 缓存 区 名 称 的 前 缀 。 

> _ hibernate.cache.use_structured_entries: 用 于 设置 是 否 强制 Hibernate 以 可 读 性 更 好 的 格式 
i -级 缓存 


和 5.4.8 外 连接 抓 取 属 性 


外 连接 抓 取 能 限制 执行 SQL 语句 的 次 数 来 提高 效率 ， 这 种 外 连接 抓 取 通 过 在 单个 select 语句 中 使 
用 outer join 来 一 次 抓 取 多 个 数据 表 的 数据 。 

外 连接 抓 取 人 允许 在 单个 select 语句 中 , 通过 <many-to-one.../>、<one-to-many.../>、<many-to-many.../> 
和 <one-to-one.… 信 等 关联 获取 连接 对 象 的 整个 对 象 图 。 

将 hibernate.max_fetch_depth 设 为 0， 将 在 全 局 范围 内 禁止 外 连接 抓 取 ， 设 为 1 或 更 高 值 能 启用 N 
一 1 或 1 一 1 的 外 连接 抓 取 。 除 此 之 外 ， 还 应 该 在 映射 文件 中 通过 fetch="join" 来 指定 这 种 外 连接 抓 取 。 


>>5.4.9 其 他 常用 的 配置 属性 


除了 上 面 介绍 的 必要 配置 属性 之 外 ，Hibernate 常用 的 配置 属性 还 有 如 下 几 个 。 
> _ hibernate.show_sql: 是 否 在 控制 台 输 出 Hibernate 生成 的 SQL 语句 。 只 能 为 true 和 false 
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两 个 值 。 

> hibernate. format_sql: 是 否 将 SQL 语句 转 成 格式 良好 的 SQL. 只 接受 true 和 false 两 个 值 。 

> _ hibernate.use_sql_comments: 是 否 在 Hibernate 生成 的 SQL 语句 中 添加 有 助 于 调试 的 注释 。 
只 接受 true 和 false 两 个 值 。 

> hibernate.jdbc.fetch_size: 指定 JDBC 抓 取 数 量 的 大 小 ， 它 可 接受 一 个 整数 值 ， 其 实质 是 调 
用 Statement.setFetchSize() 方 法 。 

> hibernate.jdbc.batch_size: 指定 Hibernate 使 用 JDBC2 的 批量 更 新 的 大 小 ， 它 可 接受 一 个 
整数 值 ， 建 议 取 5 到 30 之 间 的 值 。 

> hibernate.connection.autocommit: 设置 是 否 自动 提交 。 通 常 不 建议 打开 自动 提交 。 

> hibernate.hbm2ddl.auto: 设置 当 创 建 SessionFactory 时 ， 是 否 根据 映射 文件 自动 建立 数据 
库 表 。 如 果 使 用 create-drop 值 ， 显 示 关 闭 SessionFactory 时 ， 将 Drop 刚 建 的 数据 表 。 该 
属性 可 以 为 update、create 和 create-drop 三 个 值 。 

当然 ，Hibernate 配置 文件 中 的 配置 属性 还 有 很 多 ， 因 为 篇 幅 关 系 ， 此 处 不 再 一 一 列举 。 如 果 读 者 

需要 关于 这 些 配置 属性 的 详细 介绍 ， 请 参考 Hibernate 的 官方 参考 文档 。 


5.5 ”深入 理解 持久 化 对 象 


Hibernate 是 一 个 彻底 的 O/R Mapping 框架 ， 通 过 Hibernate 的 支持 ， 程 序 开发 者 只 需要 管理 对 象 
的 状态 , 无 须 理会 底层 数据 库 系统 的 细节 。 相对 于 常见 的 JDBC 持久 层 方案 中 需要 手工 管理 SQL 语句， 
Hibernate 采用 完全 面向 对 象 的 方式 来 操作 数据 库 。 对 于 程序 开发 者 而 言 ， 眼 里 只 有 对 象 、 属 性 ， 不 应 
该 再 有 数据 表 、 数 据 列 等 概念 。 
在- 当 开发 者 需要 深入 了 解 Hibernate 底层 运行 时 ， 对 Hibernate 的 数据 访问 进行 优化 时 ， 
和 访 需 要 了 解 Hibermate 的 底层 SQL 操作 了 。 而 对 于 绝 大 部 分 应 用 来 说 ， 数 据 访 问 是 一 个 巨 | 
| “大 的 、 耗 时 的 操作 ， 因 此 深入 掌握 Hibernate 底层 对 应 的 SQL 操作 非常 必要 。 J 


>》》>5.5.1 持久 化 类 的 要 求 


Hibernate 采用 低 侵入 式 设计 ， 这 种 设计 对 持久 化 类 几乎 不 作 任何 要 求 。 也 就 是 说 ，Hibernate 操作 
的 持久 化 类 基本 上 都 是 普通 、 传 统 的 Java 对 象 (POJO)。 对 于 这 种 Java 类 ， 程 序 开 发 中 可 以 采用 更 灵 
活 的 领域 建 模 方式 。 
虽然 Hibemate 对 持久 化 类 没有 太 多 的 要 求 ， 但 我 们 还 是 应 该 遵守 如 下 规则 。 
> ”提供 一 个 无 参数 的 构造 器 : 所 有 的 持久 化 类 都 应 该 提供 一 个 无 参数 的 构造 器 ， 这 个 构造 器 可 
以 不 采用 public 访问 控制 符 。 因 此 提供 了 无 参数 的 构造 器 ，Hibernate 就 可 以 使 用 
Constructor.newlnstance() 来 创建 持久 化 类 的 实例 了 。 通 常 ， 为 了 方便 Hibernate 在 运行 时 
生成 代理 ， 构 造 器 的 访问 控制 修饰 符 至 少 是 包 可 见 的 ， 即 大 于 或 等 于 默认 的 访问 控制 符 。 
> ”提供 一 个 标识 属性 :标识 属性 通常 映射 数据 库 表 的 主键 字段 。 这 个 属性 可 以 叫 任何 名 字 ， 其 
类 型 可 以 是 任何 的 基本 类 型 、 基 本 类 型 的 包装 类 型 、java.lang.String 或 者 java.util.Date。 如 
果 使 用 了 数据 库 表 的 联合 主键 , 甚至 可 以 用 一 个 用 户 自 定义 的 类 , 该 类 拥有 这 些 类 型 的 属性 。 
当然 ， 也 可 以 不 指定 任何 标识 属性 ， 而 是 在 映射 文件 中 直接 将 多 个 普通 属性 映射 成 一 个 联合 
主键 ， 但 通常 不 推荐 这 么 做 。 
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二 


提示 : ' 
虽然 Hibernate 允许 使 用 8 个 基本 类 型 作为 标识 属性 的 类 型 , 但 使 用 基本 类 型 作为 标识 。 
属性 的 类 型 在 很 多 地 方 都 不 太 方便 ， 因 此 还 是 建议 使 用 基本 类 型 的 包装 类 型 作为 标识 属性 | 


> 虽然 Hibernate 可 以 允许 持久 化 类 没有 标识 符 属性 ， 而 是 让 Hibernate 内 部 来 追踪 对 象 的 识 
别 。 但 这 样 做 将 导致 Hibernate 许多 功能 无 法 使 用 。 而 且 ，Hibernate 建议 使 用 可 以 为 空 的 类 
型 来 作为 标识 属性 的 类 型 ， 因 此 应 该 尽量 避免 使 用 基本 数据 类 型 。 

> ”为 持久 化 类 的 每 个 属性 提供 setter 和 getter 方法 : Hibernate 默认 采用 属性 方式 来 访问 持久 
化 类 的 属性 。 如 果 持 久 化 类 有 个 foo 属性 ， 则 应 该 提供 setFoo() 和 getFoo 方法 。Hibernate 
持久 化 JavaBeans 风格 的 属性 ， 认 可 如 下 形式 的 方法 名 : getFoo、isFoo 和 setFoo。 如 果 
需要 ， 也 可 以 切换 属性 的 访问 策略 。 

> ”使 用 非 final 的 类 : 在 运行 时 生成 代理 是 Hibernate 的 一 个 重要 的 功能 。 如 果 持 久 化 类 没有 实 
现任 何 接口 的 话 ，Hibernate 使 用 CGLIB 生成 代理 ， 该 代理 对 象 是 持久 化 类 子 类 的 实例 。 如 
果 使 用 了 final 类 ， 则 无 法 生成 CGLIB 代理 ， 将 无 法 进行 性 能 优化 。 还 有 一 个 可 选 的 策略 ， 
让 Hibernate 持久 化 类 实现 一 个 所 有 方法 都 声明 为 public 的 接口 , 此 时 将 使 用 JDK 的 动态 代 
理 。 同 时 应 该 避免 在 非 final 类 中 声明 public final 的 方法 。 如 果 非 要 使 用 一 个 有 public final 
方法 的 类 ， 你 必须 通过 设置 lazy="false” 来 明确 地 禁用 代理 。 

> 重 写 equals() 和 hashCode() 方 法 : 如 果 需 要 把 持久 化 类 的 实例 放 入 Set 中 ( 当 需 要 进行 关联 
映射 时 ， 推 荐 这 么 做 ) ， 则 应 该 为 该 持久 化 类 重 写 equals() 和 hashCode() 方 法 。 实 现 
equals()/hashCode() 最 显而易见 的 方法 是 比较 两 个 对 象 标识 符 的 值 。 如 果 值 相同 ， 则 两 个 对 
象 对 应 于 数据 库 的 同一 行 ， 因 此 它们 是 相等 的 (如 果 都 被 添加 到 Set， 则 在 Set 中 只 有 一 个 
元 素 ) 。 遗 憾 的 是 ， 对 采用 自动 生成 标识 值 的 对 象 不 能 使 用 这 种 方法 。Hibernate 仅 为 那些 
持久 化 对 象 指定 标识 值 ， 一 个 新 创建 的 实例 将 不 会 有 任何 标识 值 。 因 此 ， 如 果 一 个 实例 没有 
被 保存 过 , 但 它 又 确实 在 一 个 Set 中 , 保存 它 将 会 给 这 个 对 象 赋 一 个 标识 值 ,如 果 equals() 和 
hashCode() 是 基于 标识 值 实现 的 , 则 其 hashCode 返回 值 会 发 生 改 变 , 这 将 违反 Set 的 规则 。 

村 Ey 3 和 ~ 
这 并 不 是 一 个 Hibernate 问题 ， 而 是 一 般 的 Java 对 象 标识 和 相等 的 语义 问题 。 通 常 

建议 使 用 业务 键 值 相等 来 实现 equals() 和 hashCode0。 业务 键 值 相 等 的 意思 是 ，equals() 

方法 仅仅 比较 去 辑 字段 的 属性 值 ， 而 这 个 (或 者 多 个 ) 还 辑 字 役 的 属性 值 可 以 唯一 地 标 ey 

实例 。 


不 仅 如 此 ， 当 我 们 想 要 重用 脱 管 实例 时 ， 该 实例 所 属 的 持久 化 类 也 应 该 重 写 equals0 和 hashCode() 
方法 。 

持久 化 类 可 以 拥有 子 类 ， 持 久 化 类 的 子 类 可 以 从 父 类 继承 标识 属性 。 关 于 持久 化 类 的 继承 映射 请 
参阅 6.1 节 的 介绍 。 


>>5.5.2 持久 化 对 象 的 状态 


Hibernate 持久 化 对 象 支持 如 下 几 个 对 象 状 态 。 
> ”有 瞬 态 : 对 象 由 new 操作 符 创建 , 且 尚 未 与 Hibernate Session 关联 的 对 象 被 认为 处 于 瞬 态 。 
瞬 态 对 象 不 会 被 持久 化 到 数据 库 中 ， 也 不 会 被 赋予 持久 化 标识 。 如 果 程 序 中 失去 了 瞬 态 对 
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象 的 引用 , 瞬 态 对 象 将 被 垃圾 回收 机 制 销毁 。 使 用 Hibernate Session 可 以 将 其 变 为 持久 化 
状态 。 
> ”持久 化 : 持久 化 实例 在 数据 库 中 有 对 应 的 记录 ， 并 拥有 一 个 持久 化 标识 (identifier)。 持 久 化 的 
实例 可 以 是 刚刚 保存 的 ， 也 可 以 是 刚 被 加 载 的 。 无 论 哪 一 种 ， 持 久 化 对 象 都 必须 与 指定 的 
Hibernate Session 关联 。Hibernate 会 检测 到 处 于 持久 化 状态 对 象 的 改动 ， 在 当前 操作 执行 
完成 时 将 对 象 数据 写 回 数据 库 。 开 发 者 不 需要 手动 执行 UPDATE。 
> ” 脱 管 ， 某 个 实例 曾经 处 于 持久 化 状态 ， 但 随 着 与 
一 一 和 之 关联 的 Session 被 关闭 ， 该 对 象 就 变 成 脱 管状 
io a 态 。 脱 管 对 象 的 引用 依然 有 效 ， 对 象 可 继续 被 修 
| oo] | 改 。 如 果 重 新 让 脱 管 对 象 与 某 个 Session 关联 ， 
WAR | 这 个 脱 管 对 象 会 重新 转换 为 持久 化 状态 ， 而 脱 管 
1 期 间 的 改动 也 不 会 丢失 ， 也 可 被 写 入 数据 库 。 正 
oe veoruparel 是 因为 这 个 功能 ， 逻 辑 上 的 长 事务 成 为 可 能 ， 它 
1 被 称 为 应 用 程序 事务 。 即 事务 可 以 跨越 用 户 的 思 
nnn ~ 考 ， 因 为 当 对 象 处 于 脱 管状 态 时 ， 对 该 对 象 的 操 
a 作 无 须 锁定 数据 库 ， 不 会 造成 性 能 的 下 降 。 
图 5.19 显示 了 Hibemate 持久 化 实例 的 状态 演化 图 。 
接 下 来 讨论 使 持久 化 对 象 的 状态 发 生 改 变 的 方法 。 


》>》》5.5.3 改变 持久 化 对 象 状态 的 方法 


根据 前 面 介绍 的 内 容 ， 我 们 知道 通过 new 新 建 一 个 持久 化 实例 时 ， 该 实例 处 于 瞬 态 ， 为 了 让 有 瞬 态 
对 象 转换 为 持久 化 状态 ，Hibernate Session 提供 了 如 下 几 个 方法 。 

> ”Serializable save(Object obj): 将 obj 对 象 变 为 持久 化 状态 ， 该 对 象 的 属性 将 被 保存 到 数据 库 。 

> void persist(Object obj): 将 obj 对 象 转化 为 持久 化 状态 ， 该 对 象 的 属性 将 被 保存 到 数据 库 。 

> ”Serializable save(Object obj , Object pk): 将 obj 对 象 保存 到 数据 库 ， 保 存 到 数据 库 时 ， 指 
定 主键 值 。 

> void persist(Object obj, Object pk): 将 obj 对 象 转化 为 持久 化 状态 ， 保 存 到 数据 库 时 ， 指 定 
主键 值 。 

因此 ， 为 了 将 一 个 处 于 瞬 态 状态 的 对 象 变 成 持久 化 状态 ， 可 以 看 如 下 代码 片段 : 

// 创 建 消息 实例 


News n = new News(); 

// 设 置 消息 标题 和 消息 内 容 

n.setTitle ("疯狂 Java 联盟 成 立 了 "); 

n.setContent ("疯狂 Java 联盟 成 立 了 ，" 

+ "网 站 地 址 http://www.crazyit .org"); 

// 保 存 消息 

sess. save(n) ; 

除 此 之 外 ， 也 可 通过 persist 和 另 一 个 重 载 的 save 方法 来 将 瞬 态 实例 转化 为 持久 化 状态 。 

当 我 们 把 一 个 瞬 态 实体 变 成 持久 化 状态 时 ，Hibernate 会 在 底层 对 应 地 生成 一 条 insert 语句 ， 这 条 
语句 负责 把 该 实体 对 应 的 数据 记录 插入 数据 表 。 

如 果 News 的 标识 属性 (identifier) 是 generated 〈 也 就 是 说 ， 指 定 了 主键 生成 器 ) 类 型 的 ， 那 么 
Hibernate 将 会 在 执行 save0 方 法 时 自动 生成 标识 属性 值 ， 并 将 该 标识 属性 值 分 配给 该 News 对 象 ， 并 
且 标 识 属性 (identifier) 会 在 save0 被 调用 时 自动 产生 并 分 配给 News 对 象 。 如 果 News 的 标识 属性 是 
assigned 类 型 的 , 或 者 是 复合 主键 (composite key)， 那么 该 标识 属性 值 应 当 在 调用 save0 之 前 手动 赋予 
给 News 对 象 。 


图 5.19 Hibernate 持久 化 实例 的 状态 演化 图 
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i 之 所 以 提供 与 save0) 功 能 几乎 完全 类 似 的 persist0 方 法 ， 一 方面 是 为 了 照顾 | 

中。 JPA 的 用 法 习惯 . 另 一 方面 ，save0 和 persist0 方 法 还 有 一 个 区 别 : 使 用 save() 方 法 保存 持久 : 
| 。 化 对 象 时 ,该 方法 返回 该 持久 化 对 象 的 标识 属性 值 ( 即 对 应 记录 的 主键 值 )} 但 使 用 persistO | 
: 方法 来 保存 持久 化 对 象 时 ， 该 方法 没有 任何 返回 值 。 因 为 save0 方 法 需要 立即 返回 持久 化 ， 
| 。 对 象 的 标识 属性 值 ， 所 以 程序 执行 save0 方 法 会 立即 将 持久 化 对 象 对 应 的 数据 插入 数据 库 ; ! 
;而 persist0 则 保证 当 它 在 一 个 事务 外 部 被 调用 时 ， 并 不 立即 转换 成 insert 语句 ， 这 个 功能 是 | 
| 。 很 有 用 的 ， 万 其 当 我 们 封装 一 个 长 会 话 流程 的 时 候 ，persist 方 法 就 显得 万 为 重要 了 。 


也 可 以 通过 load0 来 加 载 一 个 持久 化 实例 ， 这 种 加 载 就 是 根据 持久 化 类 的 标识 属性 值 加 载 持久 化 
实例 一 一 其 实质 就 是 根据 主键 从 数据 表 中 加 载 一 条 新 记录 。 

下 面 是 直接 加 载 持久 化 实例 的 代码 片段 : 

News n = sess.load(News.class , new Integer (pk)); 

在 上 面 代码 中 的 pk 就 是 需要 加 载 的 持久 化 实例 的 标识 属性 。 

如 果 没 有 匹配 的 数据 库 记 录 ，load0 方 法 可 能 抛 出 HibernateException 异常 ， 如 果 我 们 在 类 映射 
文件 中 指定 了 延迟 加 载 , 则 load0) 方 法 会 返回 一 个 未 初始 化 的 代理 对 象 (可 以 理解 为 持久 化 对 象 的 替 
身 )， 这 个 代理 对 象 并 没有 装载 数据 记录 ， 直 到 程序 调用 该 代理 对 象 的 某 方法 时 ，Hibernate 才 会 去 
访问 数据 库 。 

如 果 希 望 在 某 对 象 中 创建 一 个 指向 另 一 个 对 象 的 关联 ， 又 不 想 在 从 数据 库 中 装载 该 对 象 时 同时 装 
载 相关 联 的 所 有 对 象 ， 这 种 延迟 加 载 的 方式 就 非常 有 用 了 。 

与 load() 方 法 类 似 的 是 get0 方 法 ，get0 方 法 也 用 于 根据 主键 装载 持久 化 实例 ， 但 get() 方 法 会 立刻 
访问 数据 库 ， 如 果 没有 对 应 的 记录 ，get0 方 法 返回 null， 而 不 是 返回 一 个 代理 对 象 。 

当 程序 通过 load0 或 get0 方 法 加 载 实体 时 ，Hibernate 会 在 底层 对 应 地 生成 一 条 select 语句 ， 这 条 
select 语句 带 有 “where < 主键 列 >=< 标 识 属性 值 >” 子 句 ， 表 明 将 会 根据 主键 加 载 。 

SS”™ load0 方 法 和 get() 方 法 的 主要 区 别 在 于 是 否 延迟 加 载 ， 使 用 ioad0 方 法 将 具有 延迟 加 ”| 
名 载 功能 ，load() 方 法 不 会 立即 访问 数据 库 ， 当 试图 加 载 的 记录 不 存在 时 ，load() 方 法 可 能 返 | 
| 。 回 一 个 未 初始 化 的 代理 对 象 ; 而 get( 方 法 总 是 立即 访问 数据 库 ， 当 试图 加 载 的 记录 不 存在 

时 ，get() 方 法 将 直接 返回 null. | 
- 旦 加 载 了 该 持久 化 实例 后 ， 该 实体 就 处 于 持久 化 状态 ， 在 代码 中 对 持久 化 实例 所 做 的 修改 ， 例 如 : 
n.setTitle (“新 标题 ”); 

这 种 修改 将 被 保存 到 数据 库 ， 对 标题 的 修改 被 映射 成 修改 数据 表 的 特定 行 的 特定 列 。 

程序 对 持久 化 实例 所 做 的 修改 会 在 Session flush 之 前 被 自动 保存 到 数据 库 ， 无 须 程序 调用 其 他 方 
法 (不 需要 调用 update 方法 !) 来 将 修改 持久 化 。 也 就 是 说 ， 修 改 对 象 最 简单 的 方法 就 是 在 Session 处 
于 打开 状态 时 load0 它 ， 然 后 直接 修改 即 可 。 

如 果 我 们 调用 持久 化 实体 的 setter 方法 改变 了 它 的 属性 ，Hibernate 会 在 Session flush 之 前 生成 一 
条 update 语句 ， 这 条 update 语句 带 有 “where < 主键 列 >=< 标 识 属性 值 >” 子 句 ， 表 明 将 会 根据 主键 来 
修改 特定 记录 。 

例如 如 下 代码 片段 ， 将 可 修改 特定 行 的 数据 : 


News n = sess.load(News.class , new Integer (pk)); 
n.setTitle (“新 标题 ”) ; 
sess. flush(); 
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从 表面 上 看 ， 这 种 做 法 有 一 个 极 大 的 性 能 缺陷 ， 当 我 们 需要 修改 某 条 记录 时 ， 这 种 做 法 将 会 产生 
两 条 SQL 语句 ， 一 条 用 于 查询 指定 记录 的 select 语句 ， 另 一 条 用 于 修改 该 记录 的 updata 语句 。 

但 实际 应 用 中 无 须 考虑 这 种 性 能 缺陷 : 对 于 一 个 Java EE 应 用 而 言 ，Hibernate 通常 的 处 理 流程 是 : 
从 数据 库 里 加 载 记录 一 将 信息 发 送 到 表现 层 供用 户 修改 一 将 所 做 修改 重新 保存 到 数据 库 。 在 这 种 处 理 
流程 下 ， 应 用 本 身 就 需要 两 条 SQL 语句 。 

对 于 一 个 曾经 持久 化 过 的 、 但 现在 已 脱离 了 Session 管理 的 持久 化 对 象 ， 我 们 把 它 称 为 处 于 脱 管 
状态 。 当 我 们 修改 脱 管 对象 的 状态 后 ， 程 序 应 该 使 用 新 的 Session 来 保存 这 些 修改 。Hibernate 提供 了 
update0、merge0 和 updateOrSave0 等 方法 来 保存 这 些 修改 。 

例如 如 下 代码 片段 : 


News n = firstSess.load(News.class , new Integer(pPk))7 


// 第 一 个 Session 已 经 关闭 了 
firstSess.close() 
Wr 
n.setTitle (“新 标题 ”); 
// 打 开 第 二 个 Session 
Session secondSess = ... 


// 保 存 脱 管 对 象 所 做 的 修改 
secondSess.update (n) ; 


当 我 们 用 另 一 个 Session 来 保存 这 种 修改 后 ， 该 脱 管 对 象 再 次 回 到 Session 的 管理 之 下 ， 也 就 再 次 
回 到 持久 化 状态 。 

当 需 要 使 用 update 来 保存 程序 对 持久 化 对 象 所 做 的 修改 时 ,如 果 不 清楚 该 对 象 是 否 曾经 持久 化 过 ， 
那么 程序 可 以 选择 使 用 updateOrSave0 方 法 ， 该 方法 自动 判断 该 对 象 是 否 曾 经 持久 化 ， 如 果 曾 经 持久 
化 过 ， 就 使 用 update0) 操 作 ;， 否则 将 使 用 save0 操 作 。 

merge() 方 法 也 可 将 程序 对 脱 管 对 象 所 做 的 修改 保存 到 数据 库 ， 但 merge0 与 update() 方 法 最 大 的 区 
别 是 ，merge() 方 法 不 会 持久 化 给 定 对 象 。 举 例 来 说 ， 当 我 们 执行 sess.update(a) 代 码 后 ，a 对 象 将 会 变 
成 持久 化 状态 ， 而 执行 sess.merge(a) 代 码 后 ，a 对 象 依然 不 是 持久 化 状态 ，a 对 象 依然 不 会 被 关联 到 
Session 上 。 

当 程 序 使 用 merge() 方 法 来 保存 程序 对 脱 管 对 象 所 做 的 修改 时 ， 如 果 Session 中 存在 相同 持久 化 标 
识 (identifier) 的 持久 化 对 象 , merge 方法 里 提供 对 象 的 状态 将 履 盖 原 有 持久 化 实例 的 状态 .如 果 Session 
中 没有 相应 的 持久 化 实例 ， 则 尝试 从 数据 库 中 加 载 ， 或 创建 新 的 持久 化 实例 ， 最 后 返回 该 持久 化 实例 。 

merge() 用 法 代替 了 Hibernate 早期 版 本 的 saveOrUpdateCopy， 因 此 该 方法 的 作用 只 是 将 当前 对 象 
的 状态 信息 保存 到 数据 库 ， 并 不 会 将 该 对 象 转换 成 持久 化 状态 。 

当 我 们 使 用 load0 或 get() 方 法 来 加 载 持久 化 对 象 时 ， 还 可 指定 一 个 “ 锁 模式 ”参数 。Hibernate 使 
用 LockMode 对 象 代表 “ 锁 模式 "，LockMode 提供 了 READ、UPGRADE 两 个 静态 属性 来 代表 共享 、 
修改 锁 。 如 果 需 要 加 载 某 个 持久 化 对 象 以 供 修改 (相当 于 使 用 SQL 的 SELECT … FOR UPDATE 语句 
来 装载 对 象 )， 则 可 用 如 下 代码 : 

News n = Session.get (News.class , new Integer(pk) , LockMode.UPGRADE); 
lock0 方 法 也 将 某 个 脱 管 对 象 重新 持久 化 ， 但 该 脱 管 对 象 必须 是 没有 修改 过 的 ! 如 下 面 代码 所 示 : 


// 简 单 地 重新 持久 化 

sess.lock (news, LockMode.NONE); 

// 先 检查 持久 化 对 象 的 版 本 ， 然 后 重新 持久 化 该 对 象 

sess. lock (person, LockMode.READ); 

// 先 检查 持久 化 对 象 的 版 本 ， 然 后 使 用 SELECT . . 。FOR UPDATE 重新 持久 化 该 对 象 
sess.lock(teacher, LockMode.PESSIMISTIC_WRITE); 


请 注意 ,lockO 可 以 搭配 多 种 LockMode， 更 多 的 信息 请 阅读 API 文 档 以 及 关于 事务 处 理 (transaction 
handling) 的 章节 。 重 新 关联 不 是 lock0 的 唯一 用 途 。 
不 仅 如 此 , 还 可 以 通过 Session 的 delete 方法 来 删除 该 持久 化 实例 ,一 旦 删除 了 该 持久 化 实例 ， 该 


388 


http://52pdf.taobao.com 
第 5 章 5 
持久 化 实例 对 应 的 数据 记录 也 将 被 删除 。 


删除 持久 化 实例 的 代码 片段 如 下 : 


News n = Sessiorn.1load(News.class , new Integer(pk)); 
Session.delete(n); 


这 种 做 法 也 会 生成 两 条 SQL 语句 ， 但 在 实际 Java EE 应 用 中 没有 任何 问题 ， 因 为 Java EE 应 用 
总 需要 先 选 出 一 条 记录 ， 将 其 输出 到 表现 层 ， 等 用 户 确认 删除 这 条 记录 时 ， 系 统 才 会 真正 删除 这 条 
记录 。 
提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 CG 一 
SS Hibernate 本 身 不 提供 直接 执行 update 或 delete 语句 的 API，Hibernate 提供 的 是 一 种 ， 
面向 对 象 的 状态 管理 。 如 果 确 实 需要 直接 执行 DML 风格 的 update 或 delete 类 似 语句 ， 建 
| 。 议 使 用 Hibernate 的 批 处 理 功能 。 批 处 理 建议 参考 6.3 节 内 容 。 


5.6 深入 Hibernate 的 映射 文件 


在 上 面 的 例子 里 ， 可 以 看 到 一 个 简单 的 Hibernate 映射 文件 ， 每 个 Hibernate 映射 文件 的 基本 结构 
都 是 相同 的 。 


>>5.6.1 映射 文件 结构 


映射 文件 的 根 元 素 为 <hibernate-mapping.… 作 元 素 ， 该 元 素 下 可 以 拥有 多 个 <class.…. 人 > 子 元 素 ， 每 个 
<class.…/> 子 元 素 对 应 一 个 持久 化 类 的 映射 。 如 下 是 一 个 映射 文件 的 基本 结构 , 在 <hibernate-mapping.…/> 
元 素 下 可 以 有 多 个 <class.… 人 > 子 元 素 。 

<hibernate-mapping> 
<class/> 
<class/> 


</hibernate-mapping> 


<hibernate-mapping.…/> 元 素 可 以 指定 如 下 几 个 可 选 属性 。 

> schema: 指定 所 映射 数据 库 的 Schema 名 ,如 果 指 定 了 该 属性 , 则 表 名 会 自动 添加 该 Schema 
前 级 。 

> _catalog: 指定 所 映射 数据 库 的 Catalog 名 , 如 果 指 定 了 该 属性 , 则 表 名 会 自动 添加 该 Catalog 
前 缀 。 

> default-cascade: 设置 Hibernate 默认 的 级 联 风格 ， 该 属性 的 默认 值 是 none。 当 配置 Java 
属性 映射 和 集合 映射 时 还 可 指定 cascade 属性 ， 用 于 闭 盖 默认 的 级 联 风 格 。 如 果 配 置 Java 
属性 映射 、 集 合 映射 时 没有 指定 cascade 属性 ， 则 Hibernate 将 采用 此 处 指定 的 级 联 风 格 。 

> ”default-access: 指定 Hibernate 默认 的 属性 访问 策略 ,默认 值 为 property, 即使 用 getter/setter 
方法 对 来 访问 属性 〈 例 如 需要 访问 abc 属性 ， 则 应 该 提供 setAbc() 和 getAbc() 两 个 方法 ) 。 
如 果 指 定 access="field"， 则 Hibernate 会 忽略 getter/setter 方法 对 ， 而 是 通过 反射 来 访问 成 
员 变 量 。 如 果 需 要 实现 自己 的 属性 访问 策略 ， 则 需要 自己 提供 PropertyAccessor 接口 的 实现 
类 ， 再 在 access 中 设置 自 定义 属性 访问 策略 类 的 名 字 。 

> ”default-lazy: 设置 Hibernate 默认 的 延迟 加 载 策略 ， 该 属性 值 默认 为 tue， 即 启用 延迟 加 载 
策略 。 当 配置 Java 属性 映射 和 集合 映射 时 还 可 指定 lazy 属性 ， 用 于 四 盖 默认 的 延迟 加 载 策 
略 。 如 果 配 置 Java 属性 映射 、 集 合 映射 时 没有 指定 lazy 属性 ， 则 Hibernate 将 采用 此 处 指 
定 的 延迟 加 载 策略 。 
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提示 :汪清 风 下 不 应 该 关闭 延迟 加 载 策略 ， 例 如 当 加 载 一 个 Teacher 对 象 ， 上 该 Teacher | 
对 象 有 N 个 关联 的 Student 对 象 时 。 如 果 关闭 延迟 加 载 策略 ， 则 Hibernate 在 加 载 Teacher 对 | 

| 。 稍 时 会 自动 加 载 所 有 的 Student 对 象 一 一 如 果 该 Teacher 有 1 万 个 关联 的 Student 对 象 ， 更 其 ， 
至 有 100 万 个 ， 而 程序 仅 需要 访问 Teacher 对 象 ， 则 一 次 加 载 这 些 Student 对 象 纯 属 多 余 。 | 


> ”auto-import: 设置 是 否 允 许 在 查询 语言 中 使 用 非 全 限定 的 类 名 ( 仅 限于 本 映射 文件 中 的 类 ) 。 
该 属性 默认 是 true。 

提示 : : 

-Wf 如 果 同一 份 映射 文件 中 有 两 个 持久 化 类 映射 它们 的 类 名 是 一 样 的 (只 是 处 于 不 同 包 ， 


结构 下 ， 它 们 全 限定 类 名 不 同 ， 依 然 是 两 个 不 同 的 类 )， 则 应 该 设置 auto-import="false"; | 
| 否则 Hibernate 将 无 法 准确 分 别 两 个 类 ， 从 而 导致 Hibernate 抛 出 一 个 异常 。 ] 


> package: 该 属性 指定 一 个 包 前 级 ， 对 于 映射 文件 中 没有 指定 全 限定 的 类 名 ， 则 默认 使 用 该 
包 前缀 。 
接 下 来 看 <class.… 人 > 元素， 每 个 <class.. 人 元素 对 应 一 个 持久 化 类 。 首 先 必须 采用 name 属性 来 指定 
该 持久 化 类 映射 的 持久 化 类 的 类 名 ， 此 处 的 类 名 应 该 是 全 限定 的 类 名 。 如 果 不 使 用 全 限定 的 类 名 ， 则 
必须 在 <hibernate-mapping... 人 > 元 素 里 指定 package 属性 ，package 属性 指定 持久 化 类 所 在 的 包 名 。 


报 节 站 让 一 和 天 后 二 站 
<hibernate-mapping... 人 > 元素 是 多 个 <class../> 元 素 的 父 元 素 ， 为 <hibernate-mapping.… 人 > 

Fea 元 素 指 定 的 schema、catalog、default-cascade、default-access、default-lazy 等 属性 将 会 对 它 | 
| 。 所 包含 的 所 有 的 <class.../> 元 素 起 作用 ,这些 属性 将 控制 每 个 <class... 人 > 所 映射 的 持久 化 类 的 ， 

默认 行为 。 而 每 个 <class... 人 > 也 可 指定 这 些 属性 ， 用 于 覆盖 <hibernate-mapping.…> 指 定 的 默 | 


人 
站 -注重 :1 
<hibemrnate-mapping.. 人 > 元 素 可 以 包含 多 个 <class.../> 子 元 素 ， 也 就 是 说 ， 一 个 映射 文 
件 可 以 定义 多 个 持久 化 类 ， 但 是 最 好 的 做 法 ( 甚至 某 些 情况 下 是 必需 的 ) 是 一 个 持久 化 
类 (或 一 个 类 的 继承 层次 ) 对 应 一 个 映射 文件 ， 并 以 持久 化 的 超 类 名 称 作为 该 映射 文件 订 


的 主 文件 名 ， 例 如 : News.hbm.xml、Person.hbm.xml 


除 name 属性 之 外 ，<class... 食 元素 也 可 指定 schema、catalog 、lazy 来 牙 盖 <hibernate-mapping.…/> 
元 素 所 指定 的 默认 行为 。 除 此 之 外 还 可 指定 如 下 可 选 的 属性 。 
> ”table: 指定 该 持久 化 类 映射 的 表 名 ，Hibernate 默认 以 持久 化 类 的 类 名 作为 表 名 。 
> discriminator-value: 指定 区 分 不 同 子 类 的 值 ， 当 使 用 <subclass.…/> 元 素来 定义 持久 化 类 的 
继承 关系 映射 时 需要 使 用 该 属性 。 


> ”mutable: 用 于 指定 持久 化 类 的 实例 是 可 变 对 象 还 是 不 可 变 对 象 ,该 属性 只 能 接受 true 和 false 
两 个 属性 值 ， 该 属性 默认 值 是 true。 
> proxy: 指定 一 个 接口 ， 在 延迟 装载 时 作为 代理 使 用 ， 也 可 以 在 这 里 指定 该 类 自己 的 名 字 。 


提示 :… 一 … 一 … 一 -… 一 … 一 -… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … = 
Pon 在 本 书后 面 介 绍 持久 化 类 的 继承 映射 时 还 会 介绍 到 discriminator-value 属性 。 
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> dynamic-update: 指定 用 于 更 新 记录 的 update 语句 是 否 在 运行 时 动态 生成 ， 并 且 只 更 新 那 
些 改变 过 的 字段 。 该 属性 默认 是 false。 开 启 该 属性 将 导致 Hibernate 需要 更 多 时 间 来 生成 
SQL 语句 。 


提示 :一 一 一 一 二 
当 程 序 打开 了 dynamic-update 之 后 ， 映 射 文件 可 以 指定 如 下 几 种 乐观 锁定 的 策略 . | 


S 今 version: 检查 version/timestamp 字段 。 到 
| 仿 all: 检查 全 部 字段 。 1 
今 dirty: 只 检查 修改 过 的 字段 。 : 
| 姓 none: 不 使 用 乐观 锁定 。 | 
， 非常 强烈 建议 你 在 Hibernate 中 使 用 version/timestamp 字段 来 进行 乐观 锁定 ,对 性 能 来 。 
| 说， 这 是 最 好 的 选 泽 ， 并 且 这 也 是 唯一 能 够 处 理 在 Session 外 进行 脱 管 操作 的 策略 ， | 


> dynamic-insert: 指定 用 于 插入 记录 的 insert 语句 是 否 在 运行 时 动态 生成 , 并 且 只 插入 那些 非 
空 字段 。 该 属性 默认 是 false。 开 启 该 属性 将 导致 Hibernate 需要 更 多 时 间 来 生成 SQL 语句 。 
> select-before-update: 指定 Hibernate 在 更 新 (update) 某 个 持久 化 对 象 之 前 是 否 需 要 先进 
行 一 次 查询 (select) 。 如 果 指定 该 属性 为 true， 则 Hibernate 可 以 保证 只 有 当 持久 化 对 象 的 
状态 被 修改 过 时 ， 才 会 使 用 update 语句 来 保存 其 状态 即使 程序 显 式 使 用 saveOrUpdate() 
来 保存 该 对 象 ， 但 如 果 Hibernate 查询 到 对 应 记录 与 该 持久 化 对 象 的 状态 相同 ， 则 不 会 使 用 
update 语句 来 保存 其 状态 )。 该 属性 值 默 认 是 false。 
SS”™ 通常 来 说 ， 使 用 select-before-update 会 降低 性 能 ， 如 果 应 用 程序 中 某 个 持久 化 对 象 的 
状态 经 常会 发 和 改变， 那么 该 属性 应 该 设置 为 false; 如 果 该 持久 化 对 象 的 状态 很 少 发 生 改 | 
| ” 变 ， 而 程序 又 经 常 要 保存 该 对 象 ， 则 可 将 该 属性 设置 为 true. j 
> ”polymorphism: 当 采 用 <union-subclass.../> 元 素来 配置 继承 映射 时 ， 该 元 素 指定 是 否 需 要 采 
用 隐 式 多 态 查询 。 该 属性 的 默认 值 为 implicit。 
人 a 提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
当 指 定 polymorphism 为 true 时 ， 如 果 查 询 时 给 出 的 是 任何 超 类 、 该 类 实现 的 接口 或 
该 类 的 名 字 ， 都 会 返回 该 类 (及 其 子 类 ) 的 实例 ; 如 果 查 询 中 给 出 的 是 子 类 的 名 字 ， 则 只 | 
| ”返回 子 类 的 实例 。 否则， 只 有 在 查询 时 明确 给 出 某 个 类 名 时 ， 才 会 返回 这 个 类 的 实例 。 大 ， 
部 分 时 候 我 们 都 需要 使 用 隐 式 多 态 。 
> ”where: 指定 一 个 附加 的 SQL 语句 中 过 滤 条 件 (类 似 于 添加 where 子 句 ) ， 如 果 一 旦 指定 了 
该 属性 ， 则 不 管 采用 load()、get() 还 是 其 他 查询 方法 ， 只 要 试图 加 载 该 持久 化 类 的 对 象 时 ， 
该 where 条 件 都 会 生效 。 也 就 是 说 ， 只 有 符合 该 where 条 件 的 记录 才 会 被 加 载 出 来 。 
> ”persister: 指定 一 个 定制 的 ClassPersister。 
Fc 1 站 
通常 程序 无 须 指定 该 属性 ， 除 非 程序 需要 自行 保存 该 持久 化 对 象 的 状态 (也 就 是 自己 ， 
名 决定 怎样 保存 该 对 象 )， 程 序 可 以 继承 org.hibernate.persister EntityPersister 基 类 创建 自 定义 | 
| ”的 持久 化 器 , 甚至 可 以 完全 从 头 开始 编写 一 个 org.hibernate.persister ClassPersister 接口 的 实 : 
; ” 现 类 ， 例 如 调用 存储 过 程 来 保存 某 个 持久 化 对 象 ， 或 者 将 该 对 象 序列 化 到 磁盘 ， 或 者 使 用 
| LDAP 数据 库 等 . 
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batch-size: 指定 根据 标识 符 (identifier) 来 抓 取 实例 时 每 批 抓 取 的 实例 数 。 该 属性 值 默认 是 1。 
optimistic-lock: 该 属性 指定 乐观 锁定 策略 。 该 属性 的 默认 值 是 version。 
check: 指定 一 个 SQL 表达 式 ， 用 于 为 该 持久 化 类 所 对 应 的 表 指定 一 个 多 行 的 Check 约束 。 
subselect : 该 属性 用 于 映射 不 可 变 的 、 只 读 实体 。 通 俗 地 说 ， 就 是 将 数据 库 的 子 查询 映射 
成 Hibernate 持久 化 对 象 。 当 需要 使 用 视图 (其 实质 就 是 一 个 查询 ) 来 代替 数据 表 时 ， 该 属 
性 比较 有 用 。 

如 果 需 要 采用 继承 映射 ， 则 class 元 素 下 还 会 增加 <subclass... 伺 元素、<joined-subclass.…/> 或 
<union-subclass.… 信 元 素 ， 这 些 元 素 分 别 用 于 定义 子 类 。 

Hibernate 允许 将 一 个 接口 指定 为 持久 化 类 ， 然 后 可 以 用 元 素 <subclass... 人 > 来 指定 该 接口 的 实现 类 。 
我 们 也 可 以 持久 化 任何 静态 的 内 部 类 ， 只 要 使 用 静态 内 部 类 的 格式 指定 类 名 即 可 ， 如 Foo$Bar。 

正如 前 面 见 到 的 , 当 使 用 <class .… 人 > 元 素来 映射 某 个 持久 化 类 时 , 通常 还 需要 <id.… 人 > 和 <property… 人 > 
两 个 最 常见 的 子 元 素 ， 其 中 <id... 人 > 元 素 用 于 映射 标识 属性 ， 而 <property.. 人 > 用 于 映射 普通 属性 。 


六 和 5.6.2 映射 主键 


通常 情况 下 ，Hibemate 建议 为 持久 化 类 定义 一 个 标识 属性 ， 用 于 唯一 地 标识 某 个 持久 化 实例 ， 而 
标识 属性 则 需要 映射 到 底层 数据 表 的 主键 。 
标识 属性 通过 <id... 人 元 素来 指定 。<id... 人 > 元 素 的 name 属性 的 值 就 是 持久 化 类 标识 属性 名 。 除 此 
之 外 ，<id... 亿 元素 还 可 指定 如 下 几 个 可 选 属性 。 
> ”type: 指定 该 标识 属性 的 数据 类 型 ， 该 类 型 既 可 以 是 Hibernate 内 建 类 型 ， 也 可 以 是 Java 类 
型 ， 如 果 使 用 Java 类 型 则 需要 使 用 全 限定 类 名 ( 带 包 名 ) 。 该 属性 是 可 选 的 ， 如 果 映 射 文 
件 中 没有 指定 该 属性 ， 则 由 Hibernate 自行 判断 该 标识 属性 的 数据 类 型 ， 通 常 建议 设置 该 属 
性 ， 这 会 保证 更 好 的 性 能 。 
> ”column: 设置 标识 属性 所 映射 的 数据 列 的 列 名 。 在 默认 情况 下 ， 该 列 的 列 名 与 该 标识 属性 的 
属性 名 相同 。 
> ”unsaved-value: 指定 当 某 个 实例 刚刚 创建 、 还 未 保存 时 的 标识 属性 值 。 这 个 属性 值 可 用 于 将 
这 种 实例 和 从 以 前 的 Session 中 装载 过 、 但 未 再 次 持久 化 的 实例 区 分 开 。 在 Hibernate 3 中 
通常 无 须 设置 该 属性 。 
> ”access: 指定 Hibernate 访问 该 标识 属性 的 访问 策略 ， 默 认 是 property。 该 属性 用 于 米 盖 根 
元 素 <hibernate-mapping.…/> 中 的 default-access 属性 。 
其 实 <id.…/> 元 素 的 name 也 是 可 选 的 ， 如 果 不 设 置 name 属性 ， 则 表明 该 持久 化 类 没有 标识 属性 。 
儿 乎 所 有 现代 的 数据 库 建 模 理论 都 推荐 不 要 使 用 具有 实际 意义 的 物理 主键 ， 而 是 推荐 使 用 没有 任 
何 实际 意义 的 逻辑 主键 。 尽 量 避 免 使 用 复杂 的 物理 主键 ， 应 考虑 为 数据 库 增 加 一 列 ， 作 为 逻辑 主键 。 
表面 上 看 ， 增 加 逻辑 主键 增加 了 数据 宛 余 ， 但 如 果 从 外 键 关联 的 角度 看 ， 使 用 逻辑 主键 的 主 从 表 关 联 
中 ， 从 表 只 需 增加 一 个 外 键 列 。 如 果 使 用 多 列 作为 联合 主键 ， 则 需要 在 从 表 中 增加 多 个 外 键 列 ， 如 果 
有 多 个 从 表 需 要 增加 外 键 列 ， 则 数据 宛 余 更 大 。 
使 用 物理 主键 还 会 增加 数据 库 维护 的 复杂 度 ， 主 从 表 之 间 的 约束 关系 隐 讳 难 懂 ， 难 于 维护 。 
他 辑 主键 没有 实际 意义 ， 仅 仅 用 来 标识 一 行 记录 。Hibemate 为 这 种 逻辑 主键 提供 了 主键 生成 器 ， 
它 负责 为 每 个 持久 化 实例 生成 唯一 的 逻辑 主键 值 。 
主键 生成 器 负责 生成 数据 表 记录 的 主键 。 通常 有 如 下 常见 的 主键 生成 器 。 
> increment: 为 long、short 或 者 int 类 型 主键 生成 唯一 标识 。 只 有 在 没有 其 他 进程 往 同一 张 
表 中 插入 数据 时 才能 使 用 。 在 集群 下 不 要 使 用 ! 
> identity: 在 DB2、MySQL、 Microsoft SQL Server、 Sybase 和 HypersonicSQL 等 提供 identity 


vvvyv 
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( 自 增长 ) 主键 支持 的 数据 表 中 适用 。 返 回 的 标识 属性 是 long、short 或 int 类 型 的 。 
> sequence: 在 DB2、PostgreSQL、Oracle、SAP DB、McKoi 等 提供 sequence 支持 的 数据 
表 中 适用 。 返 回 的 标识 属性 值 是 long、short 或 int 类 型 的 
> _hilo: 使 用 一 个 高 /低位 算法 高 效 的 生成 Iong、short 或 int 类 型 的 标识 符 。 给 定 一 个 表 和 字段 
(默认 分 别 是 hibernate_unique_key 和 next_hi) 作为 高 位 值 的 来 源 。 高 /低位 算法 生成 的 标 
识 属性 值 只 在 一 个 特定 的 数据 库 中 是 唯一 的 。 
> ”seqhilo: 使 用 一 个 高 /低位 算法 来 高 效 地 生成 long、short 或 int 类 型 的 标识 符 ， 需 要 给 定 一 
个 数据 库 sequence 名 。 该 算法 与 hilo 稍 有 不 同 ， 它 将 主键 历史 状态 保存 在 Sequence 中 ， 
适用 于 支持 Sequence 的 数据 库 ， 如 Oracle。 
> ”uuid: 用 一 个 128 位 的 UUID 算法 生成 字符 串 类 型 的 标识 符 ， 这 在 一 个 网 络 中 是 唯一 的 〈IP 
地 址 也 作为 算法 的 数据 源 ) 。UUID 被 编码 为 一 个 32 位 十 六 进 制 数 的 字符 串 。 
Ra 提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
UUID 算法 会 根据 耳 地 址 ，JVM 的 启动 时 间 (精确 到 1/4 秒 )、 系 统 时 间 和 一 个 计数 ， 
”器 值 (在 JVM 中 唯一 ) 来 生成 一 个 32 位 的 字符 囊 ， 因 为 通常 UUID 生成 的 字符 囊 在 一 个 
| ”网 络 中 是 唯一 的 j 
> guid: 在 Microsoft SQL Server 和 MySQL 中 使 用 数据 库 生 成 的 GUID 字符 串 。 
> native: 根据 底层 数据 库 的 能 力 选择 identity、sequence 或 者 hilo 中 的 一 个 。 
> ”assigned: 让 应 用 程序 在 save() 之 前 为 对 象 分 配 一 个 标识 符 。 这 相当 于 不 指定 <generator.../> 
元 素 时 所 采用 的 默认 策略 。 
> select: 通过 数据 库 触 发 器 选择 某 个 唯一 主键 的 行 ， 并 返回 其 主键 值 作为 标识 属性 值 。 
> ”foreign: 表明 直接 使 用 另 一 个 关联 的 对 象 的 标识 属性 值 〔 即 本 持久 化 对 象 不 能 生成 主键 。 
人 1 一 1 关联 映射 中 才 有 用 。 


提示 示 “一 
六 ;大 部 分 数据 库 ， 如 Oracle、DB2、MySQL 等 都 提供 了 易 用 的 主键 生成 机 制 (dt 
字段 或 sequence 等 )， 因 此 我 们 完全 可 以 在 数据 库 提供 的 主键 生成 机 制 上 ， 采 用 <generator | 
| class="native"/> 的 主键 生成 方式 。 j 
下 面 是 Hibernate 映射 文件 的 示例 片段 。 


<class name="News" table="news_table”> 
<1!-- 定义 标识 属性 --> 
<id name = "id" column="news_id"> 
<!-- 定义 主键 生成 器 --> 
<generator class="identity"/> 
</id> 
<!-- 用 于 定义 普通 属性 -> 
<property.…./> 
<property.../> 
</class> 


上 面 的 粗 体 字 代 码 指 定 该 主键 生成 器 策略 是 identity， 这 表明 Hibernate 将 根据 底层 数据 库 的 
identity 字段 来 提供 标识 属性 值 。 


》》5.6.3 映射 普通 属性 


Hibemate 使 用 <property.… 亿 元 素来 映射 普通 属性 ， 配 置 <property... 人 > 元 素 时 只 需要 指定 一 个 name 
属性 ，name 属性 映射 持久 类 的 属性 名 。 如 果 想 指定 属性 在 数据 表 里 存储 的 列 名 ， 还 可 以 定义 column 
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属性 来 强制 指定 列 名 ， 列 名 默认 与 属性 名 相同 。 

除 此 之 外 ，<property.…/> 元 素 还 支持 如 下 几 个 可 选 属性 。 

> ”type: 指定 该 普通 属性 的 数据 类 型 ， 一 个 Hibernate 类 型 的 名 字 。 该 type 属性 与 前 面 <id.…/> 
元 素 type 属性 的 作用 基本 类 似 ， 但 要 求 更 低 。 

> update、insert: 用 于 设置 Hibernate 生成 的 update 或 insert 语句 中 是 否 需 要 包含 该 字段 ， 
这 两 个 属性 的 默认 值 都 是 tue。 如 果 该 属性 是 一 个 “外 源 性 ”的 属性 ， 即 它 的 值 来 源 于 映射 
到 同一 个 (或 多 个 ) 字段 的 其 他 属性 ， 或 者 是 由 触发 器 或 其 他 程序 生成 的 ， 总 之 无 须 由 
Hibernate 生成 ， 则 可 将 这 两 个 属性 设 为 false。 

> ”formula: 该 属性 指定 一 个 SQL 表达 式 ， 指 定 该 属性 的 值 将 根据 表达 式 来 计算 ， 计 算 属 性 没 
有 和 它 对 应 的 数据 列 。 

> access: 定义 Hibernate 访问 该 属性 的 访问 策略 ， 默 认 是 property。 该 属性 用 于 覆盖 根 元 素 
<hibernate-mapping.…/> 中 的 default-access 属性 。 

> ”lazy; 指定 当 该 实例 属性 第 一 个 被 访问 时 ， 是 否 启动 延迟 加 载 。 该 属性 默认 是 false。 

> unique: 设置 是 否 为 该 属性 所 映射 的 数据 列 添加 唯一 约束 。 如 果 设 置 为 tue， 就 允许 该 字段 
作为 property-ref 引用 的 目标 。 

> not-null， 设 置 是 否 为 该 属性 所 映射 的 数据 列 添加 not null 约束 。 

> ”optimistic-lock: 设置 该 属性 在 进行 更 新 时 是 否 需要 使 用 乐观 锁定 ， 该 属性 值 默认 是 true。 也 
就 是 说 ， 在 默认 情况 下 ， 当 该 属性 的 值 发 生 改变 时 ， 该 持久 化 对 象 的 版 本 值 将 会 增长 。 

> ”generated: 设置 该 属性 映射 的 数据 列 的 值 是 否 由 数据 库 生成 ， 该 属性 可 以 接受 never (不 由 
数据 库 生 成 ) 、insert (该 属性 值 是 insert 时 生成 ， 但 不 会 在 随后 的 update 时 重新 生成 ) 、 
always 【该 属性 值 在 insert 和 update 时 都 会 被 重新 生成 ) 。 

> index: 指定 一 个 字符 串 的 索引 名 称 。 当 系统 需要 Hibernate 自动 建 表 时 ， 用 于 为 该 属性 所 映 
射 的 数据 列 创 建 索引 ， 从 而 加 速 基 于 该 数据 列 的 查询 。 

> unique_key: 指定 一 个 唯一 键 的 名 称 。 当 系统 需要 Hibernate 自动 建 表 时 ， 用 于 为 该 属性 所 
映射 的 数据 列 创建 唯一 索引 ， 只 有 当 该 数据 列 具有 唯一 约束 时 才 有 效 。 

> “length: 指定 该 属性 所 映射 数据 列 的 字段 长 度 。 

> precision: 指定 该 属性 所 映射 数据 列 的 有 效 数字 位 的 位 数 ， 对 数值 型 的 数据 列 有 效 。 

> ”scale: 指定 该 属性 所 映射 数据 列 的 小 数位 数 ， 对 double、float、decimal 等 类 型 的 数据 列 有 效 。 


上 面 type 属性 的 值 可 以 是 如 下 几 种 : 
> ”Hibernate 基本 类 型 名 (比如 : integer、string、character、date、timestamp、float、binary、 
serializable、object、blob) 。 NA 


> ”Java 类 的 全 限定 类 名 ， 该 类 等 同 于 上 面 的 一 种 Hibernate 基础 类 型 如: int、float、char、 
java.lang.String、java.util.Date、java.lang.Integer、java.sql.Clob 等 ) 。 

> ”一 个 可 以 序列 化 的 Java 类 的 类 名 。 

用 户 自 定义 类 的 类 名 〈 如 : org.crazyitmodel.Bid) 。 

<property.. 人 > 元 素 中 的 formula 属性 允许 对 象 属性 包含 表达 式 ， 包 括 运用 sum、average、max 函数 
求 值 的 结果 。 例 如 : 

formula=" (select avg(p.price) from Product p)"/> 

formula 甚至 可 以 根据 当前 记录 的 特定 属性 值 从 另 一 个 表 查 询 值 。 例 如 下 面 代码 : 

formula=" (select cur.name from currency cur where cur.id=currencyID)"/> 

使 用 formula 属性 时 有 如 下 几 个 注意 点 : 

> ”formula="( sql )" 的 英文 括号 不 能 少 。 


394 


http://52pdf.taobao.com 


半生 


> ”formula="()" 的 括号 里 面 是 SQL 表达 式 语句 ，SQL 表达 式 中 的 列 名 和 表 名 都 应 该 和 数据 库 对 
应 ， 而 不 是 和 持久 化 对 象 的 属性 对 应 。 

> ”如 果 需 要 在 formula 属性 中 使 用 参数 ， 则 直接 使 用 where curid= currencylD 形式 ， 其 中 
currencyID 就 是 参数 ， 当 前 持久 化 对 象 的 currencylD 属性 将 作为 参数 传 入 。 

例如 有 如 下 持久 化 类 。 

程序 清单 :codes\05\5.6\formulalsrc\org\crazyit\app\domain\News.java 

public class News 


{ 
// 消 息 类 的 标识 属性 
private Integer id; 
// 消 息 标题 
private String title; 
// 消 息 内 容 
private String content; 
// 消 息 全 部 内 容 ， 由 系统 根据 公式 生成 
private String fullContent; 
// 省 略 id 属性 的 setter 和 getter 方法 


/77 省 略 title 属性 的 setter 和 getter 方 法 
77 省 略 content 属性 的 setter 和 getter 方 法 
/7 省略 fullContent 属性 的 setter 和 getter 方 法 


} 
上 面 PO 类 的 fullContent 属性 并 不 需要 采用 数据 列 保 存 , 该 属性 的 值 将 由 系统 根据 SQL 表达 式 来 
生成 ， 所 以 我 们 映射 凶 liContent 属性 时 将 指定 formula 属性 。 下 面 是 News.hbm.xml 文件 的 代码 。 
程序 清单 ，codes\05\5.6\formula\src\org\crazyit\app\domain\News.hbm.xml 


<?xml version="1.0" encoding="gb2312"?> 
指定 Hiberante3 映射 文件 的 DTD 信息 --> 
DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- hibernate-mapping 是 映射 文件 的 根 元 素 --> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 每 个 class 元 素 对 应 一 个 持久 化 对 象 
<class name="News" table="news_table"> 
<!- id 元 素 定义 持久 化 类 的 标识 属性 --> 
<id name="id"> 
<generator class="identity"/> 
</id> 
<!-- property 元 素 定义 常规 属性 --> 
<property name="title" not-null="true"/> 
<property name="content"/> 
<!-- 通过 formula 指定 该 属性 值 没有 对 应 的 实际 数据 列 
该 属性 值 将 由 系统 根据 表达 式 来 生成 --> 
name="fullContent" 
formula=" (select concat(nt.title,nt.content) 
from news_table nt where nt.id= id)"/> 


</class> 
</hibernate-mapping> 


上 面 的 映射 文件 中 的 粗 体 字 代 码 通 过 formula 指定 了 fullContent 属性 的 SQL 表达 式 ， 则 该 属性 不 
会 保存 不 会 有 对 应 的 数据 列 ， 该 属性 值 将 根据 SQL 表达 式 计算 。 看 如 下 主 程序 。 
程序 清单 : codes\05\5.6\formula\src\lee\NewsManagerjava 


public class NewsManager 
{ 
public static void main(String[] args) throws Exception 
l 
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// 实 例 化 Configuration， 这 行 代码 默认 加 载 hibernate.cfg.xml 文件 
Configuration conf = new Configuration() -configure()7 
// 以 Configuration 创建 SessionFactory 

SessionFactory sf = conf.buildsessionFactory(); 


// 实 例 化 Session 
Session sess = sf.opensession(); 
// 开 始 事务 
Transaction tx = sess.beginTransaction(); 
/ // 创 建 游 良 笑 全 
// News n = new News(); 
LA // 讼 香洲 应 村 著 到 洲 委 内 凑 
// n,setTitle(" 疙 阁 Java 刁 肛 成 立 厂 ") ; 
WW n.setContent (" 茂 疗 Java 酉 坟 成 立 7，” 
AAA + “网 闽 希 姐 http:VVwww. crazyit.org")» 
// AV 保 新 游 康 
// sess. save (n); 
News n2 = (News)sess.get(News.class , 1); 
// 输 出 fullCcontent 属性 值 
System.out.printin(n2.getFullContent ()); 
// 提 交 事务 


tx.commit (); 
// 关 闭 Session 
sess.close(); 


提示 :一 一 一 一 一 一 一 一 一 一 一 一 一 … en 
运行 上 面 程序 应 先 注释 上 面 程序 中 两 行 粗 体 字 代 码 ， 取 消 上 面 针 体 宇 代码 的 注释 ， 这， 

样 先 将 数据 插入 到 数据 库 ， 然 后 再 将 hibernate.cfg.xml 文件 中 hbm2ddl.auto 属性 修改 成 

了 上 面 程序 时 数据 库 中 已 有 供 操作 的 据 


1 _update， 这 样 保 i 运 


运行 上 面 的 程序 将 看 到 输出 title 属性 和 content 属性 连 级 而 成 的 字符 串 一 一 这 就 是 根据 SQL 表达 
式 计算 的 结果 。 如果 查看 底层 数据 表 将 会 发 现 , Hibernate 并 没有 为 fullContent 属性 生成 对 应 的 数据 列 。 
如 果 持 久 化 对 象 有 任何 属性 不 是 由 Java 程序 提供 ， 而 是 由 数据 库 生 成 的 ， 包 括 该 数据 列 使 用 
timestamp 数据 类 型 、 数 据 库 采 用 触发 器 来 为 该 列 自 动 插入 值 等 ， 我 们 都 可 以 在 <property.… 人 > 元 素 中 指 
定 generated 属性 。 
对 于 指定 了 generated 属性 的 持久 化 对 象 ， 每 当 Hibernate 执行 一 条 insert ( 当 generated 值 为 insert 
或 always 时 ) 或 update ( 当 generated 属性 值 为 always 时 ) 语句 时 ，Hibernate 会 立刻 执行 一 条 select 
语句 来 获得 该 数据 列 的 值 ， 并 将 该 值 赋 给 该 持久 化 对 象 的 该 属性 。 
本 示例 所 使 用 的 持久 化 类 : News 类 与 前 一 个 示例 的 相同 ， 只 是 此 时 的 fullContent 属性 值 将 由 数 
据 库 系统 生成 ,所 以 在 配置 fllContent 属性 时 应 指定 generated 属性 。 该 持久 化 类 的 映射 文件 如 下 所 示 。 
程序 清单 :codes\05\5.6\generated\src\org\crazyit\app\domain\News.hbm.xml 
<?xml version="1.0" encoding="gb2312"?> 
<!-- 指定 Hiberante3 映射 文件 的 DTD 信息 --> 
<1DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- hibernate-mapping 是 映射 文件 的 根 元 素 --> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 每 个 class 元 素 对 应 一 个 持久 化 对 象 --> 
<class name="News" table="news_table"> 
<!-- id 元 素 定义 持久 化 类 的 标识 属性 一 > 
<id name="id"> 
<generator class="identity"/> 
</id> 
<!-- Property 元 素 定义 常规 属性 一 -> 
<property name="title" not-null="true"/> 
<property name="content"/> 
<!-- 为 该 property 指定 generated 属性 为 always 
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该 属性 的 值 由 数据 库 生 成， 
而 Hibernate 会 在 每 次 插入 、 更 新 之 后 执行 
select 语句 来 查询 到 该 属性 的 值 --> 
<property name="fullContent" 
column="full_content" type="string" 
generated="insert"/> 
</class> 
</hibernate-mapping> 
上 面 的 映射 文件 中 粗 体 字 代码 指定 fullContent 属性 将 由 数据 库 系统 自动 生成 ， 为 了 让 数据 库 系统 
使 fullContent 属性 (对 应 full_content 数据 列 ) 自动 生成 值 ， 本 程序 需要 触发 器 支持 。 下 面 是 本 应 用 所 
使 用 的 数据 库 脚 本 。 
程序 清单 : codes\05\5.6\generated\sql.sql 
drop database hibernate; 
create database hibernate; 
use hibernate; 
Create table news_table 
( 
td int auto_increment primary key, 
title varchar(255) not null, 


content varchar (255), 
full_content varchar (255) 


Wa 
DELIMITER | 
create trigger t_full_content_gen BEFORE INSERT ON news_table 
FOR EACH ROW BEGIN 
set new.full_content=concat (new.title,new.content); 
END; 


| 
DELIMITER ; 


提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
运行 本 示例 程序 之 前 应 先 执行 此 数据 库 脚本 ， 除 此 之 外 ， 上 面 示例 程序 

hibernate.cfg.xml 文件 中 的 hbbm2ddl.auto 属性 值 为 update， 而 不 是 create。 这 是 为 了 避免 重 | 

| 。 建 数据 库 时 导致 触发 器 丢失 。 J 


该 示例 程序 的 主 程序 使 用 如 下 代码 片段 来 保存 一 个 News 对 象 。 
程序 清单 : codes\05\5.6\generated\src\lee\NewsManagerjava 
/7/ 此 处 省 略 了 打开 Session、Transaction 的 代码 
/7 创建 消息 实例 
News n = new News(); 
// 设 置 消息 标题 和 消息 内 容 
n.setTitle(" 状 闻 J 
n.setContent (" 状 托 ， 
+ "网 站 地 址 http://www.crazyit .org"); 
// 保 存 消息 
sess.save (n); 
// 输 出 fullContent 属性 ， 将 看 到 title 和 content 连 级 的 字符 串 
System ,out.Println (n.getFullContent()) ; 
上 面 的 程序 中 仅 设置 了 News 对 象 的 title 和 content 属性 ， 并 未 设置 fnliContent 属性 值 , 但 保存 了 
该 News 对 象 后 , Hibernate 将 执行 select 语句 来 为 该 bllContent 属性 赋值 .程序 中 粗 体 字 代 码 输出 News 
对 象 的 fullContent 属性 ， 将 看 到 title 和 content 属性 拼接 得 到 的 字符 串 。 
任何 可 以 使 用 column 或 formula 属性 的 地 方 都 可 使 用 <column.../> 或 <formula... 伺 子 元 素 ， 通 常 我 
们 使 用 column 属性 或 formula 属性 就 足够 了 ， 但 如 果 需 要 指定 更 多 额外 的 信息 ， 则 可 以 通过 使 用 
<column... 记 或 <formula... 记 子 元 素来 设 定 。 


例如 ， 下 面 两 段 配置 文件 的 效果 是 一 样 的 。 
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<property name="fullContent™ 
column="full_content" type="string" 
generated="insert"/> 


<!- 使 用 column 子 元 素来 配置 列 信息 -> 


<property name="fullContent™" 
type="string" generated="insert"> 
<column name="full_content"/> 
</property> 


使 用 <column,../> 子 元 素 时 可 以 指定 一 个 sql-type 属性 ， 该 属性 设置 一 个 SQL 类 型 ， 用 于 精确 地 指 
定 该 数据 列 的 SQL 类 型 。 


六 >5.6.4 映射 集合 属性 


集合 属性 也 是 非常 常见 的 ， 例 如 每 个 人 的 考试 成 绩 ， 就 是 典型 的 Map 结构 ， 每 门 功课 对 应 一 个 成 
绩 。 或 者 更 简单 的 集合 属性 ， 如 某 个 企业 的 部 门 ， 一 个 企业 通常 对 应 多 个 部 门 等 。 集 合 属性 是 现实 中 
非常 普遍 的 属性 关系 。 

集合 属性 大 致 有 两 种 : 第 一 种 是 单纯 的 集合 属性 ， 例 如 像 List、Set 或 数组 等 集合 属性 ; 还 有 一 种 
是 Map 结构 的 集合 属性 ， 每 个 属性 值 都 有 对 应 的 key 映射 。 

Hibermnate 要 求 持久 化 集合 值 字段 必须 声明 为 接口 ， 实 际 的 接口 可 以 是 java.util.Set 、 
java.util.Collection 、java.util.List、java.util.Map、java.util.SortedSet、java.util.SortedMap 等 ， 其 至 是 自 
定义 类 型 (只 需要 实现 org.hibernate.usertype.UserCollectionType 接口 即 可 )。 

Hibemate 之 所 以 要 求 用 集合 接口 来 声明 集合 属性 ， 是 因为 当 程序 持久 化 某 个 实例 时 ，Hibernate 
会 自动 把 程序 中 的 集合 实现 类 替换 成 Hibernate 自己 的 集合 实现 类 ， 因 此 不 要 试图 把 Hibernate 集合 属 
性 强制 类 型 转换 为 集合 实现 类 ,如 HashSet、HashMap 等 ,但 可 以 转换 为 Set、Map 等 集合 ,因为 Hibernate 
自己 的 集合 类 也 实现 了 Map、Set 等 接口 。 

集合 类 实例 具有 值 类 型 的 行为 ， 当 持久 化 对 象 被 保存 时 ， 这 些 集合 属性 会 被 自动 持久 化 ， 当 持久 
化 对 象 被 删除 时 ， 这 些 集合 属性 对 应 的 记录 将 被 自动 删除 。 假 设 集合 元 素 被 从 一 个 持久 化 对 象 传递 到 
另 一 个 持久 化 对 象 ， 该 集合 元 素 对 应 的 记录 会 从 一 个 表 转移 到 另 一 个 表 。 

两 个 持久 化 对 象 不 能 共享 同一 个 集合 元 素 的 引用 。 

集合 映射 的 元 素 大 致 有 如 下 这 些 。 

> list: 用 于 映射 List 集合 属性 。 

> ”set: 用 于 映射 Set 集合 属性 。 

> map: 用 于 映射 Map 集合 属性 。 

> array: 用 于 映射 数组 集合 属性 。 

> _rimitive-array: 专门 用 于 映射 基本 数据 类 型 的 数组 。 

> ”bag: 用 于 映射 无 序 集合 。 

> ”idbag: 用 于 映射 无 序 集合 ， 但 为 集合 增加 逻辑 次 序 。 

映射 集合 属性 时 通常 需要 指定 一 个 name 属性 ， 用 于 标明 该 集合 属性 的 名 称 。 除 此 之 外 ， 集 合 元 
素 大 致 有 如 下 可 选 属性 。 

> ”table: 指定 保存 集合 属性 的 表 名 。 如 果 没 有 指定 该 属性 ， 则 表 名 默认 与 集合 属性 同名 。 

> ”schema: 指定 保存 集合 属性 的 数据 表 的 Schema 的 名 称 ， 用 于 覆盖 在 根 元 素 中 定义 的 

schema 属性 。 

> ”lazy: 设置 是 否 启动 延迟 加 载 ， 该 属性 默认 是 true， 即 大 多 数 操作 不 会 初始 化 集合 类 〈 适 用 

于 非常 大 的 集合 ) 。 
> ， inverse: 指定 该 集合 关联 的 实体 在 双向 关联 关系 中 不 控制 关联 关系 。 
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> ”cascade: 指定 对 持久 化 对 象 的 持久 化 操作 (如 save、update、delete) 是 否 会 级 联 到 它 所 
关联 的 子 实体 。 


关于 关联 实体 级 联 操作 的 内 容 ， 后 面 还 会 有 更 详细 的 说 明 . | 
> order-by: 该 属性 用 于 设置 数据 库 对 集合 元 素 排序 , 该 属性 仅 对 1.4 或 更 高 版 本 的 JDK 有 效 。 
该 属性 的 值 为 指定 表 的 指定 字段 (一 个 或 几 个 ) 加 上 asc 或 者 desc 关键 字 ， 这 种 排序 是 数 
据 库 进行 SQL 查询 时 进行 排序 的 ， 而 不 是 直接 在 内 存 中 排序 。 
> sort， 指定 集合 的 排序 顺序 ， 可 以 为 自然 排序 ， 或 者 使 用 给 定 的 排序 类 进行 排序 。 
> ”where: 指定 任意 的 SQL 语句 中 where 条 件 ， 该 条 件 将 在 加 载 或 者 删除 集合 元 素 时 起 作用 ， 
只 有 满足 该 where 条 件 的 记录 才 会 被 操作 。 
> “batch-size: 定义 延迟 加 载 时 每 批 抓 取 集 合 元 素 的 数量 。 该 属性 默认 是 1。 
> ”access: 指定 Hibernate 访问 集合 属性 的 访问 策略 ， 默 认 是 property。 
> ”mutable: 指定 集合 中 的 元 素 是 否 可 变 ， 如 果 指 定 该 属 
性 为 false， 则 表明 该 集合 元 素 不 可 变 ， 在 某 些 情况 下 
可 以 进行 一 些小 的 性 能 优化 。 
因为 集合 属性 都 需要 保存 到 另 一 个 数据 表 中 , 所 以 保存 集合 
属性 的 数据 表 必 须 包 含 一 个 外 键 列 , 用 于 参照 到 主键 列 。 该 外 键 
列 通过 在 <set,.. 往 、<list../> 等 集合 元 素 中 使 用 <key.…. 人 > 子 元 素来 
映射 ， 如 图 5.20 所 示 。 
指定 <key.…. 亿 元 素 时 可 以 指定 如 下 可 选 选项 。 图 5.20 另 一 个 表 保存 集合 属性 
> column: 指定 外 键 字段 的 列 名。 
> ”on-delete: 指定 外 键 约束 是 否 打开 数据 库 级 别 的 级 联 删除 。 
> ”property-ref， 指 定 外 键 引用 的 字段 是 否 为 原 表 的 主键 。 
> ”not-nullt 指定 外 键 列 是 否 具有 非 空 约 束 ， 如 果 指 定 非 空 约束 ， 则 意味 着 无 论 何 时 ， 外 键 总 是 


主键 的 一 部 分 。 

update: 指定 外 键 列 是 否 可 更 新 ， 如 果 不 允许 更 新 ， 则 意味 着 无 论 何 时 ， 外 键 总 是 主键 的 一 
部 分 。 

> ”unique: 指定 外 键 列 是 否 具有 唯一 约束 ， 如 果 指 定 唯一 约束 ， 则 意味 着 无 论 何 时 ， 外 键 总 是 


v 


提示 
Fo 集合 元 素 是 基本 儿 据 类 型 、 字符 囊 类 型 、 日 期 类 型 或 其 他 复合 类 型 时 ， 因为 这 些 集 | 


岗 》 合 元 素 都 是 从 属于 持久 化 对 象 的 ， 所 以 <key.…. 人 > 元 素 的 not-null 属性 默认 为 tue。 但 对 于 单 | 
| 向 一 对 多 关联 来 说 ， 外 键 字 段 默认 是 可 以 为 空 的 ( 即 not-null 属性 默认 为 false )， 因 此 如 果 : 
应 用 需要 指定 该 外 刍 列 不 包 许 为 空 ， 则 需要 指明 not-null="true"。 | 


在 Java 的 所 有 集合 类 型 (包括 数组 、Map) 中 ， 只 有 Set 集合 是 无 序 的 ， 即 没 有 显 式 的 索引 值 。 
List、 数 组 使 用 整数 作为 集合 元 素 的 索引 值 ， 而 Map 则 使 用 key 作为 集合 元 素 的 索引 。 因 此 ， 在 所 有 
的 集合 映射 中 ， 除 了 <set.. 福 和 <bag.. 人 元素 外 ， 都 需要 为 集合 元 素 的 数据 表 指 定 一 个 索引 列 一 一 用 于 
保存 数组 索引 ， 或 者 List 的 索引 ， 或 者 Map 集合 的 key 索引 。 

用 于 映射 索引 列 的 元 素 有 如 下 几 个 。 

> <list-index.…/>: 用 于 映射 List 集合 、 数 组 的 索引 列 。 

> <map-key>: 用 于 映射 Map 集合 、 基 本 数据 类 型 的 索引 列 。 
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> ”<map-key-many-to-many>: 用 于 映射 Map 集合 、 实 体 引 用 类 型 的 索引 列 。 

> ”<composite-map-key>: 用 于 映射 Map 集合 、 复 合 数据 类 型 的 索引 列 。 

Hibernate 集合 元 素数 据 类 型 儿 乎 可 以 是 任意 数据 类 型 ， 包 括 基 本 类 型 、 字 符 串 、 日 期 、 自 定义 类 
型 、 复 合 类 型 以 及 对 其 他 持久 化 对 象 的 引用 。 如果 集合 元 素 是 基本 类 型 、 字 符 串 、 日 期 、 自 定义 类 型 、 
复合 类 型 等 ， 则 位 于 集合 中 的 对 象 可 能 根据 “ 值 ”语义 来 操作 (其 生命 周期 完全 依赖 于 集合 持 有 者 ， 
必须 通过 集合 持 有 者 来 访问 这 些 集合 元 素 ); 如 果 集 合 元 素 是 其 他 持久 化 对 象 的 引用 , 此 时 就 变 成 了 关 
联 映射 《下 一 章 将 会 重点 介绍 )， 那 么 这 些 集合 元 素 都 具有 自己 的 生命 周期 。 

综合 所 有 情形 ， 用 于 映射 集合 元 素 的 大 致 包括 如 下 几 种 元 素 。 

> ”<element../>: 当 集 合 元 素 是 基本 类 型 及 其 包装 类 、 字 符 串 类 型 和 日 期 类 型 时 使 用 该 元 素 。 

> ”<composite-element.../>: 当 集 合 元 素 是 复合 类 型 时 使 用 该 元 素 。 

> ”<one-to-many.../> 或 <many-to-many.../>: 当 集 合 元 素 是 其 他 持久 化 对 象 的 引用 时 使 用 它们 。 

也 就 是 说 ， 这 两 个 元 素 主要 用 于 进行 关联 关系 映射 。 

下 面 针对 不 同 集合 属性 具体 讲解 。 

5.6.4.1 “List 集合 属性 

List 是 有 序 集合 ， 因 此 持久 化 到 数据 库 时 也 必须 增加 一 列 来 表示 集合 元 素 的 次 序 。 看 下 面 的 持久 
化 类 ， 该 Person 类 有 一 个 集合 属性 :schools， 该 属性 对 应 多 个 学 校 。 

集合 属性 只 能 以 接口 声明 。 例 如 在 下 面 的 代码 中 ，schools 的 类 型 只 能 是 List， 不 能 是 ArrayList， 
但 该 集合 属性 必须 使 用 实现 类 完成 初始 化 。 

程序 清单 :codes\05\5.6\list\src\org\crazyit\app\domain\Person.java 

public class Person 

: // 标 识 属性 

private Integer id; 
7/ 普通 属性 name 


private String name; 


// 普 通 属性 age 

Private int age 

7/ 集合 属 性， 保留 该 对 象 关联 的 学 校 

EtEHa0> 0b6o15 = nn A AL 
// 省 略 id 属性 的 setter 和 getter 方法 


/7 省 略 name 属性 的 setter 和 getter 方法 


7/ 省 略 age 属性 的 setter 和 getter 方法 


1/ schools 属性 的 setter 和 getter 方法 
public void setSchools(List<string> schools) 
; this.schools = schools; 
上 外 List<String> getSchools () 
return this.schools; 
} 
} 


正如 上 面 的 Person 类 中 粗 体 字 代码 所 示 ， 虽 然 声明 schools 属性 时 使 用 了 List<String> 类 型 ， 但 程 
序 必须 显 式 地 初始 化 该 集合 属性 ， 否 则 程序 运行 时 会 抛 出 NullPointerException， 这 个 异常 与 Hibenate 
无 关 ， 只 是 当 程 序 向 该 List 集合 (Hibernate 没有 对 它 初始 化 ) 中 添加 属性 时 ， 如 果 该 属性 还 未 初始 化 
就 会 引发 NullPointerException 异常 

该 持久 化 类 的 标识 属性 、 普 通 属性 的 映射 与 前 面相 同 ， 不 同 的 是 增加 了 集合 属性 。 对 本 例 的 List 
集合 属性 ， 应 该 使 用 <list... 亿 元 素 完成 映射 。<list.. 人 元素 要 求 <listindex... 人 > 的 子 元 素来 映射 List 集合 
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的 索引 列 。 集 合 属性 的 值 不 可 能 与 持久 化 类 存储 在 同一 个 表 内 ， 集 合 属性 会 存放 在 另外 的 表 中 ， 因 此 
必须 以 外 键 关联 ， 所 以 需要 增加 <key.… 亿 元 素来 映射 该 外 键 列 。 

下 面 是 该 持久 化 类 的 映射 文件 。 

程序 清单 : codes\05\5.6\ist\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://wuw.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-~ 指定 主键 生成 器 策略 -> 
<generator class="identity"/> 


”type="string"/> 
type="int"/> 
-> 
<list name="schools" table="school"> 
< 上 !-- 映射 集合 属性 数据 表 的 外 键 列 -> 
<key column="personid" not-null="true"/> 
<!-- 映射 集合 属性 数据 表 的 集合 索引 列 了 
<list-index column="list_order"/; 
<!-- 映射 保存 集合 元 素 的 数据 列 -> 
<element type="string" column="school_name"/> 
</list> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 中 的 粗 体 字 代码 映射 了 List 集 合 属性 ， 因 为 集合 元 素 是 String 类 型 ， 所 以 集合 元 
素 使 用 <element.. 记 元 素 即 可 。 


上 面 的 Person 类 定义 List jt 属性 已 经 使 用 了 泛 型 来 限制 集合 元 素 的 类 型 ， 这 样 
Hibernate 可 以 通过 反射 来 取得 集合 元 素 的 数据 类 型 ， 因 此 定义 <element../> 元 素 时 无 须 
指定 type 属性 。 但 此 处 我 们 还 是 通过 <element.../> 元 素来 映射 集合 元 素 时 应 该 指定 一 个 
type 属性 ， 告 诉 Hibernate 集合 元 素 的 类 型 ， 这 样 就 避免 了 Hibernate 自己 去 识别 。<list- 
index.. 人 > 元 素 则 无 须 指定 type 属性 ， 因 为 Hibernate 可 以 确定 List 集合 的 索引 值 总 是 束 可 


数 类 型 的 。 


有 了 POJO， 也 有 了 映射 文件 ， 该 类 可 以 完成 持久 化 访问 了 。 用 于 完成 持久 化 访问 的 主 程序 片段 


如 下 。 
程序 清单 :codes\05\5.6\list\src\lee\PersonManagerjava 


// 创 建 并 保存 Person 对 象 
private void createAndstorePerson() 


{ 
// 打 开 线 程 安全 的 session 对 象 
Session session = HibernateUtil.currentSession(); 
// 打 开 事务 
Transaction tx = session.beginTransaction(); 
// 创 建 Person 对 象 
Person yeeku = new Person(); 
// 为 Person 对 象 设置 属性 
yeeku. setAge (29) 7 
yeeku. setName ("crazyit.org"); 
/7 创建 List 集合 
List<string> schools = new ArrayList<string>(); 
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schools.add ("小学"); 
schools .add ("中 学 "); 
// 设 置 List 集合 属性 
yeeku.setSchools (schools); 
session. save (yeeku); 
tx.commit()» 
HibernateUtil.closeSession(); 
} 


程序 运行 结束 后 , 数据 库 将 生成 两 个 表 , 其 中 person_inf 表 用 于 保存 持久 化 类 Person 的 基本 属性 ， 
而 school 要 将 用 于 内 灯 合 属性 Schools。 


提 a 
上 上 面 程序 用 到 了 HibemnateUtil 工具 类 ， 该 工具 类 的 currentSession() 方 法 返回 一 -个 线程 

安全 的 Session 对 象 . 关于 HibemateUtil 工具 类 的 实现 , 读者 可 查看 codes\05\5.6\list\src\lee ， 

| ”路 径 下 的 HibernateUtiljava 文件 . 


对 -个 持久 化 对 象 而 言 ， 它 所 包含 的 集合 元 素 的 索引 是 不 会 重复 的 ， 因 此 List 集合 属性 可 
以 用 关联 持久 化 对 象 的 外 键 和 集合 索引 列 作为 联合 主键 。 上 面 程序 得 到 的 school 数据 表 结构 如 图 
5.21 所 示 。 


Field Type 


person_id int(11) 
school _name varchar (255) 


图 5.21 保存 List 集合 元 素 的 数据 表 
5.6.4.2 ”数组 属性 


Hibemate 对 数组 和 List 的 处 理 方式 非常 相似 ， 实 际 上 ，List 和 数组 也 非常 像 ， 尤 其 是 JDK 1.5 增 
加 了 自动 装 箱 、 自 动 拆 箱 特性 之 后 ， 它 们 用 法 的 区 别 只 是 List 的 长 度 可 以 变化 ， 而 数组 的 长 度 不 可 变 
而 已 。 

将 上 面 的 示例 程序 的 List 属性 修改 为 字符 串 数组 ， 修 改 后 的 Person 代码 如 下 。 

程序 清单 :codes\05\5.6\array\src\org\crazyit\app\domain\Person.java 

public class Person 


{ 
// 标 识 属性 
private Integer id; 
// 普 通 属性 name 
private String name; 
// 普 通 属性 age 
private int age 
// 数 组 属性 ， 保 留 该 对 象 关联 的 学 校 
Private String[] schools; 
// 省 略 id 属性 的 setter 和 getter 方法 


/77 省 略 name 属性 的 setter 和 getter 方法 
/7/ 省 略 age 属性 的 setter 和 getter 方法 


//schools 属性 的 setter 和 getter 方法 
public void setSchoolstString[] schools}) 
{ 

this.schools = schools; 
} 
Public String[] getSchools() 
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{ 
return this.schools; 
上 
} 


对 本 例 的 数组 集合 属性 ， 应 该 使 用 <array... 人 > 元 素 完成 映射 ， 而 <array.… 人 > 元 素 的 子 元 素 、 属 性 等 与 
<list..… 记 元素 的 用 法 完全 一 样 。 下 面 是 该 持久 化 类 的 映射 文件 。 
程序 清单 : codes\05\5.6\array\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 映射 数组 属性 --> 
<array name="schools" table="school"> 
<!-- 映射 数组 属性 数据 表 的 外 键 列 --> 
<key column="person_id" not-null="true"/> 
<!-- 映射 数组 属性 数据 表 的 数组 索引 列 一 -> 
<list-index column="list_order"/> 
<!-- 映射 保存 数组 元 素 的 数据 列 --> 
<element type="string" column="school_name"/> 
</array> 
</class> 
</hibernate-mapping> 


上 面 的 粗 体 字 代码 与 前 面 映射 List 集合 时 的 粗 体 字 代码 几乎 完全 一 样 ， 区 别 只 是 把 原来 的 list 换 
成 了 array 而 已 。 由 此 可 见 ，Hibernate 对 List 和 数组 的 处 理 几 乎 完全 一 样 。 
5.6.4.3 Set 集合 属性 
Set 集合 属性 的 映射 与 List 有 点 不 同 ， 但 因为 Set 是 无 序 、 不 可 重复 的 集合 ， 因 此 <set.…/> 元 素 无 
须 使 用 <list-index.…/> 子 元 素来 映射 集合 元 素 的 案 引 列 。 
与 List 相同 的 是 ，Set 集合 同样 需要 使 用 <key.… 户 元 素 映射 外 键 列 ， 用 于 保证 持久 化 类 和 集合 属性 
的 关联 。Set 集合 属性 声明 时 ， 只 能 使 用 Set 接口 ， 不 能 使 用 实现 类 。 
将 上 面 示例 的 List 集合 属性 改 为 Set 集合 属性 ， 修 改 后 的 Person 类 代码 片段 如 下 。 
程序 清单 :codes\05\5.6\set\src\org\crazyit\app\domain\Person.java 
public class Person 
// 标 识 属性 
private Integer id; 
// 普 通 属性 name 


private String name; 

// 普 通 属性 age 

private int age 

// 集 合 属性 ， 保 留 该 对 象 关联 的 学 校 

private Set<string> schools = 
new Hashset<string>(); 

// 省 略 id 属性 的 setter 和 getter 方法 


/省略 name 属性 的 setter 和 getter 方 法 
/7 省 略 age 属性 的 setter 和 getter 方法 
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//schools 属性 的 setter 和 getter 方法 

public void setschools{Set<String> schools) 
: this.schools = schools; 

的 Set<string> getschools() 

: return this.schools; 


上 


} 
上 面 的 程序 中 的 schools 是 一 个 Set 集合 ， 因 此 应 该 使 用 <set... 人 > 元 素 进行 映射 ，<set,., 人 > 元 素 无 须 
使 用 <list-index.…/> 子 元 素 。 下 面 是 Set 集合 属性 的 映射 文件 。 
程序 清单 : codes\05\5.6\set\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 一 > 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 映射 Set 集合 属性 --> 
<set name="schools" table="school"> 
<!-- 映射 集合 属性 数据 表 的 外 键 列 一 -> 
<key column="person_id" not-null="true"/> 
映射 保存 集合 元 素 的 数据 列 , 增加 非 空 约束 -> 
<element type="string" column="school_name" 
not-null="true"/> 


</set> 
</class> 
</hibernate-mapping> 


在 上 面 的 映射 文件 中 ，<element... 户 元素 用 于 映射 集合 属性 里 的 每 个 元 素 ， 该 元 素 有 个 not-null 属 
性 ， 该 属性 默认 为 false， 即 该 列 默认 可 以 为 空 。 

定义 上 面 的 映射 后 ， 我 们 用 如 下 主 程序 来 保存 持久 化 实例 。 

程序 清单 : codes\05\5.6\set\src\lee\PersonManager.java 


private void createAndstorePerson() 
{ 


Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction{(); 
/1 创建 Person 对 象 

Person yeeku = new Person(); 

// 为 Person 对 象 设置 属性 

yeeku. setAge (29) 7 

yeeku. setName ("crazyit .org"); 

// 创 建 Set 集合 

Set<String> s = new HashSet<String>()7 
s.add ("小 学 "); 

s.add ("中 学 "); 

// 设 置 Set 集合 属性 

yeeku. setSchools (s); 

Session. save (yeeku) ; 

tx.commit (); 

HibernateUtil.closeSession(); 
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运行 上 面 的 程序 结束 后 ， 将 看 到 数据 库 中 school 数据 表 的 结构 如 图 5.22 所 示 。 


图 5.22 保存 Set 集合 元 素 的 数据 表 
对 比 List 和 Set 两 种 集合 属性 : List 集合 的 元 素 有 顺序 ， 而 Set 集合 的 元 素 没有 顺序 。 当 集合 属性 


在 另外 的 表 中 存储 时 ，List 集合 属性 可 以 用 关联 持久 化 类 的 外 键 列 和 集合 元 素 索引 列 作为 联合 主键 ， 
但 Set 集合 没有 索引 列 ， 则 以 关联 持久 化 类 的 外 键 和 元 素 列 作为 联合 主键 ， 前 提 是 元 素 列 不 能 为 空 。 


true" 属 性 ， 则 集合 属性 表 
以 关联 持久 化 类 的 外 刍 列 和 无 素 列 作为 联合 主 刍 ， 否则 该 表 没 有 主键 。 但 List 集合 属性 3 


的 表 总 是 以 外 键 列 和 元 素 索引 列 作为 联合 主键 


5.6.4.4 “bag 元 素 映射 

<bag.… 信 元 素 既 可 以 映射 List 集合 属性 ， 也 可 以 映射 Set 集合 属性 ， 甚 至 可 以 映射 Collection 集合 
属性 。 不 管 是 哪 种 集合 属性 ， 使 用 <bag.…/> 元 素 都 将 被 映射 成 无 序 集合 。 集 合 属性 对 应 的 表 没有 主键 。 

<bag.… 信 元 素 只 需要 <key.… 人 > 元 素来 映射 关联 的 外 键 列 , 而 使 用 <element../> 元 素来 映射 集合 属性 的 
元 素 列 。 

假设 有 如 下 持久 化 类 ， 该 持久 化 类 里 包含 了 一 个 Collection 集合 属性 。 

程序 清单 :，codes\05\5.6\bag\src\org\crazyit\app\domain\Person.java 

public class Person 


// 标 识 属性 

private Integer id; 

// 普 通 属性 name 

private String name; 

// 普 通 属性 age 

private int age7 

// 集 合 属性 ， 保 留 该 对 象 关联 的 学 校 

private ee schools = 
new ArrayList<string>(); 

// 省 略 id 属性 的 setter 和 getter 方法 


7// 省 用 name 属性 的 setter 和 getter 方法 
7/ 和 省略 age 属性 的 setter 和 getter 方法 


//schools 属性 的 setter 和 getter 方法 
public void setschools {Collection<string> schools) 
; this.schools = schools; 
pbae Collection<String> getschools() 
return this.schools; 
} 


上 面 的 集合 属性 既 不 是 List 集合 ,也 不 是 Set 集合 , 而 是 更 抽象 的 Collection 集合 , 那么 此 时 就 应 
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该 使 用 <bag... 信 元 素来 映射 该 集合 属性 了 。 使 用 <bag... 人 元素 的 映射 文件 代码 如 下 。 
程序 清单 : codes\05\5.6\bag\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app. domain"> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 -> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 使 用 bag 元 素 映射 集合 属性 --> 
<bag name="schools" table="school"> 
<!-- 映射 集合 属性 数据 表 的 外 键 列 --> 
<key column="person_id" not-null="true"/> 
<!-- 映射 保存 集合 元 素 的 数据 列 -> 
<element type="string" column="school_name" 
not-null="true"/> 


</bag> 
</class> 
</hibernate-mapping> 


用 于 保存 Person 的 主 程序 与 前 面 程序 没有 太 大 区 别 ， 此 处 不 再 袭 述 。 当 主 程序 保存 了 持久 化 对 象 
Person 之 后 ， 将 看 到 如 图 5.23 所 示 的 效果 。 

从 图 5.23 可 以 看 出 ， 当 使 用 <bag..> 元 素来 映射 集合 属性 时 ， 即 使 指定 保存 集合 元 素 的 数据 列 不 
能 为 null， 但 保存 集合 元 素 的 数据 表 依然 没有 主键 。 


person_id int (11) NO ML 
school name varchar(255) NO 


图 5.23 使 用 bag 元 素 映射 集合 属性 


5.6.4.5 ”Map 集合 属性 
Map 集合 属性 需要 使 用 <map.… 人 > 元素 进行 映射 , 当 配置 <map.… 信 元 素 时 也 需要 使 用 <key.…/> 子 元 素 
映射 外 键 列 。 除 此 之 外 ，Map 集合 属性 还 需要 映射 Map key。 映 射 Map 集合 key 的 元 素 比 较 多 ， 当 
Map 的 key 是 字符 串 类 型 、 日 期 类 型 时 ， 直 接 使 用 <map-key... 人 > 元 素来 映射 Map key 即 可 。 
Hibernate 将 以 外 键 列 和 key 列 作为 联合 主键 。 
与 所 有 集合 属性 类 似 的 是 ， 集 合 属性 的 声明 只 能 使 用 接口 ， 但 程序 依然 需要 显 式 初始 化 该 集合 属 
性 。 假 设 有 如 下 POJO 类 : 
程序 清单 : codes\05\5.6\map\src\org\crazyit\app\domain\Person.java 
Public class Person 
// 标 识 属性 
private Integer id; 
// 普 通 属性 name 
Private String name; 
// 普 通 属性 age 


private int age; 


// 集 合 属性 ， 保 留 该 对 象 关联 的 考试 成 绩 
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pet Map<String ,Float> scores 
new HashMap<String ,Float>(); 
/省 路 id 局 性 的 setter 和 gecter 方 法 


/7/ 省 略 name 属性 的 setter 和 getter 方法 
/7 省略 age 属性 的 setter 和 getter 方法 


//scores 属性 的 setter 和 getter 方法 
public void setScores (Map<String ,Float> scores) 
{ 


this,scores = scores; 


} 
public Map<String ,Float> getscores() 
{ 
return this.scores; 
} 
} 


上 面 Person 类 的 粗 体 字 代码 定义 了 一 个 scores 属性 ， 该 scores 属性 是 Map 类 型 的 属性 ， 为 了 映 
射 该 Map 类 型 的 集合 属性 ， 映 射 文件 中 使 用 <map.… 人 元素 即 可 。 下 面 是 该 映射 文件 的 代码 。 
程序 清单 : codes\05\5.6\map\src\org\crazyit\app\domain\Person.hbm.xml 
<?xml version="1.0" encoding="GBK"?> 
<!DoCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
://wuw,hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
pping package="org.crazyit.app.domain"> 
lass name="Person" table="person_inf"> 
<!-- 映射 标识 属性 一 > 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 -> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<! 一 映射 Map 集合 属性 --> 
<map name="scores" table="score"> 
<!-- 映射 集合 属性 数据 表 的 外 键 列 --> 
column="person_id" not-null="true"/> 
<!-- 映射 集合 属性 数据 表 的 Map key 列 -> 
<map-key column="subject" type="string"/> 
<!-~ 映射 保存 集合 元 素 的 数据 列 一 -> 
‘<element column="grade" type="float"/> 
</map> 
</class> 
</hibernate-mapping> 


上 面 映 射 文件 的 粗 体 字 代码 完成 了 Person 类 scores 属性 的 映射 ， 映 射 scores 属性 时 指定 了 

<map-key.. 户 和 <element.. 人 > 两 个 子 元 素 。 由 于 程序 定义 Person 类 时 没有 使 用 泛 型 来 限制 Map 集合 
以 Hibernate 无 法 通过 反射 获取 Map 集合 的 key 和 value 的 数据 类 型 ,所 以 映射 文件 在 配置 <map-key.…/> 
和 <element..…/> 时 必须 指定 type 属性 。 

本 示例 程序 的 主 程序 比较 简单 ， 此 处 不 再 给 出 ， 读 者 可 查看 codes\05\5.6\map\sre\lee 路 径 下 的 
PersonManagerjava 文件 了 解 如 何 保存 一 个 Person 对 象 。 

程序 运行 结束 后 ， 保 存 集合 属性 score 的 表 将 以 personid 列 和 subject 列 作为 联合 主键 ， 如 图 5.24 
所 示 。 


>>5.6.5 集合 属性 的 性 能 分 析 
当 系统 从 数据 库 中 初始 化 某 个 持久 化 类 时 ， 集 合 属性 是 否 随 持 久 化 类 一 起 初始 化 呢 ? 如 果 集合 属 
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性 里 包含 十 万 ， 甚 至 百 万 的 记录 ， 在 初始 化 持久 化 类 之 时 ， 完 成 所 有 集合 属性 的 抓 取 ， 将 导致 性 能 急 
剧 下 降 。 完 全 有 可 能 系统 只 需要 使 用 持久 化 类 集合 属性 中 的 部 分 记录 ， 而 完全 不 是 集合 属性 的 全 部 ， 
这 样 ， 没 有 必要 一 次 加 载 所 有 的 集合 属性 。 


Field Type Null Key Default Extra 


person_id | int(11) NO 
grade float YES 
subject varchar (255) | NO 


图 5.24 保存 Map 集合 属性 的 数据 表 


对 于 集合 属性 ， 通 常 推荐 使 用 延迟 加 载 策略 。 所 谓 延 迟 加 载 就 是 等 系统 需要 使 用 集合 属性 时 才 从 
数据 库 装 载 关 联 的 数据 。 

Hibernate 对 集合 属性 默认 采用 延迟 加 载 ， 在 某 些 特殊 的 情况 下 ， 为 <set../>、<list..…/>、<map.…/> 
等 元 素 设置 lazy="false" 属 性 来 取消 延迟 加 载 。 

根据 前 面 的 讲解 ， 可 将 集合 分 成 如 下 两 类 。 

> 有 序 集合 :集合 里 的 元 素 可 以 根据 key 或 index 访问 。 

> 无 序 集合 : 集合 里 的 元 素 只 能 遍历 。 

有 序 集合 都 拥有 一 个 由 外 键 列 和 集合 元 素 索引 列 组 成 的 联合 主键 ， 在 这 种 情况 下 ， 集 合 属性 的 更 
新 是 非常 高 效 的 一 一 主键 已 经 被 有 效 地 索引 , 因此 当 Hibernate 试图 更 新 或 删除 一 行 时 ， 可 以 迅速 找到 

而 无 序 集合 ， 例 如 Set 的 主键 由 <key... 伺 和 其 他 元 素 字 段 构成 ， 或 者 根本 没有 主键 。 如 果 集 合 中 元 
素 是 组 合 元 素 或 者 大 文本 、 大 二 进 制 字段 ， 数 据 库 可 能 无 法 有 效 地 对 复杂 的 主键 进行 索引 。 即 使 可 以 
建立 索引 ， 人 性 能 也 非常 差 。 

在 这 种 情况 下 ，<bag.… 人 > 映射 是 最 差 的 。 因 为 <bag.…/> 允 许 有 重复 的 元 素 值 ， 也 没有 索引 字段 ， 因 
此 不 可 能 定义 主键 。Hibernate 无 法 判断 重复 行 。 如 果 试 图 修改 这 种 集合 属性 时 ，Hibernate 先 删除 全 部 
集合 ， 然 后 重新 创建 整个 集合 ， 效 率 非 常 低 下 。 

显然 ， 有 序 集合 的 属性 在 增加 、 删 除 、 修 改 中 拥有 较 好 的 性 能 表现 。 

对 于 多 对 多 关联 、 值 数据 的 集合 而 言 ， 有 序 集合 类 比 Set 多 一 个 好 处 :因为 Set 集合 内 部 结构 的 
原因 ， 所 以 如 果 “ 改 变 ”Set 集合 的 某 个 元 素 ，Hibernate 并 不 会 立即 更 新 (update) 该 元 素 对 应 的 数据 
行 。 因 此 对 于 Set 集合 而 言 ， 只 有 在 执行 插入 〈insert) 和 删除 delete) 操作 时 “改变 ” 才 有 效 。 

不 过 需要 指出 的 是 : 虽然 数组 也 是 有 序 集 合 ， 但 数组 无 法 使 用 延迟 加 载 〈 因 为 数组 的 长 度 不 可 
变 )， 所 以 实际 上 用 数组 作为 集合 的 性 能 并 不 高 ， 通 常 我 们 认为 List、Map 集合 性 能 较 高 ， 而 Set 则 
紧 随 其 后 。 

在 Hibernate 中 ，Set 应 该 是 最 通用 的 集合 类 型 ， 这 是 因为 “Set 集合 ”的 语义 最 贴近 关系 模型 的 关 
联 关系 ， 因 此 Hibernate 的 关联 映射 都 是 采用 <set.. 信 元素 (也 可 用 <bag.… 人 > 元 素 ) 映射 的 。 而 且 ， 在 设 
计 和 良好 的 Hibernate 领域 模型 中 ，1 一 N 关联 的 1 的 一 端 通常 带 有 inverse="tmue"， 对 于 这 种 关联 映射 ，1 
的 一 端 不 再 控制 关联 关系 ， 所 有 更 新 操作 将 会 在 N 的 一 端 进行 处 理 ， 对 于 这 种 情况 ， 无 须 考虑 其 集合 
的 更 新 性 能 。 

- 旦 我 们 指定 了 inverse="true" 属 性 ， 则 表明 该 集合 映射 作为 反 向 集合 使 用 ， 此 时 1 的 一 端 将 不 再 
控制 关联 关系 。 在 这 种 情况 下 ， 使 用 <list.. 人 > 和 <bag.…. 人 映射 属性 将 有 较 好 的 性 能 ， 因 为 我 们 可 以 在 未 
初始 化 集合 元 素 的 情况 下 直接 向 bag 或 list 添加 新 元 素 ! 因为 Collection.add0 和 Collection.addAll0 方 
法 、 以 及 Listadd0 和 ListaddAlI0 方 法 总 是 返回 tue。 
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但 Set 集合 不 同 , Set 集合 需要 保证 集合 元 素 不 能 重复 , 因此 当 程序 试图 向 Set 集合 中 添加 元 素 时 ， 
Set 集合 需要 先 加 载 所 有 集合 元 素 ， 再 依次 比较 添加 的 新 元 素 是 否 重复 ， 最 后 才 可 以 决定 是 否 能 成 功 
添加 新 元 素 ， 所 以 向 Set 集合 中 添加 元 素 时 性 能 较 低 。 

当 我 们 试图 删除 集合 的 全 部 元 素 时 ，Hibernate 是 比较 智能 的 。 例 如 ， 我 们 调用 List 集合 的 clear() 
方法 删除 全 部 集合 元 素 ，Hibernate 不 会 逐个 地 删除 集合 元 素 ， 而 是 使 用 一 个 delete 语句 就 搞定 了 。 

但 如 果 我 们 不 是 删除 全 部 集合 元 素 , 而 是 删除 绝 大 部 分 集合 元 素 , 例如 对 一 个 长 度 为 20 的 集合 类 ， 
如 果 我 们 要 删除 其 中 19 个 集合 元 素 ， 只 剩 下 一 个 集 全 元素， 那么 Hibernate 如 何 处 理 昵 ? Hibernate 没 
有 我 们 期 望 的 那么 智能 ， 先 调用 一 条 delete 语句 删除 全 部 集合 元 素 ， 再 调用 insert 添加 一 条 记录 。 
Hibernate 将 会 逐个 地 删除 19 个 集合 元 素 一 一 这 将 产生 19 条 delete 语句 。 

这 时 候 我 们 需要 一 点 小 小 的 技巧 ， 就 可 强制 Hibernate 先 执行 一 条 delete 语句 删除 全 部 集合 元 素 ， 
再 执行 一 条 insert 语句 插入 希望 剩 下 的 集合 元 素 。 例 如 如 下 代码 片段 : 

List tmp = person.getSchools()7 

// 强 制 person 的 schools 集合 属性 为 null 

//Hibernate 将 调用 delete 语句 删除 person 关联 的 全 部 集合 元 素 

person.setSchools (nul1) ; 


// 此 处 采用 循环 方式 删除 tmp 集合 中 的 19 个 元 素 , 
/但 此 时 的 tmp 集合 与 person 实体 无 关 ， 因 此 不 会 产生 delete 语句 


/7 再 次 将 tmp 集合 设置 成 person 的 schools 属性 
//Hibernate 将 只 需 一 条 insert 语句 即 可 插入 希望 利 下 的 记录 
person ,setSchools(tmp) 


集合 属性 表 里 的 记录 完全 “从 属 ” 于 主 表 的 实体 ， 当 主 表 的 记录 被 删除 时 ， 集 合 属性 表 里 “ 从 属 ” 
于 该 记录 的 数据 将 会 被 删除 ，Hibernate 无 法 直接 加 载 、 查 询 集合 属性 表 中 的 记录 ， 只 能 先 加载 主 表 实 
体 ， 再 通过 主 表 实体 去 获取 集合 属性 对 应 的 记录 。 


5.6.6 有 序 集 合 映射 


Hibernate 还 支持 使 用 SortedSet 和 SortedMap 两 个 有 序 集合 ， 当 我 们 需要 映射 这 种 有 序 集合 时 ， 
应 该 为 <map.… 户 元 素 或 <set.…/> 元 素 指 定 sort 属性 ， 该 属性 值 可 以 是 如 下 三 个 值 。 
> ”unsorted: 映射 有 序 集 合 时 不 排序 。 
> natural， 映射 有 序 集合 时 使 用 自然 排序 。 
> java.utiComparator 实现 类 的 类 名 : 使 用 排序 器 对 有 序 集合 元 素 进行 定制 排序 。 
Hibernate 的 有 序 集合 的 行为 与 java.util.TreeSet 或 java.util.TreeMap 的 行为 非常 相似 。 
下 面 以 SortedSet 为 例 ， 介 绍 Hibernate 有 序 集合 映射 的 用 法 。 假 设 程序 中 有 如 下 持久 化 类 ， 该 持 
久 化 类 里 包含 了 一 个 类 型 为 SortedSet 的 集合 属性 。 
程序 清单 : codes\05\5.6\SortedSet\src\org\crazyit\app\domain\Person.java 
Public class Person 
// 标 识 属性 
private Integer id; 
// 普 通 属性 name 
private String name; 
// 普 通 属性 age 
private int age; 
// 有 序 集合 属性 ， 保 留 该 对 象 参与 的 培训 
Private Sortedset<string> 


= new TreeSet<String>() 7 
// 省 略 id 属性 的 setter 和 getter 方法 


77 省 略 name 属性 的 setter 和 getter 方法 
/7 省略 age 属性 的 setter 和 getter 方法 


409 


http://52pdf.taobao.com 
米 野 雏 Java EE 企业 应 用 实战 (第 3 版 ) 


//trainings 属性 的 setter 和 getter 方 法 
public void setTrainings (SortedSet<String> trainings) 
this.trainings = trainings; 
ti SortedSet<String> getTrainings() 
Ee return this.trainings; 
} 
上 


上 面 的 持久 化 类 中 包含 了 一 个 SortedSet 的 集合 属性 ， 因 此 映射 文件 在 配置 映射 该 属性 时 应 增加 
sort 属性 ， 本 程序 打算 使 用 自然 排序 ， 故 指定 sort="natural" 即 可 。 下 面 是 该 持久 化 类 对 应 的 映射 文件 。 
程序 清单 ，codes\05\5.6\SortedSet\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-~ 映射 标识 属性 一 > 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 一 > 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 映射 SortedSet 集合 属性 , 使 用 自然 排序 
增加 sort="natural" 定 义 --> 
<set name="trainings" table="training" 
sort="natural"> 
<!-- 映射 集合 属性 数据 表 的 外 键 列 --> 
column="person_id" not-null="true"/> 
<!-- 映射 保存 集合 元 素 的 数据 列 , 增加 非 空 约束 -> 
<element type="string" column="training_name" 
not-null="true"/> 
</set> 
</class> 
</hibernate-mapping> 


增加 了 上 面 映射 文件 后 ， 我 们 使 用 如 下 主 程序 来 添加 Person 对 象 。 
程序 清单 :codes\05\5.6\map\src\lee\PersonManagerjava 


private void createAndstorePerson() 
{ 

Session session = HibernateUtil.currentSession(); 

Transaction tx = session.beginTransaction()7 

// 创 建 Person 对 象 

Person wawa = new Person(); 

// 为 Person 对象 设 置 属 性 

wawa. setAge (21) 7 

wawa. setName ("crazyit .org"); 

// 创 建 Set 集合 

SortedSet<String> s = new TreeSet<String>()7 

s.add("Wild Java Camp"); 

s.add("Sun SCJP") 7 

// 设 置 Set 集合 属性 

wawa. setTrainings (s); 

session. save (wawa); 

tx.commit (); 

HibernateUtil.closeSession(); 
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人 


上 面 的 程序 向 trainings 集合 属性 先 添加 的 是 “Wild Java Camp” 字 符 串 ， 后 添加 的 是 “Sun SCJP” 
字符 串 ， 但 因为 程序 指定 了 该 集合 是 有 序 集合 ， 所 以 Sun SCJP 将 排 在 前 面 。 当 我 们 使 用 程序 保存 了 
Person 对 象 之 后 ， 将 看 到 数据 库 中 training 数据 表 的 数据 如 图 5.25 所 示 。 

接 下 来 , 我 们 将 hibernate.cfe.xml 文件 中 的 hbm2ddl.auto 属性 修改 为 update, 这 可 保证 后 面 操作 不 
会 重建 数据 表 ， 这 样 就 可 以 为 原来 的 Person 对 象 的 trainings 属性 增加 元 素 了 。 为 trainings 集合 属性 添 
加 元 素 代码 片段 如 下 : 


Person p = (Person)session.get (Person.class , 1); 
P.getTrainings() .add ("CCNP"); 


上 面 粗 体 字 代码 修改 持久 化 状态 的 Person 对 象 ， 所 以 无 须 显 式 使 用 save0 方 法 来 保存 程序 所 做 的 
修改 。 运 行 上 面 两 行 代码 所 在 的 程序 ， 将 看 到 training 数据 表 中 又 新 增 了 一 条 记录 ， 而 且 3 条 记录 之 
间 处 于 有 序 状态 ， 如 图 5.26 所 示 。 


person_id 


training_name 


Sun SCJP 
Java Camp 


图 5.25 training 数据 表 的 数据 图 5.26 映射 SortedSet 有 序 集合 


从 图 5.26 可 以 看 出 : 即使 我 们 后 来 为 Person 的 trainings 集合 属性 添加 了 一 个 字符 串 , 新 增 的 字符 
串 “CCNP” 又 将 排 在 最 前 面 ， 这 就 是 Hibernate 对 有 序 集合 的 支持 。 

如 果 希 望 数据 库 查 询 自己 对 集合 元 素 排序 ， 则 可 以 利用 <set.. 人 >、<bag.…/> 或 者 <map.…/> 元 素 的 
order-by 属性 ， 该 属性 只 能 在 1.4 或 者 更 高 版 本 的 JDK (因为 底层 需要 利用 LinkedHashSet 或 
LinkedHashMap 来 实现 ) 中 有 效 ， 它 会 在 SQL 查询 中 完成 排序 ， 而 不 是 在 内 存 中 完成 排序 。 

例如 有 如 下 配置 片段 。 

程序 清单 : codes\05\5.6\order-by\src\org\crazyit\app\domain\Person.hbm.xml 


<!-- 映射 Set 集合 属性 ， 指 定 在 内 存 中 排序 --> 
<set name="trainings" table="training" 


order-by="training desc"> 
<!-- 映射 集合 属性 数据 表 的 外 键 列 -> 
column="person_id” not-null="t. 
!-- 映射 保存 集合 元 素 的 数据 列 , 增加 非 空 约束 -> 
‘<element type="string" columh="training" 
not-null="true"/> 


</set> 
上 面 的 映射 文件 中 粗 体 字 代 码 的 order-by 属性 指定 了 一 个 SQL 排序 子 句 ， 这 意味 着 当 程序 通过 
Person 实体 获取 trainings 集合 属性 时 ， 所 生成 的 SQL 语句 总 会 添加 order by training desc 子 句 。 


>》>5.6.7 映射 数据 库 对 象 


有 时 候 我 们 希望 在 映射 文件 中 创建 和 删除 触发 器 、 存 储 过 程 等 数据 库 对 象 ，Hibernate 提供 了 
<database-object,.. 人 > 元 素来 满足 这 种 需求 。 
借助 于 Hibernate 的 Schema 交互 工具 ， 这 样 就 可 让 Hibernate 映射 文件 拥有 完全 定义 用 户 Schema 
的 能 力 。 
使 用 <database-object... 人 > 元 素 只 有 如 下 两 种 形式 。 
> 第 一 种 形式 是 在 映射 文件 中 显 式 声 明 create 和 drop 命令 : 
<hibernate-mapping> 
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<database-object> 
<create>create trigger t_full content gen ...</create> 
<drop> create trigger t_full content_gen </drop> 
</database-object> 
</hibernate-mapping> 
在 上 面 的 <create.… 人 > 元 素 里 的 内 容 就 是 一 个 完整 的 DDL 语句 ， 用 于 创建 一 个 触发 器 ， 而 <drop… 人 > 
元 素 义 了 删除 指定 数据 库 对 象 的 DDL， 每 个 <database-object.. 人 > 元 素 中 只 有 一 组 <create.…/>、 
<drop..…/> 对 。 
> 第 二 种 形式 是 提供 一 个 类 ， 这 个 类 知道 如 何 组 织 create 和 drop 命令 。 这 个 特别 类 必须 实现 
org.hibernate.mapping.AuxiliaryDatabaseObject 接口 。 


<hibernate-mapping> 


<database-object> 
<definition class="MyTriggerDefinition"/> 
</database-object> 
</hibernate-mapping> 


如 果 我 们 想 指定 某 些 数据 库 对 象 仅 在 特定 的 方言 中 才 可 使 用 , 还 可 在 <database-object.. 人 > 元 素 里 使 
用 <dialect-scope.…/> 子 元 素来 进行 配置 。 配 置 片 段 代码 如 下 : 


<hibernate-mapping> 


<database-object> 
<create>create trigger t_full_content_gen ...</create> 
<drop> create trigger t_full_content_gen </drop> 
<!-- 指定 仅 对 MySQL 数据 库 有 效 --> 
<dialect-scope name="org.hibernate.dialect.MySQLDialect"/> 
<dialect-scope name="org.hibernate.dialect.MySQLInnoDBDialect"/> 
</database-object> 
</hibernate-mapping> 


虽然 上 面 有 示例 的 代码 片段 都 示范 了 如 何 创建 、 删 除 触发 器 ， 但 实际 上 所 有 可 以 在 
java.sql.Statement.execute() 方 法 中 执行 的 SQL 语句 都 可 以 在 此 使 用 。 例 如 ， 下 面 的 配置 文件 将 利用 
Hibernate 映射 文件 来 创建 一 个 数据 表 。 下 面 是 映射 文件 。 

程序 清单 :codes\05\5.6\data-object\src\org\crazyitiapp\domain\News.hbm.xml 


<?xml version="1.0" encoding="gb2312"?> 
<!-- 指定 Hiberante3 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- hibernate-mapping 是 映射 文件 的 根 元 素 --> 
<hibernate-mapping> 
<!-- 使 用 data-object 元 素 定义 数据 库 对 象 -> 
<database-object> 
<!-- 定义 创建 数据 库 对 象 的 语句 --> 
<create>create table test(t_name varchar(255)) ;</create> 
<!-- 让 drop 元 素 为 空 ， 不 删除 任何 对 象 -> 
<drop></drop> 
<!- 指定 仅 对 MySQL 数据 库 有 效 -> 
<dialect-scope name="org.hibernate.dialect.MySQLDialect"/> 
<dialect-scope nane="org.hibernate.dialect.MySQLInnoDBDialect"/> 
</database-object> 
</hibernate-mapping> 


该 映射 文件 甚至 没有 映射 任何 的 持久 化 类 , 只 是 在 粗 体 字 代码 部 分 使 用 <database-object.. 人 > 元 素 创 
建 了 一 个 简单 的 数据 表 。 为 了 让 该 映射 文件 所 定义 的 <database-object.. 人 元素 生 效 ， 主 程序 只 需 如 下 两 
行 即 可 。 
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和 


程序 清单 : codes\05\5.6\data-object\src\lee\WNewsManagerjava 


// 实 例 化 configuration， 这 行 代码 默认 加 载 hibernate.cfg.xml 文件 
Configuration conf = new Configuration{) -configure()7 
// 以 configuration 创 建 SessionFactory 

SessionFactory sf = conf.buildsessionFactory(); 


从 上 面 的 主 程序 代码 来 看 ， 系 统 将 在 创建 SessionFactory 对 象 时 生成 映射 文件 所 对 应 的 数据 库 对 
象 。 运 行 上 面 两 行 代码 ， 将 看 到 hibernate 数据 库 里 多 了 一 个 简单 的 数据 表 : test。 
人 


为 了 让 Hibernate 根据 <database-object. . 户 元 来 创建 禾 据 表 ， 一 定 要 将 Hibernate 配置 


文件 里 的 hbbm2ddlauto to 属性 值 修改 成 Create. 


实际 上 ， 如 果 我 们 仅仅 为 了 根据 映射 文件 来 生成 数据 库 对 象 ， 则 可 以 利用 Hiberate 提供 的 
SchemaExport 工具 ， 该 工具 可 根据 映射 文件 来 生成 数据 库 对 象 。 我 们 可 以 将 程序 该 为 如 下 形式 。 
程序 清单 :codes\05\5.6\data-object\src\lee\NewsManagerjava 
// 实 例 化 Configuration， 这 行 代码 默认 加 载 hibernate.cfg.xml 文件 
Configuration conf = new Configuration().configure(); 
se = new SchemaExport (conf); 

se.setFormat (true) 

// 设 置 保存 SQL 脚本 的 文件 名 

.setOutputPile ("new. sql") 

// 输 出 SQL 脚本 ， 并 执行 SQL 脚本 

.Create (true，true) 7 


执行 上 面 的 程序 , 将 会 看 到 程序 生成 了 一 个 new.sql 文件 , 该 文件 里 保存 了 创建 test 数据 表 的 SQL 


提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
六 如 果 使 用 上 面 的 程序 来 根据 *.hbm.xml 文件 生成 数据 库 对 象 ， 则 无 须 将 hbm2ddl.auto 、 
属性 值 修改 成 create， 使 用 update 也 行 。 | 
SchemaExport 工具 类 的 用 途 很 丰富 , 读者 可 参考 API 文档 来 了 解 各 方法 的 功能 和 意义 。 除 此 之 外 ， 


该 工具 类 甚至 提供 了 一 个 public static void main(String[] args) 方 法 ， 也 就 是 说 ， 可 直接 使 用 java 命令 来 
解释 、 执 行 该 工具 类 ， 命 令 格式 如 下 : 


java -cp _ hibernate_classpaths org.hibernate.tool.hbm2ddl.SchemaExport 
options mapping_files 


使 用 该 命令 的 效果 与 直接 在 程序 中 利用 SchemaExport 对 象 的 效果 完全 一 样 , 使 用 该 命令 时 可 传 入 


如 表 5.2 所 示 的 选项 。 
表 5.2 执行 SchemaExport 工具 的 选项 
选 ”项 说 了 明 
~quiet 禁止 把 SQL 脚本 输出 到 标准 输出 | 
~drop 只 执行 drop tables 的 操作 


只 执行 create tables 的 操作 


仅 生 成 SQL 脚本 ， 不 生成 实际 数据 库 对 象 


-output=newsql 


将 生成 的 SQL 脚本 保存 到 newsql 文件 中 


config=—my.cfe-xml 


指定 使 用 自 定义 的 Hibemate 配置 文件 (XML 文件 格式 ) 


~properties—my.properties 


定 使 用 自 定义 的 Hibemate 配置 文件 属性 文件 格式 ) 


format 


输出 格式 良好 的 SQL 完 本 


~delimiter=; 


设置 SQL 脚本 使 用 指定 的 行 结束 符 ， 默 认 是 英文 分 号 (:) 
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5.7 ”映射 组 件 属性 


组 件 属性 的 意思 是 : 持久 化 类 的 属性 并 不 是 基本 数据 类 型 ， 也 不 是 字符 串 、 日 期 等 标量 类 型 的 变 
量 ， 而 是 一 个 复合 类 型 的 对 象 ， 在 持久 化 的 过 程 中 ， 它 仅仅 被 当做 值 类 型 ， 而 并 非 引 用 另 一 个 持久 化 


实体 。 


组 件 属性 的 类 型 可 以 是 任何 自 定义 类 。 看 下 面 POJO 的 源 代码 。 
程序 清单 : codes\05\5.7\component\src\org\crazyitapp\domain\Person.java 


public class Person 


和 


// 标 识 属性 

private Integer id; 

// 普 通 属性 age 

private int age; 

// 组 件 属性 name 

private Name name; 

// 省 略 id 属性 的 setter 和 getter 方法 


/7 省 略 age 属性 的 setter 和 getter 方法 
//name 属性 的 setter 和 getter 方法 


public void setName (Name name) 
人 this.name = namey 

publie Name getName () 

return this.name; 


} 


Person 的 name 属性 既 不 是 基本 数据 类 型 ， 也 不 是 String， 而 是 一 个 自 定义 类 
Name 类 的 代码 。 
程序 清单 ，codes\05\5.7\component\src\org\crazyit\app\domain\Name.java 


public class Name 
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// 定 义 first 属性 
private String first; 

// 定 义 last 属性 

private String last; 

// 引 用 拥有 该 Name 的 Person 对 象 
Private Person owner; 

// 无 参数 的 构造 器 

public Name() 

{ 


} 
// 初 始 化 first、last 属性 的 构造 器 
public Name (String first ，String last) 
{ 
this.first = first; 
this.last = last; 


} 
// 省 略 first 属性 的 setter 和 getter 方法 
/77 省 略 last 属性 的 setter 和 getter 方 法 


//owner 属性 的 setter 和 getter 方法 
public void setOwner (Person owner) 
{ 

this.owner = owner; 
} 
public Person getOwner() 


: Name。 


下 面 是 该 
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a 
return this.owner; 
} 
上 


显然 ， 一 个 普通 的 数据 列 无 法 存储 Name 对 象 ， 因 此 我 们 不 能 直接 使 用 <property.… 亿 元 素来 映射 
name 属性 。 除 此 之 外 ， 上 面 的 Name 类 中 包含 一 个 owner 属性 ， 该 owner 属性 指向 包含 该 Name 属性 
的 容器 实体 (也 就 是 Person 对 象 )。 

为 了 映射 组 件 属性 ，Hibernate 提供 了 <component... 户 元素， 每 个 <component.../> 元 素 映射 一 个 组 件 
属性 。 使 用 <component.. 人 元 素 映射 组 件 属性 时 需要 指定 一 个 name 属性 , 用 于 指定 该 组 件 属性 的 名 称 。 
除 此 之 外 ， 使 用 <component.. 人 > 元 素 还 需要 如 下 几 个 可 选 属 性 。 

> class: 指定 组 件 类 的 类 名 。 如 果 不 指定 该 属性 ，Hibernate 将 通过 反射 来 得 到 该 组 件 的 类 型 。 

> insert: 指定 被 映射 的 字段 是 否 出 现在 SQL 的 insert 语句 中 。 
> update: 指定 被 映射 的 字段 是 否 出 现在 SQL 的 update 语句 中 。 
> access : 指定 Hibernate 访问 该 组 件 属性 的 访问 策略 ， 默 认 是 property。 
> lazy: 设置 该 组 件 是 否 在 持久 化 对 象 第 一 次 被 访问 时 启用 延迟 加 载 ， 该 属性 默认 是 true。 
> ”optimistic-lock: 设置 更 新 该 组 件 属性 是 否 需要 获取 乐观 锁 ， 如 果 该 属性 设置 为 true， 则 当 修 
属性 时 ， 持 久 化 对 象 的 版 本 号 会 增加 。 
: 指定 是 否 在 该 组 件 映 射 的 所 有 字段 上 添加 唯一 性 约束 。 
类 通常 还 包括 其 他 属性 ， 因 此 还 应 该 为 <component... 人 > 元 素 增加 <property.…/> 子 元 素来 
映射 组 件 属性 的 子 属性 。 此 处 的 <property.…/> 子 元 素 与 <class.…/> 元 素 里 <property../> 子 元 素 的 用 宰 可 
相似 ， 因 此 当 组 件 类 型 的 属性 是 基本 数据 类 型 、String 类 型 、 日 期 类 型 时 ， 使 用 <property.. 人 > 元素 进 行 
映射 。 
除 此 之 外 ,还 可 在 <component.…/> 元 素 内 插入 一 个 <parent.…/> 子 元 素 ， 用 于 映射 组 件 类 内 一 个 指向 
其 容器 实体 的 引用 。 定 义 <parent.../> 子 元 素 时 只 需 一 个 name 属性 ， 其 值 为 引用 容器 实体 的 属性 名 。 除 
此 之 外 ，<component,.. 人 > 元 素 内 还 可 出 现 如 下 几 种 子 元 素 。 
> ”<component..…/>:; 如 果 该 组 件 属性 里 的 属性 不 是 基本 类 型 、String 类 型 、 日 期 类 型 等 ， 而 是 
另 一 个 组 件 类 型 时 ， 则 在 <component.../> 里 再 次 使 用 <component..…/> 子 元 素 进行 映射 。 

> ”集合 映射 元 素 : 如 果 组 件 类 型 里 的 属性 是 数组 类 型 、 集 合 类 型 等 ， 则 可 以 在 <component..…/> 
里 使 用 <set.…./> 、<list../>、<map.…/> 等 子 元 素来 映射 这 些 集合 属性 。 

> 关联 映射 元 素 : 如 果 组 件 属性 里 的 属性 是 另外 一 个 持久 化 实例 的 引用 ， 还 可 以 在 
<component.../> 里 使 用 <many-to-one../>、<one-to-one.../> 等 子 元 素 ， 这 就 变 成 Hibernate 
关联 映射 的 一 种 特例 了 。 

下 面 是 上 面 持久 化 类 的 映射 文件 。 

程序 清单 :codes\05\5.7\component\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 


"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app. domain"> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 一 > 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 一 > 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 -> 
<property name="age" type="int"/> 
<!-- 映射 组 件 属性 name， 组 件 属性 的 类 型 为 Name --> 
<component name="name" 
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class="Name" unique="true"> 
<!-- 指定 owner 人 RS 
<parent name="owner"/> 
<!-- 映射 组 件 属性 的 first 属性 --> 
<property name="first"/> 
<!-- 映射 组 件 属性 的 last 属性 --> 
<property name="last"/> 
</component> 
</class> 
</hibernate-mapping> 


映射 文件 中 的 component 还 有 unique="true" 属 性 ,这 并 不 是 必需 的 , 而 是 与 具体 的 业务 逻辑 关联 。 
经 过 上 面 映射 后 ,我 们 就 可 以 利用 该 持久 化 类 将 Person 对 象 保存 到 数据 库 中 了 。 使 用 如 下 程序 片段 来 
保存 一 个 Person 对 象 。 

程序 清单 : codes\05\5.7\component\src\lee\PersonManagerjava 


private void createAndstorePerson() 
{ 
Session session = HibernateUtil.currentSession(); 
Transaction tx = Session.beginTransaction()7 
// 创 建 Person 对 象 
Person yeeku = new Person(); 
// 为 Person 对 象 设置 属性 
yeeku. setAge (29); 
Name n = new Name ("crazyit.org"”，" 妆 狂 Java 联盟 "); 
Yoeku. setName ( 
session, save (yeeku); 
tx.commit (); 
HibernateUtil.closeSession(); 


} 

对 于 这 种 只 包含 基本 类 型 、 字 符 串 、 日 期 类 型 等 属性 的 组 件 ，Hibernate 将 会 把 每 个 属性 映射 成 一 
个 数据 列 即 <component..…/> 元 素 里 每 个 <property.…/> 子 元 素 映 射 一 个 数据 列 。 上 面 程序 运行 结束 
后 ， 将 看 到 底层 生成 如 图 5.27 所 示 的 数据 表 。 


* from persoi 


图 5.27 组 件 属性 映射 多 个 数据 


从 图 5.27 可 以 看 出 ， 对 于 只 包含 普通 标量 属性 的 组 件 类 型 而 言 ，Hibernate 的 处 理 策略 非常 简单 : 
组 件 里 每 个 属性 映射 一 个 数据 列 即 可 。 


>>5.7.1 组 件 属性 为 集合 


如 果 组 件 类 再 次 包括 了 List、Set、Map 等 集合 属性 ， 则 我 们 可 以 在 <component,../> 元 素 里 使 用 
<list.. 户 、<set.. 人 和 <map.… 人 > 子 元 素来 映射 这 些 集合 属性 。 

假设 我 们 现在 为 上 面 的 Name 增加 一 个 属性 power (用 于 从 各 方面 衡量 这 个 名 字 的 好 坏 ， 仅 作 娱 
乐 而 已 )， 该 power 属性 的 类 型 是 Map。 下 面 是 Name 类 的 代码 。 

程序 清单 : codes\05\5.7\component-map\src\org\crazyit\app\domain\Namejava 
人 public class Name 

、 1/ 定义 first 属性 
private String first; 


// 定 义 last 属性 
Private String last; 
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半生 


// 引 用 拥有 该 Name 的 Person 对 象 

Private Person owner; 

private Map<String ,Integer> Power = new HashMap<string ,Integer>(); 
// 省 略 first 属性 的 setter 和 getter 方法 


7/ 和 省略 1ast 属性 的 setter 和 getter 方 法 
7 wner 属性 的 setter 和 getter 方法 


public void setOwner{Person owner) 
{ 


this.owner = owner; 
} 
Public Person getOwner() 
{ 

return this.owner; 


} 
//power 属性 的 setter 和 getter 方法 
public void setPower (Map<String ,Integer> power) 
{ 
this.power = power; 
} 
public Map<string, Integer> getPower() 
{ 


return this.power; 
} 


上 面 的 Name 组 件 类 多 了 一 个 Map 类 型 的 属性 : power， 持 有 该 组 件 的 持久 化 实体 Person 类 依然 
没有 任何 改变 ， 此 处 不 再 给 出 。 
为 了 映射 Name 中 的 Map 属性 ， 只 需 在 <component... 人 > 元 素 里 增加 <map.… 人 > 子 元 素 。 下 面 是 映射 
Person 持久 化 类 的 映射 文件 。 
程序 清单 :codes\05\5.7\component-map\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
“http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
pping package="org.crazyit.app.domain"> 
name="Person" table="person_inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-~ 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 一 > 
<property name="age" type="int"/> 
<!-- 映射 组 件 属性 mame， 组 件 属性 的 类 型 为 Name --> 
<component name="name" 
class="Name" unique="true"> 
<!-- 指定 owner 属性 代表 容器 实体 --> 
<parent name="owner"/> 
<!-- 映射 组 件 属性 的 first 属性 --> 
<property name="first"/> 
<!-- 映射 组 件 属性 的 last 属性 --> 
<property name="last"/> 
<!-~ 映射 组 件 属性 里 的 Map 集合 属性 --> 
<map name="power" table="name_power"> 
丑 关 沫 全 局 入 数据 家 相 外 名 Lp 
umn="person_name_id" not-null="true"/> 
< TT Map key 列 --> 


<map-key col name_aspect" type="string"/> 
<!-- 映射 保存 集合 元 素 的 数据 列 --> 
<element column="name_power" type="int"/> 
-~ </map> 
</component> 
</class> i 
</hibernate-mapping> 
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从 上 面 的 配置 文件 中 可 以 看 出 ， 该 <map... 亿 元 素 的 配置 方法 与 前 面 映射 集合 属性 时 所 用 的 
<map... 亿 元素 没 有 任何 区 别 。 没 错 ! 实际 上 就 是 没有 任何 区 别 ， 只 是 之 前 把 <map.…/> 作为 <class.…/> 
的 子 元 素 使 用 ， 现 在 把 <map.… 记 作为 <component... 户 的 子 元 素 而 已 。 

当主 程序 保存 了 这 样 的 Person 对 象 后 , Hibernate 依然 将 Name 组 件 的 各 属性 映射 成 不 同 的 数据 列 ， 
再 将 Name 里 的 Map 属性 映射 到 另 一 个 数据 表 。 从 底层 数据 库 来 看 ， 我 们 看 不 出 该 Map 属性 到 底 属于 
Person 对 象 ， 还 是 属于 Person 对 象 的 name 属性 。 实 际 上 ， 这 与 现实 的 物理 模型 是 对 应 的 : 既然 Name 
对 象 (组 件 属性 ) 是 属于 Person 对 象 ， 那 么 Name 对 象 里 包含 的 Map 属性 当然 也 是 属于 Person 对 象 了 。 


> 5.7.2 集合 属性 的 元 素 为 组 件 


集合 除了 可 以 存放 基本 类 型 、 字 符 串 、 日 期 类 型 之 外 ， 还 可 以 存放 组 件 对 象 〈《 也 就 是 复合 类 型 )。 
实际 上 ， 在 更 多 情况 下 ， 集 合 里 存放 的 都 是 组 件 对 象 。 对 于 这 种 持久 化 类 的 映射 稍 有 不 同 ， 我 们 映射 
集合 属性 时 依然 使 用 <list.. 人 >、<set.. 人 > 和 <map.…/> 等 元 素 ， 只 是 不 再 使 用 <element.../> 元 素来 映射 集合 
元 素 ， 而 是 用 <composite-element... 亿 元 素来 映射 集合 元 素 。 
配置 <composite-element.. 人 > 元 素 时 需要 指定 一 个 class 属性 ， 其 值 指定 了 集合 里 组 件 对 象 的 类 型 。 
由 于 <composite-element..…/> 元 素 映 射 的 是 集合 里 的 组 件 〔 还 是 组 件 )， 所 以 <composite-element..…/> 
元 素 和 <component.…/> 元 素 的 用 法 非常 相似 。 
> ”如 果 组 件 的 属性 是 基本 类 型 、 字 符 串 和 日 期 等 类 型 ， 使 用 <property.…/> 子 元 素 映 射 这 些 属性 
即 可 。 
> ”如 果 组 件 的 属性 又 是 组 件 类 型 , 则 使 用 <nested-composite-element..…/> 元 素 映 射 这 些 嵌 套 组 
件 属 性 。 
> ”如 果 组 件 的 属性 引用 其 他 持久 化 实体 ， 则 应 该 使 用 <many-to-one.…/> 元 素来 映射 该 属性 。 
与 <component..… 记 元素 类 似 的 是 ，<composite-element..…/> 元 素 也 可 接受 一 个 <parent.../> 子 元 素 ， 用 
于 引用 包含 该 组 件 属性 的 持久 化 实体 。 


Hibemate 为 了 简化 管理 ， 不 再 允许 在 <composite-element..…./> 元 素 里 使 用 <lii 
<set..…/>、<map.… 户 等 集合 映射 元 素 ! 否则 将 形成 无 尽 循环 : 集合 里 的 元 素 是 组 件 类 型 ， 而 ey 


组 件 类 型 的 属性 再 次 是 集合 ， 集 合 又 可 包含 组 件 类 型 势必 导致 映射 关系 无 限 复杂 。 


设 下 面 的 Person 持久 化 类 里 包含 一 个 nicks 属性 ， 该 属性 需要 保存 该 持久 化 实体 在 不 同 阶段 的 
昵称 ， 可 见 该 nicks 属性 应 该 是 Map 类 型 的 。 下 面 是 该 Person 类 的 代码 。 


程序 清单 ，codes\05\5.7\imap-component\src\org\crazyit\app\domain\Personjava 
public class Person 


{ 

// 标 识 属性 

private Integer id; 

// 普 通 属性 age 

private int age; 

// 组 件 属性 name 

Private Map<String , Name> nicks 

= new HashMap<string , Name>(); 

// 省 略 id 属性 的 setter 和 getter 方法 


// 省 略 age 属性 的 setter 和 getter 方 法 
//nicks 属性 的 setter 和 getter 方 法 
Public void setNicks (Map<String ，Name> nicks) 


{ 
this.nicks = nicks; 
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对 


public Map<String , Name> getNicks() 
{ 

return this.nicks; 
} 


} 
上 面 的 持久 化 类 里 包含 一 个 Map 类 型 的 属性 : nicks， 且 该 Map 的 value 不 是 基本 类 型 、 字 符 串 和 
日 期 等 类 型 , 而 是 Name 类 型 。 所 以 映射 文件 应 该 先 使 用 <map.… 户 元 素来 映射 nicks 属性 , 再 在 <map.…/> 
元 素 里 使 用 <composite-element... 人 元 素来 映射 Map 集合 里 的 组 件 属性 。 映 射 该 持久 化 类 的 映射 文件 代 
码 如 下 。 
程序 清单 :codes\05\5.7\imap-component\src\org\crazyit\app\domain\Person.hbm.xml 
<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-- 映 遇 标识 属性 -> 
<id name="id" column="person_id"> 
<!--~ 指定 主键 生成 器 策略 -> 


<generator class="identity"/> 


ge" type="int"/> 
<!-- 映射 nicks 集合 属性 ， atin opp nick_inf --> 
<map name="nicks" table="ni 
<!-- 映射 集合 属性 数据 表 的 外 键 列 
<key column="person_id" not-null="true"/> 
<!-~ 映射 集合 属性 数据 表 的 Map key 列 -> 
<map-key column="phase" type="string"/> 
<!-- 映射 保存 集合 里 的 组 件 元 素 --> 
<composite-element class="Name"> 
i: Owner 后 疾 人 和 活 各 人 
t name="owner"/> 
映射 组 件 属性 的 first rs -> 
<property name="first"/> 
<!-- 映射 组 件 属性 的 last 属性 -> 
<property name="last"/> 
</composite-element> 
</map> 
</class> 
</hibernate-mapping> 


从 上 面 的 映射 文件 可 以 看 出 ,映射 文件 配置 <map.… 必 元 素 时 与 前 面 配置 普通 Map 集合 时 并 没有 太 
大 的 区 别 ， 只 是 原来 使 用 <element... 人 > 元 素 映 射 Map 集合 的 value， 而 现在 使 用 <composite-element..…/> 
元 素 映 射 Map 集合 的 value 一 一 因为 此 时 的 value 的 类 型 是 Name。 

对 于 这 种 集合 元 素 是 组 件 的 情形 ，Hibernate 依然 会 把 组 件 的 各 属性 映射 到 不 同 的 数据 列 ， 只 是 这 
些 数据 列 将 保存 在 集合 属性 表 中 。 图 5.28 显示 了 集合 属性 表 的 内 容 。 


1> select *# from nick_inf: 


<! 


图 5.28 集合 属性 里 的 组 件 
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》》5.7.3 组 件 作 为 Map 的 索引 


由 于 Map 集合 的 特殊 性 ， 它 允许 使 用 复合 类 型 的 对 象 作为 Map 的 key， 所 以 Hibernate 必须 对 这 
种 组 件 作为 Map key 的 情形 提供 支持 。 
Hibernate 使 用 <composite-map-key... 亿 元 素来 映射 复合 类 型 的 key， 定 义 <composite-map-key.…/> 元 
素 时 需要 指定 一 个 class 属性 ， 其 值 为 Map key 的 类 名 。 
在 <composite-map-key..… 户 元 素 里 可 以 出 现 如 下 两 种 子 元 素 。 
> ”<key-property.…/>: 当 组 件 里 的 属性 是 基本 类 型 、 字 符 串 和 日 期 类 型 时 ， 使 用 该 元 素来 映射 
这 些 属 性 即 可 。 
> ”<key-many-to-one.…/>: 当 组 件 里 的 属性 是 对 其 他 持久 化 实体 的 引用 时 ， 则 使 用 该 元 素来 映 
射 这 些 属性 ， 这 也 是 一 种 特殊 的 关联 映射 。 
上 面 的 <key-property.… 人 > 元 素 可 视 为 一 种 特殊 的 <property... 人 > 元素， 它 一 样 可 以 接受 name、access、 
type、column 和 length 等 属性 ， 这 些 属性 的 作用 和 <property.…. 亿 元素 中 的 完全 一 样 。 
由 于 Map key 的 特殊 性 ， 所 以 程序 必须 重 写 该 组 件 类 的 equals0 和 hashCode0 两 个 方法 。 
假设 有 如 下 持久 化 类 , 该 持久 化 类 里 包含 一 个 Map 类 型 的 属性 , 该 Map 类 型 的 key 是 Name 类 型 。 
程序 清单 : codes\05\5.7\imap-key-component\src\org\crazyit\app\domain\Person.java 
public class Person 


// 标 识 属性 

private Integer id; 

// 普 通 属性 age 

private int age; 

// 集 合 属性 nickPower 

Private Map<Name , Integer> nickPower 
= new HashMap<Name , Integer>(); 

// 省 略 id 属性 的 setter 和 getter 方法 


/77 省 略 age 属性 的 setter 和 getter 方法 
//nickPower 属性 的 setter 和 getter 方法 


public void setNickPower (Map<Name , Integer> nickPower) 
{ 


this.nickPower = nickPower; 


public Map<Name , Integer> getNickPower() 
{ 
return this.nickPower; 
} 
} 


上 面 的 持久 化 类 中 使 用 Name 对 象 作 为 Map 的 key， 所 以 程序 使 用 需要 重 写 Name 类 的 equals() 
和 hashCode() 两 个 方法 。Name 类 的 代码 如 下 。 
程序 清单 :codes\05\5.7\map-key-component\src\org\crazyit\app\domain\Name.java 
public class Name 4 
{ 
// 定 义 first 属性 4 
private String first; 
// 定 义 last 属性 
private String last; 
// 引 用 拥有 访 Name 的 Person 对 象 
Private Person owner; 
// 无 参数 的 构造 器 
public Namet) 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 


420 


http://52pdf.taobao.com 


和 


public Name(String first ，String last) 
{ 


this.first = first; 
this.last = last; 


) 
// 省 略 first 属性 的 setter 和 getter 方法 
/77 省 略 last 属性 的 setter 和 getter 方法 

17/ 省 略 owner 属性 的 setter 和 getter 方 法 


// 重 写 equals 方法 ， 根 据 first、last 进行 判断 
public boolean equals (Object obj) 
{ 
if (this ~= obj) 
{ 
return true; 


上 
if (obj 1= nu11 
66 obj.getclass() == Name.class) 
{ 
Name target = (Name)obj; 
if (target,getFirst().equals(getFirst ()} 
56 target.getLast().equals(getLast ())) 
i 
return true; 
1 
1 
return false; 


) 
// 重 写 hashcode 方法 ,根据 first、last 计算 hashcode 值 
public int hashCodef) 
{ 
return getFirst ().hashCode() * 13 
+ getLast ().hashCode(); 
上 
} 


以 上 程序 的 斜体 字 代码 正确 地 重 写 了 Name 的 equals0 和 hashCode0 两 个 方法 , 重 写 这 两 个 方法 的 
关键 属性 是 first 和 last 两 个 属性 。 

对 于 上 面 的 Person 类 中 的 nickPower 属性 ， 映 射 文件 依然 使 用 <map.… 信 元 素 进行 映射 ， 但 因为 
nickPower 属性 的 key 是 Name 类 型 ， 所 以 需要 在 <map.…> 里 使 用 <composite-map-key.../> 子 元 素 映射 
Map key。 下 面 是 Person 类 的 映射 文件 代码 。 

程序 清单 ;codes\05\5.7\map-key-component\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 ~-> 
<id name="id" column="person_id"> 
<!-- 指定 主键 生成 器 策略 一 > 


<generator class="identity"/> 


<property name="age" type="int"/> 
<!-- 映射 nickPower 集合 属性 ， se nick_power -> 
<map name="nickPower" table="ni 

<!-~ 映射 集合 属性 数据 表 的 外 键 列 --> 

<key column="person_id" not-null="true"/> 

<!-- 映射 集合 属性 数据 表 的 Map key 列 ， 

因为 Map key 的 数据 类 型 是 复合 类 型 ， 所 以 使 用 如 下 元 素 --> 
<composite-map-key class="Name"> 
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<!-- 腕 射 复合 组 件 的 属性 -> 
<key-Property name="first" type="string"/> 
<key-property name="last" type="string"/> 

</composite-map-key> 

<!-- 映射 集合 元 素 的 数据 列 -> 

<element column="nick power" type="int"/> 

</map> 
</class> 
</hibernate-mapping> 


在 这 种 映射 关系 下 ，Name 组 件 的 各 属性 被 映射 到 集合 属性 表 里 的 数据 列 ， 且 此 时 Name 属性 作 
为 Map key 使 用 , 因此 Hibernate 会 将 外 键 列 、 Name 属性 所 映射 的 多 列 作为 联合 主键 , 如 图 5.29 所 示 。 


‘sql> desc nick power; 


person_id int (1D) MO 
nick_power int(ll) YES 
first varchar (255) 


图 5.29 ”使 用 组 件 作为 Map key 
和 和 5.7.4 组 件 作为 复合 主键 


如 果 数 据 库 采 用 简单 的 逻辑 主键 ， 则 不 会 出 现 组 件 类 型 的 主键 。 但 在 一 些 特殊 的 情况 下 ， 总 会 出 
现 组 件 类 型 主键 ，Hibernate 也 为 这 种 组 件 类 型 的 主键 提供 了 支持 。 
使 用 组 件 作为 复合 主键 , 也 就 是 使 用 组 件 作为 持久 化 类 的 标识 符 , 则 该 组 件 类 必须 满足 以 下 要 求 : 
> ”必须 实现 java.io.Serializable 接口 。 
> ”必须 正确 地 重 写 equals() 和 hashCode() 方 法 ， 也 就 是 根据 组 件 类 的 关键 属性 来 区 分 组 件 
对 象 。 


提示 
“在 Hibemate 3 中 ， 第 二 个 要 求 并 不 是 必需 的 ， 但 最 好 这 样 做 。 因 为 这 样 做 能 从 Java 
语义 上 更 好 地 区 分 两 个 标识 属性 值 ， 这 样 Hibernate 能 将 它们 当成 两 条 记录 的 主键 。 


当 使 用 组 件 作为 复合 主键 时 ，Hibernate 无 法 为 这 种 复合 主键 自动 生成 主键 值 ， 所 以 程序 必须 为 持 
久 化 实例 分 配 这 种 组 件 标识 符 。 

Hibernate 使 用 <composite-id... 亿 元 素来 映射 这 种 复合 主键 ， 使 用 <composite-id,., 人 > 元 素 时 可 以 指定 
name、class、access、unsaved-value 等 可 选 属性 ， 前 面 已 经 提供 过 关于 这 些 属性 的 详细 说 明 ， 故 此 处 
不 再 袭 述 。 

在 <composite-id... 人 > 元 素 里 使 用 <key-property.….> 元 素来 映射 组 件 类 的 各 属性 。 


下 面 的 Person 类 将 使 用 一 个 Name 类 型 的 主键 。 
程序 清单 : codes\05\5.7\component-key\org\crazyit\app\domain\Person.java 


public class Person 
* 
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// 以 Name 组 件 作为 标识 属性 
private Name name; 
// 普 通 属性 age 
private int age7 
//name 属性 的 setter 和 getter 方法 
public void setName (Name name) 
{ 
this.name = name; 
} 
public Name getName () 
{ 


return this,name; 
和 
// 省 略 age 属性 的 setter 和 getter 方法 


} 
上 面 Person 的 标识 属性 不 再 是 基本 类 型 ， 也 不 是 String 字符 串 。 而 是 Name 类 型 ，Name 类 型 是 
用 户 自 定义 的 类 型 。 
因为 Name 类 型 的 属性 将 作为 Person 的 标识 属性 ， 所 以 Name 类 应 实现 java.io.Serializable 接口 ， 
并 正确 重 写 equals0 和 hashCode() 两 个 方法 。 下 面 是 Name 类 的 源 代码 。 
程序 清单 :codes\05\5.7\component-key\org\crazyit\app\domain\Name.java 
Public class Name 
implements java.io.Serializable 
/证 X firat 属性 
private String first; 


// 定 义 last 属性 
private String last; 


// 无 参数 的 构造 器 
public Name() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Name (String first ，String last) 
{ 
this.first = first; 
this.last = last; 


} 

// 省 略 first 属性 的 setter 和 getter 方法 

略 last 属性 的 setter 和 getter 方法 

/77/ 重 写 equals 方法 ,根据 first、last 进行 判断 


public boolean equalstObject obj) 
{ 


if (this == obj) 
{ 
return true; 
} 
if (obj != null 
45 obj.getClass() == Name.class) 
{ 
Name target = (Name)obj; 
if (target.getFirst().equals(getFirst()) 
55 target.getLast().equals (getLast ())) 
{ 
return true; 
: 
1 
return false; 


上 
// 重 写 hashcode 方法 ,根据 first、last 计算 hashCode 值 
public int hashCode() 
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return getFirst() .hashcode() * 7 
+ getLast() .hashCode () 
} 


Person 持久 化 类 使 用 Name 类 的 标识 属性 ，Name 实例 可 以 唯一 标识 Person 实例 。 根 据 业 务 需 要 ， 
能 唯一 标识 Person 实例 的 应 该 是 first 和 last 两 个 属性 .因此 hashCode 和 equals 方法 都 根据 first 和 last 


两 个 属性 来 判断 。 
组 件 类 型 的 主键 使 用 <composite-id.…/> 元 素 映射 ， 该 元 素 需 要 class 属性 来 确定 主键 的 组 件 类 型 ， 
使 用 <key-property.. 人 元素 指 定 组 件 里 包含 的 基本 属性 。 下 面 是 Person 类 持久 化 映射 文件 。 
程序 清单 ; codes\05\5.7\component-key\org\crazyit\app\domain\Person.hbm.xml 
<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
ame="Person" table="person_inf"> 
<!-~ 映射 组 件 类 型 的 标识 属性 --> 
<composite-id name="name" class="Name"> 
<!-- 映射 组 件 主键 里 的 各 属性 -> 
<key-Property name="first" type="string"/> 
<key-Property name="last" type="string"/> 


<property name="age" type="int"/> 
</class> 
</hibernate-mapping> 


该 Person 类 使 用 Name 组 件 作 为 主键 ， 所 以 Hibernate 无 法 为 Person 对 象 生 成 标识 属性 值 ， 必 须 
由 程序 为 Person 对 象 显 式 分 配 标识 属性 。 创 建 并 保存 Person 对 象 的 代码 片段 如 下 : 
程序 清单 :codes\05\5.7\component-key\src\lee\PersonManagerjava 


Private void createAndstorePerson() 
{ 


Session sion = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction(); 
// 创 建 Person 对 象 
Person yeeku ~ new Persont(); 
// 为 Person 对 象 设置 属性 
yeeku. setAge (29) 
// 创 建 一 个 Name 对 象 作为 Person 对 象 的 标识 属性 值 
Name n = new Name("crazyit.org”，" 闭 狂 Java 联盟 ") ; 
Yeeku .setName (n) ; 
session.save (yeeku) 7 
tx,commit ()# 
HibernateUtil.closesession(); 
} 


上 面 程序 的 两 行 粗 体 字 代码 用 于 显 式 地 为 Person 对 象 分 配 标识 属性 值 ,程序 运行 结束 后 , Hibernate 
将 会 把 Name 组 件 所 映射 的 多 个 数据 列 作为 联合 主键 ， 如 图 5.30 所 示 。 


ysq1》 desc person_inf 


Null | Key | Default | Extra 
last varchar(255) 


Vi NULL 
NO NULL 
age int(11) 
| | 
y 


图 5.30 使 用 Name 组 件 作为 复合 主键 
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二 


>》>5.7.5 多 列 作 为 联合 主键 


Hibernate 还 提供 了 另 一 种 联合 主键 支持 ，Hibernate 允许 直接 将 持久 化 类 的 多 列 映射 成 联合 主键 。 
如 果 需 要 直接 将 持久 化 类 的 多 列 映射 成 联合 主键 ， 则 该 持久 化 类 必须 满足 如 下 两 个 条 件 : 
> ”实现 java.io.Serializable 接口 。 
> ”根据 联合 主键 列 所 映射 的 属性 来 重 写 equals() 和 hashCode() 方 法 。 
看 下 面 改写 过 的 Person 源 代码 。 
程序 清单 : codes\05\5.7\composite-id\src\org\crazyit\app\domain\Person.java 
public class Person 


ts java.io.Serializable 


// 定 义 first 属性 ， 作 为 标识 属性 的 成 员 
Private String first; 

// 定 义 1ast 属性 ， 作 为 标识 属性 的 成 员 
private String last; 

// 普 通 属性 age 

private int age; 

// 省 略 first 属性 的 setter 和 getter 方法 


{ 


/7 省略 last 属性 的 setter 和 getter 方法 
/77 省 略 age 属性 的 setter 和 getter 方法 


// 重 写 equals 方法 ， 根 据 first、last 进行 判断 
public boolean equals (Object obj) 
{ 

if (this == obj) 

{ 


return truey 


】} 
if (obj != null 
5&6 obj.getclass() == Person.class) 
{ 
Person target = (Person)obj; 
if 《target.getFirst() -equals(getFirst()) 
&6 target .getLast () .equals (getLast ())) 
{ 
return true; 
) 


return false; 


} 
// 重 写 hashCode 方法 ,根据 first、last 计算 hashCode 值 
public int hashCode() 
{ 
return getFirst().hashCode() * 13 
+ getLast().hashCode(); 
} 
} 


对 于 Person 实例 , first 和 last 组 合 起 来 能 唯一 标识 该 实例 , 因此 hashCode 方法 和 equals 方法 根据 
这 两 个 属性 进行 判断 。 

如 需 映射 first 和 last 两 个 标识 属性 ， 同 样 使 用 <composite-id… 记 元素， 此 时 的 <composite-id… 户 元 
素 不 需要 name 和 class 属性 ， 因 为 标识 属性 没有 实现 类 ， 所 以 不 需要 class 属性 ， 因 为 不 是 一 个 真实 
存在 的 属性 ， 所 以 不 需要 name 属性 。 下 面 是 该 映射 文件 的 源 代码 。 
程序 清单 :codes\05\5.7\composite-id\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<1DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
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<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_inf"> 
<!-- 直接 使 用 composite-id 映射 多 列 联合 主键 -一 > 
<composite-id> 
<!-- 映射 组 件 主 键 里 的 各 属性 ~-> 
<kay-Property nane="first" type="string"/> 
name="last" type="string"/> 
</composite-id> 
<!-- 映射 普通 属性 --> 
<property name="age" type="int"/> 
</class> 
</hibernate-mapping> 


上 面 的 粗 体 字 代码 与 前 面 的 映射 代码 基本 一 样 ， 只 是 <composite-id.../> 元 素 里 少 了 name 和 class 
两 个 属性 。 这 两 种 映射 方式 的 效果 差不多 ， 映 射出 来 的 表 结构 完全 相同 。 


5.8 ”使 用 JPA Annotation 标注 实体 

从 JDK 1.5 开始 ，Java 增加 了 Annotation 支持 ， 通 过 Annotation 可 以 将 一 些 额外 的 信息 写 在 Java 
源 程序 中 ， 这 些 信息 可 以 在 编译 、 类 加 载 、 运 行 时 被 读 取 ， 并 执行 相应 的 处 理 。 通 过 使 用 Annotation， 
程序 开发 人 员 可 以 在 不 改变 原 有 膛 辑 的 情况 下 ， 在 源 文 件 中 嵌入 一 些 补充 的 信息 。 


提示 ;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … a 
Fs 关于 Annotation 的 详细 介绍 ， 读 者 可 以 参考 疯狂 Java 体系 《疯狂 Java 讲义 》 的 第 14 章 。 


由 于 Java Annotation 的 盛行 ， 很 多 原来 采用 XML 配置 文件 进行 管理 的 信息 ， 现 在 都 开始 改 为 使 
用 Annotation 进行 管理 ， 比 如 前 面 介 绍 的 Struts 2、 以 及 后 面 要 介绍 的 Spring 等 。 其 实 不 管 是 XML 配 
置 文件 ， 还 是 Annotation， 它 们 的 本 质 是 一 样 的 ， 只 是 信息 的 载体 不 同 而 已 。 


>》>5.8.1 增加 JPAAnnotation 支持 


正如 前 面 提 到 的 , Hibernate 这 种 ORM 框架 的 出 现 启发 了 Java EE 规范 的 制定 者 , 于 是 催生 了 JPA 
规范 。 从 另 一 方面 来 看 ，JPA 规范 的 出 现 又 为 Hibernate 等 ORM 框架 制定 了 标准 。 
早期 Hibernate 使 用 XML 映射 文件 管理 持久 化 类 和 数据 表 之 间 的 映射 关系 , 而 JPA 规范 则 推荐 使 
用 更 简单 、 易 用 的 Annotation 来 管理 实体 类 与 数据 表 之 间 的 映射 关系 ， 这 样 就 避免 了 一 个 实体 需要 同 
时 维护 两 份 文件 〈Java 类 和 XML 映射 文件 )， 实 体 类 的 Java 代码 以 及 映射 信息 《〈 写 在 Annotation 中 ) 
都 可 集中 在 一 份 文件 中 。 
当 采 用 Annotation 来 管理 实体 类 之 后 ， 可 以 得 到 如 下 公式 : 
PO = POJO + @Annotation 
Hibemate 3.6 已 经 为 使 用 Annotation 管理 映射 信息 做 好 了 准备 ， 前 面 我 们 已 经 将 Hibernate 发 行 包 
lib 目录 下 jpa 子 目录 下 的 JAR 包 添加 到 了 系统 的 类 加 载 路 径 中 ， 这 已 经 足够 。 
下 面 使 用 Annotation 来 定义 一 个 实体 类 。 
程序 清单 : codes\05\5.8\Annotation\src\org\crazyitapp\domain\Person.java 
QEntity 
QTable (name="person_table") 
public class Person 
E /* 指定 使 用 复合 主键 类 是 Name */ 
EmbeddedId 


QAttributeOverrides ({ 
GAttributeOverride (name="first" 
， column=ecolumn (name="person_first")), 
BRttributeOverride (name="last" 
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半生 


，column=ecolumn (name="person_last" , length=20)) 
Dn 
Private Name name; 
// 普 通 属性 
ecolumn (name="person_email") 
private String email; 
Embedded 
QAttributeOverrides ({ 
BAttributeOverride (name="name" 
, column=8Colunn (name="cat. name" , length=35)), 
@AttributeOverride (name="color" 
, column=8Colunn (name="cat_color")) 


D) 

// 组 件 属性 ， 代 表 此 人 拥有 的 宠物 

private Cat pet; 

// 省 略 name 属性 的 setter 和 getter 方法 


/7 省 略 email 属性 的 setter 和 getter 方法 
/7 省 略 pet 属性 的 setter 和 getter 方法 


} 

上 面 的 程序 的 粗 体 字 代 码 就 可 管理 实体 类 与 数据 表 之 间 的 映射 关系 ， 其 中 @Entity 用 于 标注 该 类 
是 一 个 持久 化 类 ，@ EmbeddedId 用 于 标注 复合 类 型 的 标识 属性 ， 而 @Embedded 用 于 标注 一 个 组 件 属 
性 ， 也 就 是 说 Person 的 name 属性 就 是 一 个 复合 类 型 的 标识 属性 ，pet 属性 是 一 个 组 件 属性 。 

上 面 的 程序 还 用 了 Name 类 ， 它 是 一 个 Person 实体 的 标识 属性 的 类 型 ， 程 序 使 用 @Embeddable 标 
注 它 即 可 。 如 以 下 代码 所 示 。 

程序 清单 : codes\05\5.8\Annotation\src\org\crazyit\app\domain\Name.java 


// 修 饰 组 件 属性 类 
@ . 
public class Name 

implements java.io.Serializable 
{ 

private String first; 

private String last; 

// 无 参数 的 构造 器 

public Name() 

{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Name (String first , String last) 
{ 
this.first = first; 
this.last = last; 


} 
// 省 略 first 属性 的 setter 和 getter 方法 
/7 省 略 1ast 属性 的 setter 和 getter 方法 


// 提 供 重 写 的 equals 方法 
public boolean equals (Object obj) 
{ 
if (this == obj) 
{ 
return true; 
} 
if (obj .getClass() == Name.class) 
{ 
Name target = (Name)obj; 
if (target.getFirst().equals(first) 
&& target.getLast().equals (last)) 
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{ 
return true; 
} 
} 
return false; 


二 
// 提 供 重 写 的 hashCode 方法 
public int hashCode() 
{ 
return first.hashCode() + last.hashCode() * 17} 
} 
) 


上 面 的 Name 类 需要 作为 标识 属性 的 类 型 ， 因 此 一 样 需 要 实现 java.io.Serializable 接口 ， 并 重 写 了 
hashCode0 和 equalsO 两 个 方法 。 
至 于 Person 类 所 包含 的 组 件 属性 pet, 它 所 属 的 Cat 类 也 只 要 简单 地 使 用 @Embeddable 修饰 即 可 ， 
下 面 是 该 Cat 类 的 代码 。 
程序 清单 :codes\05\5.8\Annotation\src\org\crazyit\app\domain\Cat.java 
/ /修饰 组 件 属性 类 
GEmbeddable 
public class Cat 
private String name; 
private String color 
// 无 参数 的 构造 器 
public Cat() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Cat (string name , String color) 
{ 
this.name = name; 
this.color = color; 


) 
// 省 略 name 属性 的 setter 和 getter 方法 
// 和 省 略 color 属性 的 setter 和 getter 方法 


“ 旦 在 实体 类 中 通过 上 面 的 Annotation 进行 标注 之 后 , Hibernate 已 经 能 够 理解 实体 类 与 数据 表 之 间 
的 映射 关系 了 ， 也 就 不 再 需要 *.hbm.xml 的 映射 文件 了 。 此 时 要 将 hibernate.cfg.xml 文件 略 做 修改 一 一 告 
诉 它 去 加 载 指定 实体 类 ， 而 不 是 根据 映射 文件 加 载 。 本 应 用 所 使 用 的 hibernate.cfe.xml 文件 代码 如 下 。 
程序 清单 : codes\05\5.8\Annotation\src\hibernate.cfe.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 配置 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 
<!-- hibernate- configuration 是 连接 配置 文件 的 根 元 素 --> 
<hibernate-configuration> 
<session-factory> 


<!-- 省 略 其 他 配置 属性 ~-> 


<!- 罗列 所 有 的 持久 化 类 一 -> 
<mapping class="org.crazyit.app.domain.Person"/> 
</session-factory> 
</hibernate-configuration> 


经 过 上 面 的 修改 之 后 ， 主 程序 不 需要 任何 改变 。 不 管 使 用 XML 映射 文件 管理 实体 的 映射 、 还 是 
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和 5 


采用 Annotation 管理 实体 的 映射 ，Hibernate 的 处 理 完全 相同 。 
i 
“读者 可 能 有 一 个 疑问 ， 本 示例 所 使 用 的 Annotation 是 哪里 的 呢 ? 其 实 这 些 er 
是 JPA 标准 的 Annotation， 甚 至 与 Hibernate 无 关 。 读者 完全 可 以 参考 Java EE 规范 的 API | 
| 。 来 查阅 这 些 Annotation 的 说 明 。 本 书 姊 款 篇 《经 典 Java EE 企业 应 用 实战 》 一 书 中 包含 了 
JPA 每 个 Annotation 的 详细 说 明 及 用 法 示例 . | 


>>5.8.2 Annotation? 还 是 XML 映射 文件 


当 开 发 一 个 以 Hibernate 作为 持久 层 的 Java EE 应 用 时 ， 开 发 者 既 可 以 选择 Annotation 来 管理 映射 
关系 ， 也 可 以 选择 XML 映射 文件 来 管理 映射 关系 ， 那 么 实际 项 目 中 选择 哪 种 更 合适 呢 ? 
对 于 一 个 新 项 目 ， 笔 者 更 倾向 于 使 用 Annotation， 而 不 是 XML 映射 文件 ， 理 由 如 下 : 
> ”使 用 Annotation 更 加 简洁 ， 开 发 者 可 以 将 实体 类 的 Java 代码 、Annotation 集中 在 一 个 文件 
中 管理 ， 因 此 更 加 简单 。 
> ”基于 Annotaion 的 实体 具有 更 好 的 可 保值 性 。 因 为 这 些 Annotation 并 不 属于 Hibernate， 而 
是 属于 JPA 规范 , 因此 这 些 实体 类 不 仅 对 于 Hibernate 可 用 ,对 于 JPA 也 是 可 用 的 , 因此 如 
果 有 一 天 打算 把 应 用 迁移 到 其 他 ORM 框架 上 ， 底 层 实体 类 无 须 做 任何 改变 。 
当然 ， 对 于 实际 企业 开发 来 说 ， 由 于 早期 Hibernate 使 用 者 大 都 习惯 使 用 *.hbm.xml 文件 来 管理 映 
射 关系 ， 因 此 *.hbm.xml 文件 在 实际 企业 开发 中 还 是 占有 重要 地 位 的 。 
本 书 的 姊妹 篇 《经 典 Java EE 企业 应 用 实战 》 一 书 已 经 详细 介绍 了 JPA 所 有 Annotation 的 用 法 ， 
并 给 出 了 详细 的 用 法 示例 。 作 为 互补 ， 本 书 将 主要 采用 *.hbm.xml 文件 来 管理 实体 的 映射 关系 ， 不 会 
再 介绍 使 用 Annotation 来 管理 实体 的 映射 关系 。 


5.9 本 章 小 结 


本 章 介绍 了 持久 层 框 架 ，Hibernate 的 初步 使 用 。 本 章 简要 介绍 了 ORM 工具 的 作用 和 优势 ， 以 及 
Hibernate 的 基本 映射 思想 。 本 章 以 一 个 Hibernate 的 简单 示例 开始 ， 让 读者 充分 感受 到 Hibernate 持久 
层 解决 方案 的 简易 之 处 。 本 章 详细 介绍 了 如 何在 Eclipse 中 通过 Hibernate Tools 插件 开发 Hibernate 应 
用 ， 并 详细 讲解 了 Hibernate 的 体系 结构 、Hibernate 对 持久 化 对 象 的 要 求 、 持 久 化 对 象 的 状态 等 内 容 。 
本 章 还 重点 介绍 了 Hibernate 映射 文件 的 相关 知识 ， 详 细 介绍 了 Hibemate 的 基本 映射 、 数 据 库 对 象 映 
射 、 集 合 属性 映射 、 组 件 属性 映射 、 复 合 主键 映射 等 内 容 。 本 章 最 后 介绍 了 如 何 使 用 JPA Annotation 
来 管理 实体 的 映射 关系 。 
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第 ,6 章 
深入 使 用 Hibernate 


本 章 要 点 


各 关联 映射 的 详细 策略 

他 关联 映射 的 级 联 风格 和 传播 持久 化 
切 关 联 映射 性 能 分 析 

蕊 三 种 继承 映射 策略 

基 Hibernate 的 批量 处 理 策略 

各 DML 风格 的 批量 操作 

和 HQL 查询 

各 HQL 查询 的 隐 式 关联 和 显 式 关联 
苗条 件 查询 人 


人 离线 查询 和 子 查询 i 


”各 原生 SQL 查询 
和 命名 SQL 查询 
芝 数 据 过 滤 
各 Hibemnate 中 的 事务 和 并 发 
基 Hiberate 的 二 级 缓存 和 查询 缓存 
节 拦 截 器 和 事件 机 制 
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在 上 一 章 中 已 经 介绍 了 Hibernate 的 基本 支持 ， 已 经 了 解 了 通过 Hibernate 的 支持 ， 应 用 程序 可 以 
从 底层 的 JDBC 中 释放 出 来 ， 以 面向 对 象 的 方式 进行 数据 库 访问 。 但 面向 对 象 远 不 止 这 些 内 容 ， 比 如 
对 象 和 对 象 之 间 的 关联 关系 ， 这 对 于 客观 世界 的 建 模 是 非常 重要 的 。 除 此 之 外 ，Hibemate 完全 可 以 理 
解 面向 对 象 的 继承 、 多 态 等 概念 ， 一 旦 建立 了 正确 继承 映射 ， 程 序 就 能 以 更 加 面向 对 象 的 方式 进行 数 
据 库 访 问 。 

本 章 将 更 深入 地 介绍 Hibemate 的 关联 映射 、 继承 映射 等 内 容 ; 也 会 详细 介绍 Hibernate 的 查询 体系 ， 
HQL 查询 的 功能 非常 强大 ， 使 用 HQL 可 以 充分 利用 面向 对 象 方式 进行 查询 ; 除 此 之 外 ，Hibernate 还 提 
供 了 更 面向 对 象 的 条 件 查 询 ， 并 可 以 直接 使 用 原生 的 SQL 查询 等 。 本 章 将 详细 介绍 Hibernate 所 提供 的 
查询 体系 ， 以 及 在 实际 开发 中 如 何 使 用 Hibemate， 如 何 处 理 Hibernate 的 性 能 、 事 务 等 实际 性 问题 。 


6.1 Hibernate 的 关联 映射 


客观 世界 中 的 对 象 很 少 有 孤立 存在 的 ， 例 如 老师 ， 往 往 与 被 授课 的 学 生存 在 关联 关系 ， 如 果 已 经 
得 到 某 个 老师 的 实例 ， 那 么 应 该 可 以 直接 获取 该 老师 对 应 的 全 部 学 生 。 反 过 来 ， 如 果 已 经 得 到 一 个 学 
生 的 实例 ， 也 应 该 可 以 访问 该 学 生 对 应 的 老师 一 一 这 种 实例 之 间 的 互相 访问 就 是 关联 关系 。 

关联 关系 是 面向 对 象 分 析 、 面 向 对 象 设计 最 重要 的 知识 ，Hibemate 完全 可 以 理解 这 种 关联 关系 ,如 
果 映 射 得 当 ，Hibemate 的 关联 映射 将 可 以 大 大 简化 持久 层 数据 的 访问 。 关 联 关系 大 致 有 如 下 两 个 分 类 ; 

> 单 向 关系 : 只 需 单 向 访问 关联 端 。 例 如 ,只 能 通过 老师 访问 学 生 , 或 者 只 能 通过 学 生 访 问 老师 。 

> ”双向 关系 : 关联 的 两 端 可 以 互相 访问 。 例 如 ， 老 师 和 学 生 之 间 可 以 互相 访问 。 

单 向 关联 可 分 为 

> 单 向 1-1 

> 单 向 1-N 

> 单 向 N-1 

> 单 向 N-N 

双向 关联 又 可 分 为 : 

> 双向 1-1 

> 双向 1-N 

> 双向 N-N 

双向 关系 里 没有 NN - 1， 因 为 双向 关系 1 - N 和 NN- 1 是 完全 相同 的 。 下 面 依次 讲解 每 种 关联 的 映 
射 方法 。 


>>6.1.1 单身 N-1 关联 


N- 1 是 非常 常见 的 关联 关系 ， 最 常见 的 父子 关系 也 是 N- 1 关联 ， 单 向 的 N- 1 关联 只 需 从 的 
- 端 可 以 访问 1 的 一 端 。 8 
单 向 N- 1 关系 ， 比 如 多 个 人 对 应 同一 个 住址 ， 只 需 从 人 实体 端 可 以 找到 对 应 的 地 址 实体 ， 无 须 
关心 某 个 地 址 的 全 部 住户 。 
为 了 让 两 个 持久 化 类 支持 这 种 关联 映射 ， 程 序 应 该 在 N 的 一 端的 持久 化 类 中 增加 一 个 属性 ， 该 属 
性 引用 1 的 一 端的 关联 实体 。 下 面 是 两 个 持久 化 类 描述 了 这 种 关联 关系 ,Person 类 中 增加 了 一 个 Address 
属性 ， 引 用 关联 的 Address 实体 。 
程序 清单 : codes\06\6.1\unidirectional\N-1nojointable\src\org\crazyit\app\domain\Person.java 
public class Person 


// 标 识 属性 
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private Integer id; 
//Person 的 name 属性 
private String name; 
// 保 留 Person 的 age 属性 
private int age; 


// 引 用 关联 实体 的 属性 
Private Address address; 
// 省 略 id 属性 的 setter 和 getter 方法 


/7 省 略 name 属性 的 setter 和 getter 方法 
7 7 省 略 age 属性 的 setter 和 getter 方法 


//address 属性 的 setter 和 getter 方法 
public void setAddress (Address address) 
{ 
this.address = address; 
} 
public Address gethddress() 
f 
return this.address; 
} 
} 


上 面 是 Person 类 的 代码 ,每 个 Person 单 向 地 持 有 一 个 Address, 因此 Person 类 里 增加 了 一 个 Address 
类 型 的 属性 。 程 序 无 须 从 Address 访问 Person， 所 以 Address 无 须 增加 Person 属性 。 如 下 面 代码 所 示 : 
程序 清单 :codes\06\6.1\unidirectional\N-1nojointable\src\org\crazyit\app\domain\Address.java 
public class Address 
// 标 识 属性 
private Integer addressId; 


// 地 址 详细 信息 
private String addressDetail; 


// 无 参数 的 构造 器 
public Address() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Address(String addressDetail) 
{ 
this.addressDetail = addressDetail; 


Vo addressId 属性 的 setter 和 getter 方法 
7/ 省 略 addressDetail 属性 的 setter 和 getter 方 法 
对 于 Address 端 而 言 ， 并 不 需要 关心 Person 持久 化 类 ，Address 的 代码 中 并 没有 对 Person 的 访问 ， 
因此 Address 的 映射 就 是 基本 映射 ， 无 须 改 变 。 
6.1.1.1 无 连接 表 的 N 一 1 关联 
Person 端 增加 了 Address 属性 ， 该 属性 不 是 一 个 普通 的 组 件 属性 ， 而 是 引用 另 一 个 持久 化 类 的 类 ， 


Hibernate 使 用 <many-to-one... 人 > 元 素 映射 N - 1 的 关联 实体 , 直接 采用 <many-to-one.../> 元 素来 映射 关联 
实体 将 会 在 入 的 一 端的 数据 表 中 增加 一 个 外 键 列 ， 用 于 参照 主 表 记 录 。 

流 
-得 .注意 :站 一 
直接 使 用 <many-to-one... 人 > 元 素来 映射 N- 1 关联 时 ，Hibernate 将 无 须 使 用 连接 表 ， 


直接 使 用 对 人 关 联 条 咯 本 处理 这 和 类 溢 隐 灿 。 


<many-to-one， /元 素 的 作用 有 类 似 于 <propery. 元 素 ， 也 用 于 映射 持久 化 类 的 某 个 属性 ， 区 
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别 是 该 元 素 映射 的 是 关联 实体 。 与 property 元 素 类 似 的 是 ，many-to-one 元 素 也 必须 拥有 name 属性 ， 
用 于 确定 该 属性 的 名 字 。 除 此 之 外 ，<many-to-one... 人 > 元 素 还 可 拥有 如 下 可 选 属性 。 
> ”column: 该 属性 指定 进行 关联 的 外 键 列 的 列 名 ， 该 列 名 默认 与 该 属性 同名 。 
> class: 该 属性 指定 关联 实体 的 全 限定 类 名 ， 默 认 是 通过 反射 得 到 该 属性 所 属 类 的 类 名 。 
> ”cascade: 该 属性 指定 哪些 持久 化 操作 会 从 主 表 记录 级 联 到 子 表 记 录 。 关 于 关联 实体 之 间 的 
级 联 行为 ， 后 面 还 会 有 更 详细 的 介绍 。 
> fetch: 该 属性 指定 Hibernate 的 抓 取 策略 , 该 属性 值 只 能 是 join 〈 使 用 外 连接 抓 取 ) 和 select 
《使 用 选择 抓 取 》 两 个 值 的 其 中 之 一 。 
> ”update, insert， 指定 对 应 的 字段 是 否 包含 在 用 于 Hibemate 生成 的 update 或 insert 语句 中 ， 
两 个 属性 的 默认 值 都 是 true。 如 果 将 二 者 指定 为 false， 则 表明 这 是 一 个 纯粹 的 外 源 关联 ， 它 
的 值 是 通过 映射 同一 个 或 多 个 ) 字段 的 其 他 属性 得 到 的 ,或 由 触发 器 或 其 他 程序 来 负责 生成 。 
> ”property-ref: 指定 关联 类 的 一 个 属性 ， 这 个 属性 将 会 和 本 类 的 外 键 相对 应 〈 当 外 键 参 照 唯一 
键 时 需 指定 该 属性 ) 。 如 果 没 有 指定 ， 直 接 使 用 对 方 关 联 类 的 主键 。 
> access: 指定 Hibernate 访问 此 关联 属性 的 访问 策略 ， 默 认 是 property。 
> unique: 指定 Hibernate 通过 DDL 为 外 键 列 添加 唯一 约束 。 此 外 ， 也 可 以 用 做 property-ref 
的 目标 属性 。 这 使 关联 同时 具有 一 对 一 的 效果 。 
> ”not-null， 指 定 使 用 DDL 为 外 键 字段 添加 非 空 约束 。 
> ”optimistic-lock: 该 属性 指定 其 更 新 时 是 否 需 要 获得 乐观 锁定 ， 也 就 是 其 值 决定 引用 关联 实体 
的 属性 发 生 改 变 时 版 本 值 是 否 增长 。 
> lazy: 指定 引用 关联 实体 的 延迟 加 载 特性 ， 该 属性 只 能 接受 false、proxy、no-proxy 三 个 值 。 
该 属性 默认 值 是 proxy。 实 际 上 ，Hibernate 默认 会 启动 单 实例 关联 ( 即 多 对 一 、 一 对 一 ) 的 
代理 ， 指 定 no-proxy 即 要 求 该 属性 应 该 在 实例 变量 第 一 次 被 访问 时 采用 延迟 抓 取 ， 
lazy="false" 指 定 此 关联 实体 总 是 被 预先 抓 取 。 
> not-found: 该 属性 指定 当 外 键 参照 的 主 表 记录 不 存在 时 如 何 处 理 。 该 属性 只 接受 ignore 和 
exception 两 个 值 ， 默 认 是 exception， 即 不 存在 时 抛 出 异常 ， 如 果 程序 希望 Hibernate 忽略 
这 个 异常 ， 则 可 指定 该 属性 值 为 ignore。 
> ”formula: 指定 一 个 SQL 表达 式 ， 该 外 键 值 将 根据 该 SQL 表达 式 来 计算 。 
我 们 只 要 在 N 一 端的 映射 文件 中 增加 <many-to-one... 人 > 属性 即 可 完成 这 种 关联 映射 。 下 面 是 Person 
持久 化 类 的 映射 文件 。 
程序 清单 : codes\06\6.1\unidirectional\N-1nojointable\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app. domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 一 > 
<generator class="identity"/> 


<property name="name" type="string"/> 
<property name="age" type="int"/> 

<!-- 用 于 映射 N-1 关联 实体 ， 指 定 关联 实体 类 为 Address 
指定 外 键 列 名 为 address_id， 并 指定 级 联 全 部 操作 -> 
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</class> 
</hibernate-mapping> 


上 面 的 映射 文件 的 粗 体 字 代码 映射 了 N-1 的 关联 关系 ， 并 指定 了 Hibermate 对 Person 实体 的 全 部 
(all) 持久 化 操作 都 将 级 联 到 关联 试题 ， 还 指定 了 增加 的 外 键 列 的 列 名 等 信息 。 

因为 Address 一 端 无 须 访问 Person 端 , 所 以 Address 类 的 映射 文件 无 须 任何 改变 。 下 面 是 Address 
类 的 映射 文件 的 代码 。 

程序 清单 :codes\06\6.1\unidirectional\N-1nojointable\src\org\crazyit\app\domain\Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN™ 
"http://wuw.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!1-- Address 持久 化 类 --> 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressid --> 
<id name="addressId" column="address_id"> 
<!-- 指定 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 addressDetail --> 
<property name="addressDetail"/> 
</class> 
</hibernate-mapping> 


经 过 上 面 的 映射 后 ， 我 们 可 以 使 用 如 下 代码 来 保存 Person 和 Address 实体 。 


private void testPerson() 
{ 
Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction(); 
// 创 建 一 个 Person 对 象 
Person p = new Person(); 
// 创 建 一 个 瞬 态 的 Address 对 象 
Address a = new Address(" 广 州 天 河 "); /©® 
// 设 置 Person 的 Name 为 Yeeku 字符 串 
p.setName ("Yeeku") ; 
p.setAge(29); 
// 设 置 Person 和 Address 之 间 的 关联 关系 
p.setAddress (a); 
// 持 久 化 Person 对 象 
session.persist (Pp); 
// 创 建 一 个 钥 态 的 Address 对 象 


Address a2 = new Address ("上海 虹口 "); /1@ 
// 修 改 持久 化 状态 的 Person 对 象 
p.setAddress (a2); 1/® 


tx.commit ()» 
HibernateUtil.closesession(); 
} 


上 面 的 程序 创建 了 三 个 持久 化 实体 ， 即 一 个 Person 对 象 ， 两 个 Address 对 象 ， 程 序 只 在 粗 体 字 代 
码 行 保存 了 一 次 Person 对 象 ， 从 来 不 曾 保存 过 Address 对 象 。 

程序 在 号 代码 处 创建 了 一 个 瞬 态 的 Address 对 象 ， 当 程序 执行 到 粗 体 字 代 码 处 时 ， 系 统 准备 保 
存 Person 对 象 ， 系 统 将 要 向 person_inf 数据 表 中 插入 一 条 记录 一 一 但 该 记录 参照 的 主 表 记 录 还 不 曾 保 
存 被 参照 的 Address 实体 还 处 于 瞬 态 )， 这 时 可 能 有 如 下 两 种 情况 发 生 。 

> ”系统 抛 出 TransientObjectException 异常 :object references an unsaved transient instance，, 

因为 主 表 记录 不 曾 插入 ， 所 以 参照 该 记录 的 从 表 记 录 无 法 插入 。 
> ”系统 先 自动 级 联 插入 主 表 记 录 ， 再 插入 从 表 记 录 。 
因为 上 面 的 映射 文件 中 指定 了 cascade="all"， 这 意味 着 系统 将 先 自动 级 联 插入 主 表 记录 ， 也 就 是 
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先 持久 化 Address 对 象 ,再 持久 化 Person 对 象 .也 就 是 说 ,Hibernate 在 粗 体 字 代 码 处 将 先 执行 一 条 insert 
into address.… 语 句 ， 再 执行 一 条 insert into person.… 语 句 。 

换 一 个 方向 来 说 ， 如 果 上 面 的 映射 文件 缺少 cascade="all"， 则 程序 运行 到 粗 体 字 代码 处 将 抛 出 
TransientObjectException 异常 。 


程序 在 @ 号 代码 处 再 次 创建 了 一 个 瞬 态 的 Address 对 象 ， 但 当 程序 执行 到 @ 号 代码 处 时 ， 程 序 将 
瞬 态 的 Address 对 象 关联 到 持久 化 状态 下 的 Person 对 象 。 类 似 地 ， 系 统 也 会 持久 化 Address 对 象 ， 再 
建立 Address 对 象 和 Person 对 象 之 间 的 关联 。 也 就 是 说 ，Hibernate 在 @ 号 代码 处 先 执行 一 条 insert into 
address… 语 名 插入 记录 ， 再 执行 update person.… 修 改 该 Person 记录 的 外 键 值 。 

程序 执行 结束 后 ，address 和 person 两 个 数据 表 的 记录 如 图 6.1 所 示 。 


图 6.1 person_inf 和 address_inf 数据 表 的 记录 


提 
Fa 虽然 Hibernate 号 称 一 个 持久 层 的 全 面 解决 方案 ， 使 用 Hibernate 可 以 完全 代替 JpBc, | 


但 如 果 不 了 解 底层 的 SQL 机 制 ， 实 际 上 是 很 难 用 好 Hibernate 的 。 在 所 有 了 既 有 的 基于 外 键 | 
| ”约束 的 关联 关系 中 ， 都 必须 牢记 : 要 么 总 是 先 持久 化 主 表 记 录 对 应 的 实体 ， 要 么 设置 级 联 ， 
: ”操作 ; 否则 当 Hibernate 试图 插入 从 表 记 录 时 ,如 果 发 现 该 从 表 记录 参照 的 主 表 记 录 不 存在 ，| 
| 。 那 一 定 会 抽出 异常 。 


6.1.1.2 ”有 连接 表 的 N 一 1 关联 
对 于 绝 大 部 分 单 向 N- 1 关联 而 言 ， 使 用 基于 外 键 的 关联 映射 已 经 足够 了 。 但 由 于 底层 数据 库 建 
模 时 也 可 以 使 用 连接 表 来 建立 这 种 关联 关系 ， 因 此 Hibemate 也 为 这 种 关联 关系 提供 了 支持 。 
如 果 需 要 使 用 连接 表 来 映射 单 向 N- 1 关联 ， 则 需要 显 式 使 用 <join... 亿 元素， 该 元 素 用 于 强制 将 一 
个 类 的 属性 映射 到 多 张 表 中 , 通常 也 用 于 强制 使 用 连接 表 。 使 用 <join.. 人 > 元 素 时 通常 需要 指定 一 个 table 
属性 ， 用 于 指定 连接 表 的 表 名 。 除 此 之 外 ，<join... 人 > 元 素 还 支持 如 下 几 个 可 选 属性 。 
> schema: 指定 此 连接 表 所 在 的 Schema， 用 于 覆盖 根 元 素 的 default-schema 属性 。 
> 。 catalog: 指定 此 连接 表 所 在 的 Catalog， 用 于 覆盖 根 元 素 的 default-catalog 属性 。 
> inverse: 该 属性 默认 值 是 false， 如 果 设 置 为 tue， 则 Hibernate 不 会 插入 或 者 更 新 此 连接 
定义 的 属性 。 
> ”optional: 该 属性 默认 值 是 false。 如 果 将 属性 设 为 tue， 则 Hibernate 只 会 在 此 连接 定义 的 
属性 非 空 时 插入 一 行 数 据 ， 并 且 总 是 使 用 外 连接 来 得 到 该 属性 。 
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使 用 <join... 信 元 素 映射 连接 表 时 还 需要 外 键 关联 ， 应 在 配置 文件 中 增加 <key... 人 > 子 元 素来 映射 外 
键 ， 并 为 join 元 素 增加 <many-to-one.…/> 子 元 素 ， 用 于 映射 N- 1 的 关联 实体 。 该 <many-to-one.…/> 子 元 
素 的 用 法 与 不 使 用 连接 表 的 <many-to-one.… 人 > 子 元 素 的 用 法 完全 相同 。 

下 面 是 使 用 有 连接 表 的 N- 1 的 映射 文件 代码 。 

程序 清单 : codes\06\6.1\unidirectional\N-1withjointable\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!1DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 -> 
<id name="id" column="person_id"> 
<!-~ 定义 主键 生成 器 策略 一 > 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 -一 > 
<property name="name" type="string"/> 
<property name~"age" type="int"/> 
<!-- 使 用 join 元 素 强 制 使 用 连接 表 --> 
<join table="person_address" > 
<!-- 映射 连接 表 中 参照 本 表 主键 的 外 键 列 --> 
<key column="person_id"/> 
<!-- 映射 连接 表 中 参照 关联 实体 的 外 键 列 一 -> 
<many-to-one name="address" cascade="all" 
class="Address" column="address_id"/> 
</join> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 的 粗 体 字 代码 完成 了 有 连接 表 的 N- 1 关联 映射 , 至 于 Address 类 的 映射 文件 则 无 
须 进 行 任何 修改 ， 主 程序 也 无 须 任何 修改 。 程 序 运行 结束 后 ， 将 看 到 person_inf 数据 表 中 无 须 增加 额 
外 的 外 键 列 ,程序 将 会 使 用 连接 表 来 标识 person_inf 表 和 address_inf 表 之 间 的 关联 关系 ,person_address 
表 的 数据 如 图 6.2 所 示 。 


ysql> select * from person_address 


9 


person_id 


图 6.2 使 用 关联 表 映 射 N 一 1 关联 


在 这 种 映射 策略 下 ，person_id 列 既 作为 外 键 列 参照 person_inf 表 的 person_id 主键 列 ， 也 作为 
person_address 连接 表 的 主键 列 ， 这 就 保证 了 person_address 数据 表 中 person_id 列 不 能 出 现 重复 值 ， 
即 保证 了 一 个 Person 实体 最 多 只 能 关联 一 个 Address 实体 。 


》>》>6.1.2 单身 1 一 1 关联 


对 于 单 向 的 1 - 1 关联 关系 ， 需 要 在 持久 化 类 里 为 关联 实体 的 引用 属性 增加 setter 和 getter 方法 。 
从 持久 化 类 上 来 看 ， 单 向 1 - 1 与 单 向 N- 1 没有 丝毫 区 别 。 因 为 X 的 一 端 , 或 者 1 的 一 端 都 是 直接 访 
问 关联 实体 ， 只 需 增加 关联 实体 属性 的 setter 和 getter 方法 即 可 。 

事实 上 , 单 向 1- 1 与 N- 1 的 映射 配置 也 非常 相似 。 只 需要 原 有 的 <many-to-one.. 亿 元素 增 加 unique= 
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"te" 属 性 ， 用 以 表示 N 的 一 端 必须 唯一 即 可 。 既 然 N 的 一 端 增 加 了 唯一 约束 ， 那 么 就 成 为 1 - 1 了 。 


6.1.2.1 基于 外 键 的 单 向 1 一 1 
将 无 连接 表 的 N- 1 关联 映射 中 的 <many-to-one.… 放 元 素 里 增加 unique="true" 属 性 ， 即 可 完成 这 种 


映射 。 下 面 是 映射 文件 代码 。 
程序 清单 : codes\06\6.1\unidirectional\1-1FK\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DocTYPE hibernate-mapping PUBLIC 

"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 

"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 

<!-- 映射 Person 持久 化 类 --> 

<class name="Person" table="person_inf"> 

<!-- 映射 标识 属性 --> 


<id name="id" column="person_id"> 


ype’ / 
<!-- 用 于 映射 1-1 关联 实体 ， 指 定 关 联 实体 类 为 address 
指定 外 键 列 名 为 address_id, 并 指定 级 联 全 部 操作 一 -> 
<many-to-one name="address" cascade="all" 
unique="true" class="Address" column="address_id"/> 


</class> 
</hibernate-mapping> 


上 面 的 映射 文件 为 <many-to-one.../> 元 素 增加 了 unique="true"， 如 粗 体 字 代 码 所 示 ， 这 将 意味 着 在 
person_inf 表 的 address_id 外 键 列 上 增加 唯一 约束 一 一 这 实际 上 就 形成 了 单 向 的 1 一 1 关联 。 图 6.3 显 
示 了 Hibernate 创建 的 person_inf 数据 表 。 


person_ id intll) 
name varchar (255) 
age int (11) 


图 6.3 为 address_id 外 键 列 增加 唯一 约束 的 person_inf 表 


6.1.2.2 ”有 连接 表 的 单 向 1 一 1 
虽然 这 种 情况 很 少见 ， 但 Hibernate 同样 允许 这 样 采用 连接 表 映 射 单 向 1 - 1 关联 。 有 连接 表 的 1 
- 1 关联 同样 只 需要 将 有 连接 表 的 N - 1 中 的 <many-to-one... 人 > 元 素 增加 unique="true" 属 性 即 可 。 映 射 


文件 如 下 。 
程序 清单 : codes\06\6.1\unidirectional\1-1withjointable\src\ org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信 息 --> 
<!DOCTYPE hibernate-mapping PUBLIC : 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 


<!1- 映射 标识 属性 --> 
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<id name="id” column="person_id"> 
<!-- 定义 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!--~ 使 用 join 元 素 强制 使 用 连接 表 --> 
<join table="person_address" > 
<!-- 映射 连接 表 中 参照 本 表 主键 的 外 键 列 --> 
<key column="person_id"/> 
<!-- 映射 连接 表 中 参照 关联 实体 的 外 键 列 -> 
<many-to-one name="address" cascade="all” 
unique="true" class="Address" 
column="address_id"/> 
</join> 
</class> 


</hibernate-mapping> 

增加 了 unique="true" 属 性 之 后 ，Hibernate 将 会 为 address_id 外 键 列 增加 唯一 约束 ， 这 就 保证 了 一 
条 address 记录 最 多 只 能 关联 一 个 Person 实体 ， 从 而 将 原来 的 N 一 1 关联 改 为 1 一 1 关联 。 

6.1.2.3 ”基于 主键 的 单 向 1 一 1 

1-1 的 关联 可 以 基于 主键 关联 ， 基 于 主键 关联 的 持久 化 类 不 能 拥有 自己 的 主键 生成 器 策略 ， 它 的 
主键 由 关联 实体 来 负责 生成 。 

采用 基于 主键 的 1 - 1 关联 时 ， 应 使 用 <one-to-one... 人 > 元 素来 映射 关联 实体 ， 配 置 <one-to-one.… 伺 
元 素 时 需 指定 一 个 name 属性 ， 其 值 为 关联 实体 属性 的 属性 名 。 除 此 之 外 ， 该 元 素 还 可 接受 如 下 几 个 
可 选 属性 。 


> 
> 


class: 该 属性 指定 关联 实体 的 全 限定 类 名 ， 默 认 是 通过 反射 得 到 该 属性 所 属 类 的 类 名 。 
cascade: 该 属性 指定 哪些 操作 会 从 主 表 记 录 级 联 到 子 表 记录 。 

constrained: 表明 该 类 对 应 的 表 ， 和 被 关联 的 对 象 所 对 应 的 数据 库 表 之 间 ， 通 过 一 个 外 键 引 
用 对 主键 进行 约束 。 这 个 选项 影响 save() 和 delete() 在 级 联 执行 时 的 先后 顺序 ， 以 及 决定 该 
关联 能 否 被 委托 〈 也 在 schema export tool 中 被 使 用 ) 。 

fetch: 该 属性 设置 抓 取 策略 ， 该 属性 接受 join 〈 外 连接 抓 取 ) 和 select (选择 抓 取 ) 两 个 值 
的 其 中 之 一 。 

property-ref: 指定 关联 类 的 一 个 属性 ， 这 个 属性 将 会 和 本 类 的 主键 相对 应 。 如 果 没 有 指定 ， 
默认 使 用 对 方 关联 类 的 主键 。 

access: 指定 Hibernate 访问 该 关联 属性 的 访问 策略 ， 默 认 是 property。 

lazy: 指定 引用 关联 实体 的 延迟 加 载 特性 ， 该 属性 只 能 接受 false、proxy、no-proxy 三 个 值 。 
该 属性 默认 值 是 proxy。 实 际 上 ，Hibernate 默认 会 启动 单 实例 关联 ( 即 多 对 一 、 一 对 一 ) 的 
代理 ， 指 定 no-proxy 即 要 求 该 属性 应 该 在 实例 变量 第 一 次 被 访问 时 采用 延迟 抓 取 ， 
lazy="false" 指 定 此 关联 实体 总 是 被 预先 抓 取 。 


下 面 是 基于 主键 的 1 - 1 关联 策略 的 映射 文件 。 
程序 清单 :codes\06\6.1\unidirectional\1-1PK\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 


"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 


<hibernate-mapping package="org.crazyit.app.domain"> 


<!-- 映射 Person 持久 化 类 -> 
<class name="Person" table="person_inf"> 
<!- 映射 标识 属性 person_id --> 


<id name="id" column="person_id"> 
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<!-- ”基于 主键 关联 时 ， 主 键 生成 策略 是 foreign， 
表明 根据 关联 类 的 主键 来 生成 该 实体 的 主键 一 > 
tor class="foreign"> 
<!-- 指定 引用 关联 实体 的 属性 名 --> 
<param name="property">address</param> 
</generator> 
</id> 
<!-- 用 于 映射 普通 属性 一 > 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 下 面 映射 基于 主键 的 1 一 1 关联 --> 
<one-to-one name="address"/> 
</class> 
</hibernate-mapping> 


上 面 的 文件 中 粗 体 字 代码 是 配置 基于 主键 的 1 - 1 关联 的 关键 代码 ， 当 采用 这 种 关联 映射 策略 时 ， 
person 表 将 作为 从 表 ， 此 时 person 表 的 主键 将 没有 自己 的 主键 生成 策略 ， 因 为 person 表 里 记录 的 主键 
将 会 与 主 表 (address) 里 记录 的 主键 保持 一 致 。 


>》>6.1.3 单 向 1-N 关联 


单 向 1-N 关 联 的 持久 化 类 发 生 了 改变 , 持久 化 类 里 需要 使 用 集合 属性 。 因为 1 的 一 端 需 要 访问 N 
的 一 端 ， 而 N 的 一 端 将 以 集合 〈Set) 形式 表现 。 从 这 个 意义 上 来 看 ，1 - N 实 际 上 还 包括 N-N) 和 
前 面 的 集合 映射 非常 相似 ， 只 是 将 前 面 用 于 映射 集合 元 素 的 <element.. 人 > 元 素 改 为 使 用 
<one-to-many,.. 人 > 元 素 。 
使 用 <one-to-many.… 户 元 素 可 以 指定 如 下 两 个 可 选 属性 。 
> class 属性 ;该 属性 指定 了 关联 实体 的 类 型 ， 默 认 通过 反射 来 获取 关联 实体 的 类 型 ， 如 果 集 
合 属性 没有 使 用 泛 型 ， 则 必须 指定 该 属性 。 
> not-found: 该 属性 值 只 能 是 exception 或 ignore, 指定 当 从 表 记 录 参 照 的 主 表 记录 不 存在 时 ， 
Hibernate 如 何 处 理 这 种 情况 。 该 属性 值 默认 是 exception， 即 抛 出 一 个 异常 ， 如 果 程序 希望 
Hibernate 忽略 这 个 异常 ， 可 以 指定 not-found="ignore"。 
对 于 单 向 的 1-N 关 联 关系 ,只 需要 在 1 的 一 端 增加 Set 类 型 的 属性 , 该 属性 记录 当前 实体 的 关联 
实体 ， 当 然 还 要 为 这 个 Set 类 型 的 属性 增加 setter 和 getter 方法 即 可 ， 将 Person 类 修改 为 如 下 形式 。 
程序 清单 :codes\06\6.1\unidirectional\1-Nnojointable\src\org\crazyit\app\domain\Person.java 
public class Person 
// 标 识 属性 
private Integer id; 
//Person 的 name 属性 
private String name; 
// 保 留 Person 的 age 属性 
private int age; 
//1 一 N 关 联 关系 ， 使 用 Set 来 保存 关联 实体 
private Set<Address> addresses 


= new HashSet<Address>(); 
// 省 略 id 属性 的 setter 和 getter 方法 


/7/ 省 略 name 属性 的 setter 和 getter 方法 
7/ 省 略 age 属性 的 setter 和 getter 方法 


//addresses 属性 的 setter 和 getter 方 法 
Public void setahddresses (Set<hddress> addresses) 
{ 
this.addresses = addresses; 
} 
public Set<Rddress> getAddresses() 
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{ 
return this.addresses; 
$ 
} 


上 面 Person 类 增加 了 一 个 Set 属性 ， 该 Set 属性 保存 了 多 个 Address 实体 ， 也 就 是 一 个 Person 实 
体 可 以 关联 多 个 Address 实体 。 单 从 持久 化 类 代码 来 看 ， 不 管 Person 是 引用 多 个 值 对 象 的 Address 对 
象 ， 还 是 引用 多 个 持久 化 的 Address 对 象 ， 二 者 并 没有 区 别 。 
因为 Address 类 无 须 访问 Person 对 象 ， 所 以 程序 无 须 任 何 改变 。 

和 
蕉 -注意 :和 一 
在 本 示例 中 我 们 已 经 改变 了 Person 和 Address 的 关系 ， 此 时 我 们 设置 一 个 Person 实 by 


体 对 应 多 个 Address 实体 ， 程 序 依然 从 Person 端 访问 Address 端 。 


6.1.3.1 无 连接 表 的 单 向 1 一 N 

对 于 1 -入 的 单 向 关联 ， 需 要 在 1 的 一 端 增加 对 应 的 集合 映射 元 素 ， 例 如 <set...>、<bag.…> (通常 
不 要 使 用 <list.…/> 元 素 ) 等 元 素 , 与 映射 集合 属性 类 似 , 必须 为 <set..>、<bag.…/> 等 集合 元 素 增加 <key…/> 
子 元 素 , 用 以 映射 外 键 列 。 与 集合 属性 不 同 的 是 ,建立 1 -入 关联 时 ,集合 中 的 元 素 使 用 <one-to-many..…/> 
来 映射 关联 实体 ， 而 不 是 使 用 <element.… 户 子 元 素 。 

下 面 是 Person 持久 化 类 的 映射 文件 。 

程序 清单 ，codes\06\6.1\unidirectional\1-Nnojointable\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 id --> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 映射 集合 属性 ， 集 合 元 素 是 其 他 持久 化 实体 
没有 指定 cascade 属性 一 > 


</class> 
</hibernate-mapping> 


对 于 上 面 的 映射 文件 ， 我 们 映射 <set.. 人 > 元 素 时 没有 指定 cascade 属性 ， 在 默认 情况 下 ， 对 主 表 实 
体 的 持久 化 操作 不 会 级 联 到 从 表 实 体 。 

程序 使 用 如 下 代码 来 保存 一 个 Person 对 象 和 两 个 Address 对 象 ， 程 序 片段 如 下 。 

程序 清单 : codes\06\6.1\unidirectional\1-Nnojointable\src\lee\PersonManagerjava 


private void testPerson() 

{ 
Session session = HibernateUtil.currentSession{); 
Transaction tx = session.beginTransaction(); 


// 创 建 一 个 Person 对 象 
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Person p = new Person(); 
// 创 建 一 个 钥 态 的 Address 对 象 
Address a = new Address ("广州 天 河 "); 
7/ 必须 先 持久 化 Address 对 象 
session.persist (a); AO) 
// 设 置 Person 的 Name 为 Yeeku 字符 串 
p.setName ("Yeeku"); 
p.setAge (29); 
// 设 置 Person 和 Address 之 间 的 关联 关系 
p.getAddresses () .add (a); 
// 持 久 化 Person 对 象 
session. save (Pp); 
// 创 建 一 个 瞬 态 的 Address 对 象 
Rddress a2 = new Address ("上 海 虹口"); 
// 先 持久 化 Address 对 象 
session.persist (a2); //® 
// 收 改 持久 化 状态 的 Person 对 象 
Pp.getAddresses () .add (a2) ; 
tx.commit (); 
HibernateUtil. Closesession(); 

} 


上 面 的 程序 的 第 一 行 粗 体 字 代 码 持久 化 了 一 个 Person 对 象 ， 且 Person 对 象 关 联 了 一 个 Address 对 
象 ， 此 时 Hibernate 需要 完成 哪些 事情 呢 ? 

(1) 执行 insert into person_inf .语句 ， 向 Persod 数据 表 中 插入 一 条 记录 。 

(2) Hibernate 试图 执行 update address_inf 语句， 将 当前 person_inf 表 记 录 关 联 的 address_inf 表 
记录 的 外 键 修改 为 该 person_inf 表 记 录 的 主键 值 一 一 问题 是 ， 如 果 person_inf 表 中 被 参照 的 记录 不 存 
在 呢 ?” 如 果 程序 在 <set.../> 元 素 中 指定 了 cascade="all"， 则 Hibernate 先 执行 insert into person_inf... 语 句 
插入 一 条 person_inf 记录 ， 再 执行 一 条 update address_inf. 语 句 来 修改 这 条 记录 。 

正如 上 面 的 程序 看 到 的 ， 由 于 配置 <set.. 人 > 元 素 时 没有 指定 cascade="all"， 因 此 程序 对 Person 实体 
的 持久 化 操作 不 会 级 联 到 关联 的 Address 实体 ， 程 序 必须 显 式 持久 化 两 个 Address 实体 ， 如 上 @、@ 
号 代码 所 示 。 

从 上 面 的 执行 过 程 可 以 看 出 ， 虽 然 上 面 程序 仅仅 需要 为 Person 实体 增加 一 个 关联 Address 实体 ， 
但 Hibernate 会 采用 两 条 SQL 语句 来 完成 : 一 条 insert 语句 插入 一 条 外 键 为 null 的 address_inf 记录 ， 

-条 update 语句 来 修改 刚刚 插入 的 address 记录 一 一 这 肯定 会 造成 系统 性 能 不 好 。 

造成 这 种 现象 的 根本 原因 是 :从 Person 到 Address 的 关联 (外 键 person_id) 没有 被 当做 Address 
对 象 状态 的 一 部 分 (程序 是 通过 把 Address 实体 添加 到 Person 实体 的 addresses 集合 属性 中 , 而 Address 
实体 并 不 知道 它 所 关联 的 Person 实体 )， 因 而 Hibernate 无 法 在 执行 insert address_inf 语句 时 为 该 外 键 
列 指 定 值 。 

为 了 解决 这 个 问题 的 思路 ， 程 序 必须 在 持久 化 Address 实体 之 前 ， 让 Address 实体 能 “知道 ” 它 
所 关联 的 Person 实体 ， 也 就 是 应 该 通过 address.setPerson(person); 方 法 来 建立 关联 关系 一 一 这 就 需要 把 
这 个 关联 关系 添加 到 Address 的 映射 中 一 一 这 就 变 成 1 - N 双向 关联 。 因 此 我 们 推荐 ， 尽 量 少 用 1 一 N 
单 向 关联 ， 而 是 改 为 使 用 1 -入 双向 关联 。 

对 于 双向 的 1 - N 父子 关联 ， 使 用 1 的 一 端 控制 关系 的 性 能 ， 比 使 用 N 的 一 端 控制 关系 的 性 能 低 。 
性 能 低 的 原因 是 当 使 用 1 的 一 端 控制 关联 关系 时 ， 由 于 插入 数据 时 无 法 同时 插入 外 键 列 ， 因 此 会 额外 
多 出 一 条 update 语句 ， 而 且 外 键 列 还 无 法 增加 非 空 约束 

6.1.3.2 ”有 连接 表 的 单 向 1 一 N 

对 于 有 连接 表 的 1 -入 关联 上 映射， 映射 文件 不 再 使 用 <one-to-many.… 人 > 元 素 映射 关联 实体 ， 而 是 使 
用 <many-to-many.… 信 元素， 但 为 了 保证 当前 实体 是 1 的 一 端 ， 因 此 要 为 元 素 指定 unique="true"。 

使 用 <many-to-many.… 户 元素 时 还 可 指定 如 下 儿 个 可 选 属性 。 

> class: 指定 关联 实体 的 类 名 ， 默 认 由 Hibernate 通过 反射 来 获取 该 类 名 。 
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> ”not-found: 该 属性 指定 当 外 键 参照 的 主 表 记录 不 存在 时 如 何 处 理 。 该 属性 只 接受 ignore 和 
exception 两 个 值 ， 默 认 是 exception， 即 不 存在 时 抛 出 异常 ， 如 果 程序 希望 Hibernate 忽略 
这 个 异常 ， 则 可 指定 该 属性 值 为 ignore。 

> ”formula: 指定 一 个 SQL 表达 式 ， 该 外 键 值 将 根据 该 SQL 表达 式 来 计算 。 

> ”outer-join: 指定 Hibernate 是 否 要 启动 外 连接 来 抓 取 关联 实体 ,该 属性 只 能 是 true、false 和 
auto 三 个 值 之 一 ， 其 中 true 表示 启用 ，false 表示 不 启用 ，auto 表示 由 程序 来 决定 。 

> ”fetch: 该 属性 指定 Hibernate 的 抓 取 策略 ， 该 属性 值 只 能 是 join (使 用 外 连接 抓 取 ) 和 select 
《使 用 选择 抓 取 ) 两 个 值 的 其 中 之 一 。 

> ”lazy: 指定 Hibernate 是 否 需要 启动 延迟 加 载 来 加 载 关 联 实体 。 

> ”unique: 指定 本 持久 化 实体 是 否 增加 唯一 约束 ， 默 认 是 false。 

> ”where: 该 属性 指定 一 个 SQL 表达 式 ， 指 定 当 查询 、 获 取 关 联 实体 时 的 过 滤 条 件 ， 只 有 满足 
该 where 条 件 的 关联 实体 才 会 被 加 载 。 

> ”order-by: 该 属性 用 于 设置 数据 库 对 集合 元 素 排序 , 该 属性 仅 对 1.4 或 更 高 版 本 的 JDK 有 效 。 
该 属性 的 值 为 指定 表 的 指定 字段 〈 一 个 或 几 个 ) 加 上 asc 或 者 desc 关键 字 ， 这 种 排序 是 数 
据 库 执行 SQL 查询 时 进行 的 排序 ， 而 不 是 直接 在 内 存 中 排序 。 

> ”property-ref: 指定 关联 类 的 一 个 属性 ， 这 个 属性 将 会 和 本 类 的 外 键 相对 应 ( 当 外 键 参照 唯一 
键 时 需 指 定 该 属性 ) 。 如 果 没 有 指定 ， 直 接 使 用 对 方 关联 类 的 主键 。 

下 面 是 映射 Person 类 的 映射 文件 。 

程序 清单 ，codes\06\6.1\unidirectional\1-Njointable\src\org\crazyit\app\domain\Person.hbm.xml 

<?xml version="1.0" encoding="GBK"?> 

<!-- 指定 Hibernate 的 DTD 信息 --> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 

<!-- 映射 标识 属性 id --> 


<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name=" " type="int"/> 
<!-- 映射 集合 属性 ， 集 合 元 素 是 其 他 持久 化 实体 
指定 连接 表 的 表 名 --> 
<aet name="addresses" table="person_address"> 
<!-- 指定 连接 表 中 参照 本 胡 记 录 的 外 键 列 名 --> 
<key column="person_id" /> 
<!-- 使 用 many-to-many 来 映射 1 一 N 关联 ， 
增加 unique="true” --> 
‘<nany-to-many class="Address" column="address_id" 
unique="true"/> 


</set> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 的 粗 体 字 代码 完成 了 1 - N 的 有 连接 表 映 射 ， 当 程序 需要 保存 一 个 Person 对 象 、 
两 个 Address 对 象 , 并 建立 该 Person 对 象 和 这 两 个 Address 对 象 的 关联 关系 时 , 程序 依然 需要 5 条 SQL 
语句 ,只 是 这 5 条 SQL 语句 都 是 insert 语句 一 一 其 中 两 条 用 于 向 连接 表 插 入 记录 ， 从 而 建立 Person 和 
Address 之 间 的 关联 关系 。 
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>>6.1.4 单 向 N-N 关联 


单 向 的 N-N 关 联 和 1 -入 关联 的 持久 化 类 代码 完全 相同 , 控制 关系 的 一 端 需 要 增加 一 个 Set 类 型 


的 属性 ， 被 关联 的 持久 化 实例 以 集合 形式 存在 。 

N-N 关联 必须 使 用 连接 表 ，N - N 关联 与 有 连接 表 的 1 - N 关联 非常 相似 ， 只 要 去 掉 
<many-to-many.… 户 元 素 的 unique="true" 属 性 即 可 。 

下 面 是 单 向 N- 入 关 联 的 映射 文件 。 

程序 清单 :codes\06\6.1\unidirectional\N-N\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 id --> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 一 > 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-~ 映射 集合 属性 ， 集 合 元 素 是 其 他 持久 化 实体 
指定 连接 表 的 : 


-> 


<set name=", table="person_address"> 
<!-- 指定 连接 表 中 参照 本 表 记 录 的 外 键 列 名 -> 
<key column="person_id" /> 
<!-- 使 用 many-to-many 来 映射 N 一 关联 --> 
<many-to-many class="Address" column="address_id"/> 

</set> 
</class> 
</hibernate-mapping> 


从 上 面 的 粗 体 字 代码 映射 的 <set.. 人 > 元 素 可 以 看 出 ， 其 <many-to-many.. 人 > 子 元 素 不 再 有 
unique="true" 属 性 ， 这 就 完成 了 N- N 的 关联 映射 。 


》》6.1.5 双向 1-N 关联 


对 于 1 -N 关 联 ，Hibemate 推荐 使 用 双向 关联 ， 而 且 不 要 让 1 的 一 端 控制 关联 关系 ， 而 使 用 N 的 


- 端 控制 关联 关系 。 
双向 的 1 -入 关联 与 N- 1 关联 是 完全 相同 的 两 种 情形 ， 两 端 都 需要 增加 对 关联 属性 的 访问 ，N 的 


- 端 增加 引用 到 关联 实体 的 属性 ，1 的 一 端 增加 集合 属性 ， 集 合 元 素 为 关联 实体 。 
如 下 是 Person 持久 化 类 的 源 代码 。 
程序 清单 ，codes\06\6.1\bidirectiona\1-Nnojointable\src\org\crazyit\app\domain\Person.java 
public class Person 


// 标 识 属性 
private Integer id; 
//Person 的 name 属性 
private String name; 
// 保 留 Person 的 age 属性 
private int age; 
//1 一 N 关联 关系 ， 使 用 Set 来 保存 关联 实体 
Private Set<Address> addresses 
= new HashSset<Address>(); 
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7/ 省 赂 id 属性 的 setter 和 getter 方法 
177 省略 name 属性 的 setter 和 getter 方法 
77 省 略 age 属性 的 setter 和 getter 方法 


/1addresses 属性 的 setter 和 getter 方 法 
public void sethddresses (Set<Address> addresses) 
this.addresses = addresses; 
od Set<Address> getAddresses() 
return this.addresses; 
i 


上 面 的 Person 类 增加 了 一 个 Set 集合 属性 ， 用 于 记录 它 关 联 的 系列 Address 实体 ， 而 Address 端 
则 只 需 增加 一 个 Person 类 型 的 属性 , 这 表明 Person 和 Address 存在 1 -NN 的 关联 关系 。 下 面 是 Address 


的 持久 化 类 的 代码 片段 。 
程序 清单 : codes\06\6.1\bidirectional\1-Nnojointable\src\org\crazyit\app\domain\Address.java 
public class Address 


{ 
// 标 识 属性 
private int addressId; 
// 地 址 详细 信息 
private String addressDetail; 
// 记 录 关 联 实体 的 person 属性 
Pprivate Person person; 
// 无 参数 的 构造 器 
public Address() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Rddress(String addressDetail) 
{ 
this,addressDetail = addressDetail; 


} 
// 省 略 addressId 属性 的 setter 和 getter 方法 
7/ 省 略 addressDetail 属性 的 setter 和 getter 方 法 


7//person 属性 的 setter 和 getter 方 法 
public void setPerson(Person person) 
: this.person = person; 
i Person getPerson() 
; return this.person; 

0 


定义 了 上 面 的 持久 化 类 代码 之 后 ， 就 可 以 通过 映射 文件 来 定义 这 种 1 - N 的 双向 关联 映射 了 ， 
Hibernate 同样 对 这 种 双向 关联 映射 提供 了 两 种 支持 : 有 连接 表 的 和 无 连接 表 的 。 大 部 分 时 候 ， 对 于 1 


一 入 的 双向 关联 映射 ， 使 用 无 连接 表 的 映射 策略 即 可 。 
6.1.5.1 无 连接 表 的 双向 1 一 N 关联 


无 连接 表 的 双向 1 - N 关联 ， 需 要 同时 修改 两 个 持久 化 类 的 配置 文件 。N 的 一 端 需 要 增加 <many- 
to-one... 人 > 元 素来 映射 关联 属性 ， 而 1 的 一 端 则 需要 使 用 <set... 记 或 <bag... 人 > 元 素来 映射 关联 属性 。 
<set... 人 > 或 <bag... 伺 元素 里 需要 增加 <key.. 人 > 子 元 素 映射 外 键 列 ， 并 使 用 <one-to-many.…. 人 > 子 元 素 映射 关 


联 属性 。 
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底层 数据 库 为 了 记录 这 种 1 - N 关联 关系 ， 实 际 上 只 需要 在 N 的 一 端的 数据 表 里 增 加 一 个 外 键 列 
即 可 。 这 里 就 存在 一 个 问题 : 双向 映射 时 <many-to-one... 亡 元素 将 映射 到 外 键 列 ， 而 <set,.. 亿 元 素 里 的 
<key.. 人 > 子 元 素 也 用 于 映射 外 键 列 ， 其 他 的 都 映射 同一 列 ， 因 此 映射 文件 应 为 这 两 个 元 素 指定 column 
属性 ， 并 让 两 个 column 属性 值 相同 。 

前 面 已 经 提 到 ， 对 于 双向 的 1 -入 关联 映射 ,通常 不 应 该 允许 1 的 一 端 控 制 关联 关系 ,而 应 该 由 入 
的 一 端 来 控制 关联 关系 ,此 时 我 们 可 以 在 <set..… 记 元 素 中 指定 inverse="true", 用 于 指定 1 的 一 端 不 控制 
关联 关系 。 

下 面 是 Person 类 的 映射 文件 。 

程序 清单 : codes\06\6.1\bidirectional\1-Nnojointable\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!1DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://wuw.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person” table="person_inf"> 
<!-- 映射 标识 属性 id --> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 -> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 映射 集合 属性 ， 集 合 元 素 是 其 他 持久 化 实体 
没有 指定 cascade 属性 ， 指 定 不 控制 关联 关系 --> 
<set name="addresses" inverse="true"> 
<!-- 指定 关联 的 外 键 列 -> 
<key column="person_id"/> 
<!-~ 用 以 映射 到 关联 类 属性 -> 
<one-to-many class="Addrese"/> 
</set> 
</class> 
</hibernate-mapping> 


而 Address 类 的 映射 文件 则 比较 简单 ， 它 只 需 增 加 <many-to-one.…. 人 > 元 素来 映射 关联 实体 即 可 ， 如 
果 为 了 保证 每 条 address_inf 记录 (从 表 记录 ) 都 有 关联 的 person_inf 记录 〈 主 表 记录 )， 则 可 为 该 元 
素 指定 not-null="true"。 下 面 是 Address 类 的 映射 文件 。 

程序 清单 :codes\06\6.1\bidirectional\1-Nnojointable\src\org\crazyit\app\domain\Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- Address 持久 化 类 --> 
<class name="Address" table="address_ inf"> 
<!-- 映射 标识 属性 addressId --> 
<id name="addressId" column="address_id"> 
<!-- 指定 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 
《<!- 必须 指定 列 名 为 person_id,， 
与 关联 实体 中 key 元 素 的 column 属性 值 相同 --> 
to-one name="person" class="Person™ 
Column="person_id" not-null="true"/> 
</class> 
</hibernate-mapping> 
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如 下 主 程序 用 于 保存 一 个 Person 对 象 和 两 个 Address 对 象 ， 并 设置 它们 的 关联 关系 。 
程序 清单 : codes\06\6.1\bidirectional\1-Nnojointable\src\lee\PersonManagerjava 


private void testPerson() 


{ 


Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction{); 
// 创 建 一 个 Person 对 象 

Person p = new Person(); 

// 设 置 Person 的 Name 为 Yeeku 字符 串 
p.setName ("Yeeku"); 

p.setAge (29); 

// 持 久 化 Person 对 象 (对 应 于 插入 主 表 记录 ) 
Session.save(P) 

// 创 建 一 个 瞬 态 的 Rddress 对 象 

Address a = new Address ("广州 天 河 "); 
// 先 设置 Person 和 Address 之 间 的 关联 关系 
a.setPerson (p); 

// 再 持久 化 Rddress 对 象 ( 对 应 于 插入 从 表 记录 ) 
session.persist (a); 

// 创 建 一 个 瞩 态 的 Rddress 对 象 

Address a2 = new hddress(" 上 海 虹口 ") ; 
// 先 设置 Person 和 hddress 之 间 的 关联 关系 
a2.setPerson (P) 

// 再 持久 化 address 对 象 (对 应 于 插入 从 表 记 录 ) 
session.persist (a2); 

tx.commit () 
HibernateUtil.closeSsession(); 

} 

上 面 的 主 程序 保存 了 一 个 Person 对 象 《 对 应 于 向 person 表 插入 一 条 记录 )， 又 保存 了 两 个 Address 
对 象 〈《 对 应 于 向 address 表 插 入 两 条 记录 )， 并 建立 该 Person 对 象 和 两 个 Address 对 象 的 关联 关系 。 为 
了 保证 较 好 的 性 能 (只 要 三 条 insert 语句 )， 主 程序 需要 注意 如 下 几 点 。 

> ”最 好 先 持久 化 Person 对 象 (或 该 Person 对 象 本 身 已 处 于 持久 化 状态 ) 。 因 为 我 们 希望 程序 

持久 化 Address 对 象 时 ，Hibernate 可 为 Address 的 外 键 属性 分 配 值 一 一 也 就 是 说 ， 向 
address_inf 数据 表 插入 记录 时 , 该 记录 的 外 键 列 已 指定 了 值 一 一 这 表明 它 参 照 的 主 表 记录 已 
存在 ， 也 就 是 Person 对 象 必须 已 被 持久 化 。 

> 先 设置 Person 和 Address 的 关联 关系 ， 再 保存 持久 化 Address 对 象 。 如 果 顺 序 反 过 来 ， 程 序 

持久 化 Address 对 象 时 ,该 Address 对 象 还 没有 关联 实体 , 所 以 Hibernate 不 可 能 为 对 应 记录 
的 外 键 列 指定 值 ; 等 到 设置 关联 关系 时 , Hibernate 只 能 再 次 使 用 update 语句 来 修改 关联 关系 。 

> 不 要 通过 Person 对 象 来 设置 关联 关系 ， 因 为 我 们 已 经 在 Person 映射 文件 的 <set.…/> 元 素 中 

指定 了 inverse="true"， 这 表明 Person 对 象 不 能 控制 关联 关系 。 

在 双向 的 1 - N 关联 中 ， 两 个 持久 化 类 的 配置 文件 都 需要 指定 外 键 列 的 列 名 ， 此 时 不 可 以 省 略 。 
因为 不 使 用 连接 表 的 1 - N 关联 必须 基于 外 键 关 联 ， 而 外 键 只 保存 在 N 的 一 端的 表 中 。 如 果 两 边 指定 
的 外 键 列 名 不 同 ， 将 导致 关联 映射 出 错 。 如 果 不 指定 外 键 列 的 列 名 ， 该 列 名 由 系统 自动 生成 ， 而 系统 
很 难保 证 自动 生成 的 两 个 列 名 相同 。 

6.1.5.2 ”有 连接 表 的 双向 1 一 N 关联 

有 连接 表 的 1 -入 双向 关联 类 似 于 NN- 入 关联 。1 的 一 端 使 用 集合 元 素 映射 ， 然 后 在 集合 元 素 里 增 
加 <many-to-many. 户 子 元 素 ， 该 子 元 素 映 射 到 关联 类 。 为 保证 该 实体 是 1 的 一 端 ， 应 该 为 
<many-to-many.. 户 元 素 增加 unique="true" 属 性 。N 的 一 端 则 使 用 <join... 人 > 元 素来 强制 使 用 连接 表 。 


否则 关联 映射 出 错 。 
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不 仅 如 此 ，N 的 一 端 使 用 <join.-. 亡 元素 强 制 使 用 连接 表 ， 因 此 将 使 用 <key.… 人 > 子 元 素来 映射 连接 表 
中 外 键 列 , 且 使 用 <many-to-one.… 人 > 来 映射 连接 表 中 关联 实体 的 外 键 列 ; 反 过 来 , 1 的 一 端 也 将 在 <set.…/> 
元 素 里 使 用 <key.. 户 和 <many-to-many... 人 > 两 个 子 元 素 ， 它 们 也 映射 连接 表 中 的 两 列 。 为 了 保证 得 到 正 
常 的 映射 关系 ， 应 保证 <join... 记 里 <key... 人 > 子 元 素 的 column 属性 和 <set.. 人 > 里 <many-to-many.… 人 > 元 素 的 
column 属性 相同 ， 并 保证 <join... 记 里 <many-to-one.…/> 子 元 素 的 column 属性 和 <set,../> 里 <key... 信 元 素 


的 column 属性 相同 。 
下 面 是 Person 类 的 映射 文件 。 
程序 清单 :codes\06\6.1\bidirectional\1-Njointable\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信 息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 占 射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 id --> 4 
<id name="id" column="person_id"> 
<! 一 定义 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 映射 集合 属性 ， 集 合 元 素 是 其 他 持久 化 实体 
没有 指定 cascade 属性 --> 
<set name="addresses" inverse="true" 
table="person_address"> 
<!-- 指定 关联 的 外 键 列 --> 
<key column="person_id"/> 
<!-- 用 以 映射 到 关联 类 属性 --> 


</set> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 指定 连接 表 为 person_address， 且 指定 连接 表 中 两 列 为 person_id 和 address_id, 所 
以 Address 映射 文件 中 连接 表 的 信息 也 应 该 与 此 相同 。 下 面 是 Address 映射 文件 的 代码 。 
程序 清单 ，codes\06\6.1\bidirectional\1-Njointable\src\org\crazyitiapp\domain\Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- Address 持久 化 类 --> 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressId --> 
<id name="addressId" column="address id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 


<!-- 显 式 使 用 join 元 素 确定 连接 表 --> 


<key column="address_id"/> 
<!-- 使 用 many-to-one 映射 N 一 1 关联 实体 --> 
<nmany-to-one name="person"™ 
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column="person_id" not-null="true"/> 
</join> 
</class> 
</hibernate-mapping> 


映射 文件 的 两 边 都 指定 了 两 个 外 键 列 ， 一 个 是 持久 化 类 实例 在 连接 表 中 的 外 键 列 名 ， 另 一 个 是 关 


联 属性 在 连接 表 中 的 外 键 列 名 。 一 定 要 保证 两 边 映射 的 外 键 列 名 对 应 相同 。 
6.1.6 双向 N 一 N 关联 


双向 N-NN 关 联 需要 两 端 都 使 用 Set 集合 属性 , 两 端 都 增加 对 集合 属性 的 访问 。 双 向 N 一 N 关联 没 


有 太 多 选择 ， 只 能 采用 连接 表 来 建立 两 个 实体 之 间 的 关联 关系 。 
下 面 是 Person 类 和 Address 类 的 代码 。 


程序 清单 :codes\06\6.1\bidirectional\N-N\src\org\crazyit\app\domain\Person.java 


public class Person 


// 标 识 属性 
private Integer id; 
//Person 的 name 属性 
private String name; 
// 保 留 Person 的 age 属性 
private int age; 
//1 一 N 关联 关系 ， 使 用 Set ich 
peiveee Set<Address> 
em et ’ 
1/ 省 略 1 id 1 属性 的 setter 和 getter 方法 


/77 省 略 name 属性 的 setter 和 getter 方法 
/7 省略 age 属性 的 setter 和 getter 方法 


//addresses 属性 的 setter 和 getter 方法 
public void setAddresses (Set<Address> addresses) 
{ 
this.addresses, = addresses; 
)， 
public Set<Address> getAddresses() 
{ 


return this.addresses; 
水 
} 


程序 清单 ，codes\06\6.1\bidirectional\N-N\src\org\crazyit\app\domain\Addressjava 


Public class Address 
{ 


// 标 识 属性 
private int addressId; 
// 地 址 详细 信息 
private String addressDetail; 
// 记 录 关联 实体 的 person 属性 
private Set<Person> persons 

= new Hashset<Person>(); 
// 无 参数 的 构造 器 
public Address() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Rddress(String addressDetail) 
{ 
this.addressDetail = addressDetail; 


} 
// 省 略 addressId 属性 的 setter 和 getter 方法 
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// 省 略 addressDetail 属性 的 setter 和 getter 方法 


//persons 属性 的 setter 和 getter 方 法 
public void setPersons (Set<Person> persons) 


{ 
this.persons = persons; 


} 
public Set<Person> getPersons () 
{ 
return this.persons; 
} 
} 


双向 N-N 关 联 的 持久 化 类 需要 在 两 边 都 增加 <set... 亿 元素， 用 于 映射 集合 属性 。<set../> 属 性 还 
应 该 增加 <key.…/> 子 元 素 用 以 映射 外 键 列 ，<set... 人 > 元 素 里 增加 <many-to-many.…./> 子 元 素来 映射 关联 
体 类 。 
下 面 是 双向 W- N 关 联 的 映射 文件 代码 。 
程序 清单 : codes\06\6.1\bidirectional\N-N\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 有 贞 射 Person 持久 化 类 --> 
<class name="Person” table="person_inf"> 
<!-- 贞 射 标识 属性 id --> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 一 > 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
映射 N- 昌 关联 实体 ， 两 边 的 table 属性 值 要 相同 
<set name="addresses" table="person_address"> 


<many-to-many class="Address" column="address_id"/> 
</set> 
</class> 
</hibernate-mapping> 


程序 清单 :codes\06\6.1\bidirectional\N-N\src\org\crazyit\app\domain \Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 3 
<!-~ 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- Address 持久 化 类 --> 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressId --> 
<id name="addressId" column="address_id"> 
<!-- 指定 主键 生成 器 策略 一 > 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 
<!-- 映射 N-N 关联 实体 ， 两 边 的 table 属性 值 要 相同 --> 
<set name="persons" table="person_address"> 
<!-- 指定 关联 的 外 键 列 -> 
<key column="address_id"/> ， 
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<!-- 用 以 映射 到 关联 类 属性 --> 


<many-to-many class="Address" 
column="person_id"/> 
</set> 
</class> 
</hibernate-mapping> 
i 
三- 注意 : 


双向 多 对 多 关联 的 两 边 都 需 指定 连接 表 的 表 名 、 外 键 列 的 列 名 .所 以 两 个 <set.. 人 > 元 
素 的 table 属性 的 值 必 须 指定 ， 而 且 必 须 相同 。<set./> 元 素 的 两 个 子 元 素 : <key…/> 和 | 
<many-to-many.. 人 > 都 必须 指定 column 属性 ，<key.. 人 > 和 <many-to-many.../> 分 别 是 指定 本 | 
持久 化 类 、 关 联 类 在 连接 表 中 的 外 键 列 名 ， 因 此 两 边 的 <key.../> 与 <many-to-many.../> 的 : 
column 属性 交叉 相同 ， 也 就 是 说 ， 一 边 的 <set.. 人 > 元 素 的 <key... 人 > 的 colomn 值 为 a， 
<many-to-many... 人 > 的 column 为 b， 则 另 一 边 的 <set.../> 元 素 的 <key... 人 > 的 column 值 为 b， 
-to-many..…/> 的 column 值 为 a 可 


<man 


》》6.1.7 双向 1--1 关 联 


双向 1 - 1 关联 需要 修改 两 边 的 持久 化 类 代码 , 让 两 个 持久 化 类 都 增加 引用 关联 实体 的 属性 ， 并 为 
该 属性 提供 setter 和 getter 方法 ， 此 处 不 再 球 述 两 个 持久 化 类 的 类 代码 。 
与 单 向 1- 1 关联 类 似 的 是 ， 双 向 1 - 1 关联 也 有 三 种 映射 策略 :基于 主键 、 基 于 外 键 、 使 用 连接 
表 。 下 面 分 别 介绍 这 三 种 映射 策略 。 
6.1.7.1 基于 外 键 的 双向 1 一 1 关联 
对 于 基于 外 键 的 1 - 1 关联 ， 外 键 可 以 存放 在 任意 一 边 。 需 要 存放 外 键 的 一 端 ， 需 要 增加 
<many-to-one.. 人 > 元 素 ,正如 前 面 介绍 的 , 为 <many-to-one... 人 > 元 素 增加 unique="true" 属 性 来 表示 该 实体 
实际 上 是 1 的 一 端 。 
对 于 1 - ! 的 关联 关系 ,两 个 实体 原本 处 于 平等 状态 ; 但 当 我 们 选择 任意 一 个 表 来 增加 外 键 后 〈 增 
加 <many-to-one... 亿 元 素 的 实体 端 )， 该 表 即 变 成 从 表 ， 而 另 一 个 表 则 成 为 主 表 。 
另 一 端 需 要 使 用 <one-to-one.… 亿 元 素 ， 该 <one-to-one... 人 > 元 素 需要 使 用 name 属性 指定 关联 属性 名 。 
为 了 让 系统 不 再 为 本 表 增 加 一 列 ， 而 是 使 用 外 键 关 联 ， 使 用 property-ref 属性 指定 引用 关联 类 的 属性 。 
下 面 的 映射 文件 配置 了 基于 外 键 的 双向 1 - 1 关联 。 
程序 清单 :codes\06\6.1\bidirectional\1-1FK\src\org\crazyit\app\domain\Person.hbm.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://wuw.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit,app. domain"> 
<!-- 映射 Person 持久 化 类 --> 
‘<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 id --> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- one-to-one 元 素 映射 关联 属性 ， 外 键 列 在 对 方 的 表 内 
Property-ref 指定 引用 关联 类 的 属性 。 
即 : 在 address 属性 所 属 的 address 类 内 ， 
必须 有 person 属性 的 setter 和 getter 方法 --> 
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<one-to-one name="address" property-ref="person"/> 
</class> 
</hibernate-mapping> 


程序 清单 : codes\06\6.1\bidirectional\1-1FK\src\org\crazyit\app\domain\Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- Address 持久 化 类 --> 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressId -> 
<id name="addressId" column="address_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
rT 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 
<!-- 使 用 many-to-one 映射 1 一 1 关联 实体 
unique="t: 确定 为 1 一 1--> 
<many-to-one name="person" unique="true" 
column="person_id" not-null="true"/> 


</class> 
</hibernate-mapping> 


二 
大- 和 注意: 
上 面 的 映射 策略 可 以 互 换 ， 即 让 Person 端 存放 外 键 ， 使 用 <many-to-one.…/> 元 素 映射 

关联 属性 ; 但 Address 端 则 必须 使 用 <one-to-one.,. 户 元 素 映射 。 万 万 不 可 两 边 都 使 用 相同 


的 元 素 映 射 关联 属性 


6.1.7.2 ”基于 主键 的 双向 1 一 1 关联 


如 果 需 要 采用 基于 主键 的 映射 策略 ， 则 一 端的 主键 生成 器 需要 使 用 foreign 策略 , 表明 将 根据 对 方 
的 主键 来 生成 自己 的 主键 ， 本 实体 不 能 拥有 自己 的 主键 生成 策略 。 

当然 ,任意 一 端 都 可 以 采用 foreign 主键 生成 器 策略 ， 表 明 将 根据 对 方 主键 来 生成 自己 的 主键 。 使 
用 foreign 主键 生成 策略 的 实体 将 不 能 主动 指定 主键 ， 必 须 由 关联 实体 的 主键 来 生成 自己 的 主键 值 。 

下 面 的 映射 文件 指定 了 基于 主键 的 1 - 1 关联 映射 。 

程序 清单 :codes\06\6.1\bidirectional\1-1PK\src\org\crazyit\app\domain\Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN” 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- Address 持久 化 类 ~ 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressId --> 
<id name="addressId" column="address_id"> 
<!-- 指定 foreign 主键 生成 器 策略 -> 
<generator class="foreign"> 
<!-- 指定 该 主键 值 将 根据 Person 属性 引用 的 
关联 实体 的 主键 来 生成 --> 
<param name="property">person</param> 


</id> 
<!-- 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 
<!-- 用 于 映射 关联 实体 --> 


了 5 了 
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<one-to-one name="person"/> 
</class> 
</hibernate-mapping> 


程序 清单 : codes\06\6.1\bidirectional\1-1PK\src\org\crazyit\app\domain\Person.hbm.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 id 一 -> 
<id name="id"” column="person_id"> 
<!-- 定义 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 用 于 映射 关联 实体 --> 
<one-to-one name="address"/> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 指定 Address 持久 化 类 使 用 foreign 的 主键 生成 策略 ， 这 意味 着 该 Address 实体 不 
能 主动 指定 主键 值 ， 只 能 根据 关联 实体 的 主键 来 生成 Address 实体 的 主键 值 。 

6.1.7.3 ”有 连接 表 的 双向 1 一 1 关联 

采用 连接 表 的 双向 1 - 1 关联 是 相当 罕见 的 情形 ,映射 相当 复杂 ,数据 模型 烦琐 。 通 常 不 推荐 使 用 
这 种 策略 。 

双向 1 - 1 关联 两 端 都 需要 使 用 <join... 人 元素 显 式 指定 连接 表 , <join... 人 > 元 素 的 table 属性 用 于 指定 
连接 表 的 表 名 ， 因 此 两 端的 <join...> 元 素 的 table 属性 值 应 该 相同 。 两 端 都 增加 key 元 素 映射 连接 表 中 
的 外 键 列 ， 还 需 增加 <many-to-one... 人 > 元 素 映 射 关 联 属性 ， 两 个 <many-to-one.…/> 元 素 都 应 该 增加 
unique="true" 属 性 表明 为 1- 1 关联 。 

不 仅 如 此 ,为 了 让 Hibernate 在 连接 表 的 两 个 数据 列 上 增加 唯一 约束 ,映射 文件 应 该 为 两 个 <key..…/> 
子 元 素 指 定 unique="true"。 

当 使 用 连接 表 来 建立 1 - 1 关联 关系 时 ， 两 个 实体 的 地 位 绝对 平等 ， 不 存在 任何 主 从 约束 关系 ， 
Hibernate 映射 它们 的 连接 表 时 ,将 会 选择 某 一 外 键 列 作 为 连接 表 的 主键 一 一 因此 两 个 持久 化 类 的 映射 
文件 依然 并 不 是 完全 相同 的 。 映 射 文件 必须 在 一 端的 <join.…. 亿 元素 中 指定 inverse="true"， 而 另 一 端 则 
指定 optional="true"。 下 面 是 两 个 持久 化 类 的 映射 文件 。 

程序 清单 :codes\06\6.1\bidirectional\1-ljointable\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
“http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 id -> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 --> 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
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<!-- 使 用 join 元 素 强制 使 用 连接 表 --> 

<join table="person_address" inverse="true"> 
<!-- 映射 连接 表 中 参照 本 实体 主键 的 外 键 列 --> 
<key column="person_id" unique="true"/> 


column="address_id" unique="true"/> 
</join> 
</class> 
</hibernate-mapping> 


程序 清单 :codes\06\6.1\bidirectional\1-ljointable\src\org\crazyit\app\domain\Address.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 -一 > 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
hibernate-mapping package="org. crazyit.app. domain"> 
<!-- Address 持久 化 类 --> 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressId --> 下 
<id name="addressId" column="address_id"> 
<!-- 指定 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 
<!-- 使 用 join 元 素 强制 使 用 连接 表 --> 
<join table="person_address" optional="true"> 
<!-~ 映射 连接 表 中 参照 本 实体 主键 的 外 键 列 一 > 
<key column="address_id" unique="true"/> 


<many-to-one name="person" class="Person" 
column="person_id" unique="true"/> 
</join> 


</class> 
</hibernate-mapping> 


上 面 的 映射 文件 为 Person 持久 化 类 的 <join.… 人 > 元 素 指定 了 inverse="true"， 这 意味 着 它们 的 连接 表 
将 使 用 | id 作为 主键 列 。 


EY - 
带 连接 表 的 双向 1 - 1 关联 ， 两 端 都 需 指定 连接 表 的 表 名 、 外 键 列 的 列 名 。 两 个 集合 
元 素 ， 如 <join..…/> 的 table 元 素 的 值 必须 指定 ,而 且 要 相同 。<join..… > 元素 的 两 个 子 元 素 : | 
<key.…/> 和 <many-to-one.…/> 都 必须 指定 column 属性 ，<key.… 人 > 和 <many-to-one... 人 > 分 别 是 
指定 本 持久 化 类 、 关 联 类 在 连接 表 中 的 外 键 列 名 , 因此 两 边 的 <key.…/> 与 <many-to-one.… 人 > 
的 column 属性 交叉 相同 ， 也 就 是 说 ， 一 端的 <join.../> 元 素 的 <key.../> 的 colomn 值 为 a， 
<many-to-one.…/> 的 column 为 b， 则 另 一 端的 <join..…/> 元 素 的 <key.…/> 的 column 值 为 b， 污 


<many-to-one.…/> 的 column 值 为 a， 


>>6.1.8 组 件 属性 包含 的 关联 实体 


前 面 已 经 提 到 过 ， 组 件 里 的 属性 不 仅 可 以 是 基本 类 型 、 字 符 串 、 日 期 型 等 ， 也 可 以 是 值 类 型 行为 
的 组 件 ， 甚 至 可 以 是 关联 实体 。 看 如 下 持久 化 类 代码 。 
程序 清单 :codes\06\6.1\component-entity\src\org\crazyit\app\domain\Person.java 


public class Person 
{ 


// 标 识 属性 
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} 


private Integer id; 
//Person 的 name 属性 
private String name; 
// 保 留 Person 的 age 属性 
private int age; 


// 定 义 一 个 组 件 属性 
private Address address; 


// 省 略 id 属性 的 setter 和 getter 方法 

7 7 省 略 name 属性 的 setter 和 getter 方法 

/77 省 略 age 属性 的 setter 和 getter 方法 
//address 属性 的 setter 和 getter 方法 
public void setAddress (Address address) 
a 

Si Address getAddress() 


return this.address; 
} 


从 上 面 的 持久 化 类 代码 来 看 ， 该 Person 类 有 一 个 Address 类 型 的 属性 ， 从 持久 化 类 代码 看 不 出 该 
Address 是 关联 实体 ， 还 是 普通 组 件 属性 。 但 如 果 我 们 不 将 Address 映射 成 持久 化 实体 ， 那 么 Address 
将 变 成 组 件 属性 ， 如 果 将 Address 映射 成 持久 化 实体 ， 那 就 是 关联 实体 了 。 

Address 类 里 不 仅 包含 了 普通 属性 ， 还 包含 了 一 个 Set 属性 ， 该 Set 集合 里 的 元 素 是 School 实体 。 
看 如 下 Address 类 代码 。 

程序 清单 ，codes\06\6.1\component-entity\src\org\crazyit\app\domain\Address.java 

public class Address 


{ 


// 标 识 属性 

private int addressId; 

// 地 址 详细 信息 

private String addressDetail; 

// 定 义 引 用 包含 实体 的 属性 

private Person person; 

// 定 义 保留 关联 实体 的 Set 

private Set<School> schools 
= new Hashset<school>(); 

// 无 参数 的 构造 器 

public Address() 

{ 


上 
// 初 始 化 addressDetail 属性 的 构造 器 
public Address(String addressDetail) 
{ 
this.addressDetail = addressDetail; 


) 

// 省 略 addressId 属性 的 setter 和 getter 方法 

/7 省 略 addressDetail 属性 的 setter 和 getter 方法 
/77 省 略 person 属性 的 setter 和 getter 方法 


77schools 属性 的 setter 和 getter 方法 

Public void setSchools (Set<School> schools) 
、 this.schools = schools; 

eA Set<School> getSchools () 

return this.schools; 
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} 
} 


School 类 是 一 个 简单 的 持久 化 类 ，School 类 里 无 法 定义 访问 Address 类 的 关联 属性 ， 因 为 如 果 想 
让 School 类 和 Address 类 建立 关联 ， 那 就 要 求 把 Address 类 也 映射 成 持久 化 类 。 因 此 我 们 此 处 只 是 把 
Address 当成 组 件 属性 使 用 ， 因 此 School 无 法 和 这 个 并 不 存在 的 持久 化 类 建立 关联 。School 类 代码 非 


常 简单 ， 此 处 不 再 给 出 。 
为 了 映射 Person 类 中 的 Address 组 件 ， 映 射 文件 使 用 <component.. 人 元 素来 映射 该 组 件 属性 ， 然 
后 在 <component... 人 > 元 素 里 使 用 <set... 记 元 素来 映射 1 -入 关联 实体 。Person 的 映射 文件 代码 如 下 。 
程序 清单 : codes\06\6.1\component-entity\src\org\crazyit\app\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="lee"> 
<!-- 映射 Person 持久 化 类 --> 
<class name="Person" table="person_inf"> 
<!-- 肌 射 标识 属性 -> 
<id name="id" column="person_id"> 
<!-- 定义 主键 生成 器 策略 --> | 
<generator class="identity"/> 
</id> 
<!-- 用 于 映射 普通 属性 -一 > 
<property name="name" type="string"/> 
<property name="age" type="int"/> 
<!-- 肌 射 组 件 元 素 --> 
<component name="address" class="Address"> 
<!-- 映射 组 件 的 person 属性 指向 包含 实体 -> 
<parent name="person"/> 
<!-- 映射 普通 属性 -> 
<property name="addressDetail"/> 
<!-- 映射 集合 属性 ， 集 合 元 素 是 其 他 持久 化 实体 
没有 指定 cascade 属性 --> 
<aet name="schools"> 
<!-- 指定 关联 的 外 键 列 -> 
<key column="address_id"/> 
<!-- 用 以 映射 到 关联 类 属性 --> 
<one-to-many class="School"/> 
</set> 
</component> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 在 组 件 里 像 映射 1 - N 关联 实体 一 样 使 用 <set.…/> 元 素 ， 与 前 面 映射 单 向 的 1 - N 
关联 并 没有 太 大 区 别 。 因 为 这 里 是 单 向 的 1 -入 关联 , 所 以 映射 文件 无 法 为 <set..> 指 定 inverse="true"。 
下 面 的 方法 示范 了 如 何 保存 Person 对 象 ， 以 及 Address 组 件 所 关联 的 两 个 School 对 象 。 


// 保 存 Person 和 Address 对 象 
private void testPerson() 
{ 


Session session = HibernateUtil.currentSession()7 
Transaction tx = session.beginTransaction{); 
// 创 建 一 个 Person 对 象 

Person P = new Person(); 

// 设 置 Person 的 Name 为 Yeeku 字符 刘 

P.setName ("Yeeku"); 

p.setAge(29); 

session.save (p); 

// 创 建 一 个 Address 对 象 

Address a = new Address ("广州 天 河 "); 

// 设 置 Person 对 象 的 hddress 属性 

p.setAddress (a); 
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// 创 建 2 个 School 对 象 
School sl = new School (" 妾 狂 Java 项 目 冲 刺 班 ") ; 
School s2 = new School ("疯狂 Java 训练 营 ") 7 
// 保 存 2 个 School 实体 
session.save(sl); 
session.save (32); 
// 设 置 Address 对 象 和 两 个 School 的 关联 关系 
a.getSchools{() .add(s1); 
a.getschools() .add(s2); 
tx.commit (); 
HibernateUtil.closeSession(); 
} 


这 种 映射 策略 与 前 面 单 向 的 1 - N 关联 极其 相似 ， 程 序 必须 先 主动 持久 化 两 个 School 对 象 ， 因 为 
School 对 象 没 有 保留 对 Address 的 引用 ， 所 以 Hibernate 插入 shcool_inf 记录 时 只 能 让 其 外 键 为 空 ， 这 
必然 导致 在 设置 关联 关系 时 需要 使 用 update 语句 。 

对 于 上 面 的 映射 策略 ， 从 逻辑 上 看 应 该 是 Address 和 School 存在 1 - 关联 ， 但 底层 数据 库 将 会 
让 school_inf 表 的 外 键 列 参照 person_inf 表 的 主键 , 这 种 主 从 表 的 约束 关系 看 上 去 非常 混乱 。 由 此 可 见 ， 
采用 这 种 让 组 件 和 持久 化 实体 建立 关联 的 策略 的 实用 价值 并 不 大 。 

般 来 说 ， 如 果 需 要 让 持久 化 实体 和 组 件 属性 建立 关联 关系 ， 程 序 应 该 将 该 组 件 映射 成 持久 化 实 
体 , 而 不 是 组 件 属性 , 这 就 可 以 将 上 面 的 单 向 1 -和 关联 改写 成 双向 1 -入 关联 , 从 而 提供 较 好 的 性 能 。 

类 似 的 ，Hibernate 还 支持 让 复合 主键 (以 组 件 实体 充当 复合 主键 ) 和 持久 化 实体 建立 关联 关系 ， 

这 种 策略 也 是 比较 怪异 的 。 下 面 介 绍 这 种 关联 关系 。 


>》>6.1.9 基于 复合 主键 的 关联 关系 


实际 项 目 并 不 推荐 使 用 复合 主键 ， 我 们 总 是 建议 采用 没有 物理 意义 的 逻辑 主键 。 复 合 主键 的 做 法 
不 仅 会 增加 数据 库 建 模 的 难度 ， 而 且 增 加 关联 关系 的 维护 成 本 。 但 在 某 些 特殊 的 情形 下 ， 或 者 由 于 某 
些 人 的 特殊 习惯 , 总 有 可 能 需要 面 对 基 于 复合 主键 的 关联 , Hibernate 也 为 这 种 特殊 的 关联 提供 了 支持 。 

下 面 将 以 1 -双向 关联 为 例 来 介绍 基于 复合 主键 的 关联 ， 先 看 如 下 实体 类 。 

程序 清单 : codes\06\6.1\1-N(composite-id)\src\org\crazyit\app\domain\Person.java 


public class Person 
implements java.io.Serializable 


// 定 义 first 属性 ， 作 为 标识 属性 的 成 员 
private String first; 
// 定 义 last 属性 ， 作 为 标识 属性 的 成 员 
private String last; 
// 普 通 属性 age 
private int age; 
// 记 录 关联 实体 
Private Set<Address> addresses 
= new HashSset<Address>(); 
// 省 略 first 属性 的 setter 和 getter 方法 


{ 


// 省 上 last 属性 的 setter 和 getter 方 法 
// 省 上 age 属性 的 setter 和 getter 方法 
//adaresses 属性 的 setter 和 getter 方 法 


// 重 写 equals 方法 ， 根 据 first、last 进行 判断 
public boolean equals (Object obj) 
{ 
if (this == obj) 
{ 
return true; 
} 
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if (obj != null 
&6 obj-getClass() == Person.class) 
{ 
Person target = (Person)obj; 
if (target.getFirst().equals(getFirst()) 
5&5 target.getLast ().equals (getLast ())) 
和 
return true; 
} 
y 
return false; 
} 
// 重 写 hashcode 方法 ， 根 据 first、last 计算 hashcode 值 
public int hashCode() 
{ 
return getFirst().hashCode() * 13 
+ getLast () ,hashCode(); 
上 
} 


上 面 的 Person 类 中 first、last 两 个 属性 将 作为 标识 属性 的 成 员 ， 因 此 上 面 的 Person 类 需要 实现 
java.io.Serializable 接口 。 不 仅 如 此 ， 上 面 的 Person 类 还 重 写 了 equas0 和 hashCode() 两 个 方法 。 
上 面 的 Person 类 和 Address 类 之 间 存 在 1 -N 双向 关联 ， 所 以 该 Person 类 使 用 了 Set<Address.../> 
来 记录 该 Person 类 所 关联 的 全 部 Address 实体 。 下 面 是 Address 类 代码 。 
程序 清单 :codes\06\6.1\1-N(composite-id)\src\org\crazyit\app\domain\Address.java 
public class Address 
{ 


// 标 识 属性 

private int addressId; 

// 地 址 详细 信息 

private String addressDetail; 
// 记 录 关 联 实体 的 Person 属性 
Private Person person; 

// 无 参数 的 构造 器 

public Address() 

{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Rddress(String addressDetail) 
{ 
this.addressDetail = addressDetail; 


} 
// 省 略 addressId 属性 的 setter 和 getter 方法 
/77 省 略 addressDetail 属性 的 setter 和 getter 方法 


/ /person 属性 的 setter 和 getter 方法 
public void setPerson(Person Person) 
>: this.person = person; 
publie Person getPerson() 
return this.person; 

} 


映射 单独 的 Person 类 不 算 太 难 ， 只 要 使 用 composite-id... 放 元素 映射 复合 主键 即 可 。 但 现在 Person 
类 和 Address 类 之 间 存在 双向 的 1 -入 关 联 ， 因 此 需要 在 Person 类 的 映射 文件 中 增加 <set.. 人 > 元 素来 映 
射 关联 实体 ，<set.. 信 元 素 里 的 <key.. 人 > 子 元 素 映射 外 键 列 一 一 注意 此 时 需要 在 address_inf 表 中 定义 两 
个 外 键 列 ,因此 不 能 通过 直接 在 <key.… 人 > 子 元 素 里 指定 column 属性 来 映射 外 键 列 ( 这 样 只 能 映射 一 列 )， 
而 是 应 该 在 <key.… 人 > 子 元 素 再 添加 两 个 <column... 人 > 子 元 素来 映射 外 键 列 。 如 以 下 映射 文件 所 示 。 
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程序 清单 ; codes\06\6.1\1-N(composite-id)\src\org\crazyitiapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<class name="Person" table="person_ inf"> 
<!-- 直接 使 用 composite-id 映射 多 列 联合 主键 --> 
<composite-id> 
<!-- 映射 组 件 主键 里 的 各 属性 -> 
<key-property name="first" type="string"/> 
<key-property name="last" type="string"/> 
</composite-id> 
<!-- 映射 普通 属性 -> 
<property name="age" type="int"/> 
<!-- 映射 关联 实体 --> 
<set name="addresses" inverse="truen 
cascade="all"> 
<key> 
<!-- 映射 两 个 外 键 列 一 
<column name="first"/> 
<column name="last"/> 
</key> 
<one-to-many class="Address"/> 
</set> 
</class> 
</hibernate-mapping> 


与 此 类 似 的 是 , Address 实体 的 映射 文件 中 也 不 能 直接 在 <many-to-one..… 户 元素 中 增加 column 属性 
来 映射 外 键 列 《这样 只 能 映射 一 个 外 键 列 )， 而 是 应 该 在 <many-to-one.…/> 元 素 中 增加 多 个 <column,…/> 
子 元 素来 映射 外 键 列 。 如 以 下 映射 文件 所 示 。 

程序 清单 ，codes\06\6.1\1-N(composite-id)\src\org\crazyit\app\domain\Address.hbm.xml 

<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- Address 持久 化 类 --> 
<class name="Address" table="address_inf"> 
<!-- 映射 标识 属性 addressId --> 
<id name="addressId" column="address_id"> 
<!-- 指定 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 addressdetail --> 
<property name="addressDetail"/> 
<!-- 映射 关联 实体 --> 
<many-to-one name="person" class="Person" 
not-null="true"> 
<!-~ 映射 外 键 列 --> 
<column name="first"/> 
<column name="last"/> 
</many-to-one> 
</class> 
</hibernate-mapping> 


通过 使 用 上 面 的 映射 文件 ， 就 可 以 在 address_inf 表 中 增加 两 个 外 键 列 ，first、last， 这 两 列 正好 参 
照 主 表 (person_inf) 的 first、last 主键 列 。 


入 和 6.1.10 复合 主键 的 成 员 属 性 为 关联 实体 


正如 上 一 节 看 到 的 ， 使 用 复合 主键 并 没有 带 来 什么 特别 大 的 好 处 ， 但 会 给 编程 、 数 据 库 维护 带 来 
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额外 的 麻烦 。 本 节 介绍 的 也 是 复合 主键 带 来 的 “无 尽 的 痛苦 ”。 本 示例 中 的 实体 也 使 用 了 复合 主键 , 而 
且 此 时 复合 主键 的 成 员 更 特殊 : 复合 主键 的 成 员 是 关联 实体 。 
复合 主键 的 成 员 是 关联 实体 的 示例 看 上 去 比较 特殊 ， 但 在 实际 项 目 中 却 很 受 欢 迎 ， 例 如 我 们 开发 
一 个 进 销 存 管理 系统 ， 该 系统 涉及 订单 、 商 品 、 订 单项 三 个 实体 ， 其 中 一 个 订单 可 以 包含 多 个 订单 项 ， 
-个 订单 项 用 于 订购 某 个 商品 ， 以 及 订购 数量 ， 一 个 商品 可 以 多 次 出 现在 不 同 订单 项 中 。 
从 上 面 的 介绍 来 看 ， 订 单 和 订单 项 之 间 存 在 双向 的 1 - N 关联 ， 订 单项 和 商品 之 间 存 在 单 向 的 N 
-1 的 关联 一 一 本 来 这 也 没有 什么 值得 介绍 的 ， 这 就 是 普通 的 双向 关联 、 单 向 关联 。 问 题 是 ， 在 实际 
项 目 中 ， 有 些 程序 员 〈 尤 其 是 早期 那些 从 PB、Delphi 转型 过 来 的 ) 不 为 订单 项 定义 额外 的 逻辑 主键 ， 
而 是 使 用 订单 主键 、 商 品 主键 、 订 货 数量 作为 复合 主键 ， 这 就 比较 特殊 、 需 要 做 一 些 特殊 的 映射 了 。 
下 面 是 程序 的 订单 的 Java 类 。 
程序 清单 : codes\06\6.1\1-N(entity-id)\src\org\crazyit\app\domain\Order.java 
public class Order 
{ 
// 标 识 属性 
private Integer orderld; 
// 订 单 日 期 
private Date orderDate; 
// 关 联 的 的 订单 项 
private Set<OrderItem> items 
= new HashSet<OrderItem>(); 
// 无 参数 的 构造 器 


public Order() 
{ 


上 
// 初 始 化 全 部 属性 的 构造 器 
Public Order (Date orderDate) 
{ 
this.orderDate = orderDate; 


) 
// 省 略 orderId 属性 的 setter 和 getter 方法 
/7 省 略 orderDate 属性 的 setter 和 getter 方法 


//items 属性 的 setter 和 getter 方法 
Public void setItems (Set<OrderItem> items) 
{ 

this.items = items; 


} 
public Set<OrderItem> getItems() 


return this.items; 。 

上 

} 
上 面 的 Java 类 定义 了 一 个 简单 的 订单 实体 ， 一 个 订单 实体 对 应 于 多 个 订单 项 ， 因 此 上 面 使 用 了 
Set 集 合 来 记录 它 所 关联 的 订单 项 。 

本 示例 所 使 用 的 商品 实体 的 Java 类 代码 如 下 。 
程序 清单 : codes\06\6.1\1-N(entity-id)\src\org\crazyit\app\domain\Product.java 
public class Product 
{ 

// 标 识 属性 

private Integer productId; 


// 产 品名 
Private String name; 


// 无 参数 的 构造 器 
public Product() 
{ 

} 
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// 初 始 化 全 部 属性 的 构造 器 
public Product (String name) 
{ 

this.name = name; 


} 
// 省 略 productId 属性 的 setter 和 getter 方法 
77 省 略 name 属性 的 setter 和 getter 方法 


} 
Product 和 Orderltem 之 间 只 是 单 向 的 关联 ，Orderltem 可 以 访问 该 订单 项 所 订购 的 商品 , 但 商品 并 
不 需要 知道 它 出 现在 哪些 订单 项 中 了 ， 因 此 Product 实体 类 没有 什么 特别 的 地 方 。 
下 面 是 Orderltem 实体 类 的 代码 。 
程序 清单 : codes\06\6.1\1-N(entity-id)\src\org\crazyit\app\domain\Orderltem.java 


public class OrderTtem 
implements java.io.Serializable 


// 下 面 三 个 属性 将 作为 联合 主键 
// 定 义 关联 的 Order 实体 
Private Order order; 

// 定 义 关联 的 Product 实体 
Private Product product; 
// 该 订单 项 订购 的 产品 数量 
Private int count; 

// 无 参数 的 构造 器 

public OrderItem() 

{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public OrderItem(Order order , Product product , int count) 


{ 


{ 


this.order = order; 
this.product = product; 
this.count = count; 


儿 /省 聊 order 并 性 的 setter 和 和 getter 方 法 
// 省 略 product 属性 的 setter 和 getter 方法 
7/ 省 略 count 属性 的 setter 和 getter 方法 
| 
上 面 的 Orderltem 实体 将 使 用 三 个 属性 作为 复合 属性 ， 而 且 其 中 两 个 成 员 引 用 了 关联 实体 。 

为 了 映射 上 面 的 Product 实体 ， 需 要 使 用 <composite-id.…/> 元 素来 映射 复合 主键 ， 但 
<composite-id.…/> 里 不 能 使 用 <key-property.… 户 来 映射 order、 product 属性 一 一 因为 它们 并 不 是 普通 的 标 
量 属性 ， 而 是 关联 实体 。 

当 复 合 主键 的 成 员 是 关联 实体 时 , 使 用 <key-many-to-one... 人 > 进行 映射 , 该 元 素 除 一 样 可 指定 name、 
class、column、lazy、access 等 常用 属性 一 一 <key-many-to-one... 人 > 元 素 与 <many-to-one... 人 > 元 素 的 用 法 
大 致 类 似 ， 而 且 它们 都 用 于 映射 N 一 1 关联 中 N 的 一 端 ， 只 是 <key-many-to-one.../> 映 射 的 属性 还 作为 
复合 主键 的 成 员 。 

下 面 是 Orderltem 持久 化 类 的 映射 文件 。 

程序 清单 : codes\06\6.1\1-N(entity-id)\src\org\crazyit\app\domain\Orderltem.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE hibernate-mapping PUBLIC 

"-//Hibernate/Ribernate Mapping DTD 3.0//EN™ 

"http://wuw.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 

<class name="OrderItem" table="order_ item inf"> 
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<!-- 映射 复合 主键 --> 


</composite-id> 
</class> 
</hibernate-mapping> 


主 程序 向 数据 库 中 存 入 商品 、 订单 、 订 单项 , 看 到 底层 产生 如 图 6.4 所 示 的 order_item_inf 数据 表 。 


OTT TO int (11) 
rder id ) int (il) 
count int (11) 


rows in set (0.00 sec) 
yy 


图 6.4 复合 主键 的 成 员 属性 为 关联 实体 
6.1.11 持久 化 的 传播 性 


正如 前 面 的 程序 中 可 以 看 到 的 ， 当 程序 中 有 两 个 关联 实体 时 ， 程 序 需要 主动 保存 、 删 除 或 重 关联 每 
个 持久 化 实体 ; 如 果 需 要 处 理 许多 彼此 关联 的 实体 ， 则 需要 依次 保存 每 个 实体 ,这 会 让 人 感觉 有 点 烦琐 。 

从 数据 库 建 模 的 角度 来 看 ， 两 个 表 之 间 的 1 一 N 关联 关系 总 是 用 外 键 约束 来 表示 ， 其 中 保留 外 键 
的 数据 表 被 称 为 从 表 ， 被 从 表 参 照 的 数据 表 被 称 为 主 表 。 对 于 这 种 主 从 表 约束 关系 ，Hibernate 则 有 两 
种 映射 策略 : 

> ”将 从 表 记 录 映 射 成 持久 化 类 的 组 件 ， 这 就 是 上 一 章 所 介绍 的 集合 属性 的 集合 元 素 是 组 件 。 

> ”将 从 表 记 录 也 映射 成 的 持久 化 实体 ， 这 就 是 此 处 介绍 的 关联 关系 。 

如 果 我 们 将 从 表 记录 映射 成 持久 化 类 的 组 件 ， 这 些 组 件 的 生命 周期 总 是 依赖 于 父 对 象 ，Hibernate 
会 默认 启用 的 级 联 操作 ， 不 需要 额外 的 动作 。 当 父 对 象 被 保存 时 ， 这 些 组 件 子 对象 也 将 被 保存 ， 父 对 
象 被 删除 时 ， 子 对 象 也 将 被 删除 。 

如 果 将 从 表 记录 映射 成 持久 化 实体 ， 则 从 表 实 体 也 有 了 自己 的 生命 周期 ， 从 而 应 该 允许 其 他 实体 
共享 对 它 的 引用 。 例 如 ， 从 集合 中 移 除 一 个 实体 ， 不 意味 着 它 可 以 被 删除 。 所 以 Hibernate 默认 不 启用 
实体 到 其 他 关联 实体 之 间 的 级 联 操作 。 

对 于 关联 实体 而 言 ，Hibernate 默认 不 会 启用 级 联 操作 ， 当 父 对 象 被 保存 时 ， 它 关联 的 子 实体 不 会 
被 保存 ， 父 对 象 被 删除 时 ， 它 关联 的 子 实体 不 会 被 删除 。 为 了 启用 不 同 持久 化 操作 的 的 级 联 行为 ， 
Hibernate 定义 例如 如 下 级 联 风格 : persist、merge、save-update、delete 、lock、refresh、evict、replicate， 
这 些 级 联 风格 分 别 对 于 Hibernate Session 的 持久 化 操作 , 如 persist0、merge()、saveOrUpdate()、 delete()、 
lockO、refreshO、evictO、replicate0。 

如 果 程 序 希望 某 个 操作 能 被 级 联 传播 到 关联 实体 ， 则 可 以 在 配置 关联 映射 时 通过 cascade 属性 来 
指定 。 例 如 : 


<1-- 指定 persist () 操 作 将 级 联 到 关联 实体 --> 
<one-to-one name="person" cascade="persist"/> 


级 联 风格 是 可 组 合 的 ， 如 下 面 配置 所 示 : 


<!-- 指定 persist () 、delete() 和 lock() 操 作 将 级 联 到 关联 实体 --> 
<one-to-one name="person" cascade="persist, delete,lock"/> 


可 以 使 用 cascade="all" 来 指定 所 有 操作 都 被 级 联 到 关联 实体 。Hibernate 对 关联 实体 默认 的 级 联 策 
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略 是 cascade="none"， 即 任何 操作 都 不 会 被 级 联 到 关联 实体 。 
Hibernate 有 一 个 特殊 的 级 联 策略 : delete-orphan 〈 删 除 孤 儿 )， 该 级 联 策略 只 对 one-to-many 关联 
有 效 ， 表 明 delete0 操 作 将 被 级 联 到 所 有 从 关联 中 删除 的 对 象 - 
对 于 级 联 策略 的 设 定 ，Hibernate 有 如 下 建议 : 
> <many-to-one.…/> 或 <many-to-many..…/> 关 系 中 指定 级 联 没什么 意义 。 级 联通 常 在 
<one-to-one.…/> 和 <one-to-many.…/> 关 系 中 比较 有 用 一 一 因为 级 联 操作 应 该 是 由 主 表 记录 传 
播 到 从 表 记 录 ， 而 从 表 记 录 则 不 应 该 传播 到 主 表 记 录 。 
> ”如 果 从 表 记 录 完 全 限制 在 主 表 记录 之 内 〈 当 主 表 记录 被 删除 后 ， 从 表 记 录 没 有 存在 的 意义 )， 则 
可 以 指定 cascade="all,delete-orphan" 级 联 策略 ,将 从 表 实 体 的 生命 周期 完全 交 给 主 表 实体 管理 。 
> 如 果 经 常 在 某 个 事务 中 同时 使 用 主 表 实 体 和 从 表 实体 ， 则 可 以 考虑 指定 cascade= 
"create,merge,save-update" 级 联 策略 。 
可 能 有 读者 对 cascade="all" 和 cascade="delete-orphan" 两 种 策略 感到 迷惑 。 对 于 cascade="all" 级 联 
策略 的 详细 解释 : 
> ”如 果 主 表 实体 被 persist()， 那 么 所 有 从 表 实 体 也 会 被 persist()。 
> ”如 果 主 表 实体 被 merge()， 那 么 所 有 从 表 实 体 也 会 被 merge()。 
> 如 果 主 表 实 体 被 save() 、update() 或 saveOrUpdate() ， 那 么 所 有 从 表 实 体 则 会 被 
saveOrUpdate()。 
> ”如 果 把 持久 化 状态 下 的 主 表 实 体 和 瞬 态 或 脱 管 的 从 表 实 体 建立 关联 ， 则 从 表 实体 将 被 自动 持 


被 刷 除 ， 那 么 所 有 从 表 实体 也 会 被 仙 除 。 

> ”如果 没有 把 主 表 实 体 删除 ， 只 是 切断 主 表 实 体 和 从 表 实体 之 间 的 关联 关系 ， 则 从 表 实 体 不 会 

被 刷 除 。 

如 果 指定 cascade=rdelete-orphan" 策 略 ， 则 只 要 一 个 从 表 实 体 失 去 关联 的 主 表 实体 ， 不 管 该 主 表 实 
体 是 被 制 除 ， 还 是 切断 了 主 表 实 体 和 它 的 关联 ， 那 么 该 从 表 实 体 就 变 成 了 orphan (孤儿 )， 系 统 将 自 
动 删除 该 从 表 实体 。 

所 有 操作 都 是 在 调用 期 (eall time) 或 者 写 入 期 flush time) 中 级 联 到 关联 对 象 上 的 。 如 果 可 能 ， 
Hibernate 都 会 在 操作 被 执行 时 级 联 到 关联 实体 上 。 然 而 ，save-upate 和 delete-orphan 操作 是 在 Session 
flush 时 才 级 联 到 关联 对 象 上 的 。 

é” res a 三 
Hibernate 的 级 联 风格 看 上 去 比 数据 库 本 身 的 级 联 操作 更 加 强大 ， 这 是 因为 Hibemate 
的 级 联 操作 是 建立 在 程序 级 别 上 的 ， 而 数据 库 的 级 联 操作 则 是 建立 在 数据 库 级 别 上 的 ， | 


6.2 ”继承 映射 


对 于 面向 对 象 的 程序 设计 语言 ,继承 、 多 态 是 两 个 最 基本 的 概念 。Hibernate 的 继承 映射 可 以 理解 两 
个 持久 化 类 之 间 的 继承 关系 , 例如 老师 和 人 之 间 的 关系 , 老师 继承 了 人 , 可 以 认为 老师 是 一 个 特殊 的 人 ， 
如 果 对 人 进行 查询 ， 老 师 实例 也 将 被 得 到 一 一 而 无 须 关 注 人 的 实例 、 老 师 的 实例 底层 数据 库 的 存储 。 

Hibernate 支持 几 种 继承 映射 策略 , 不 管 哪 种 继承 映射 策略 , Hibernate 的 多 态 查 询 都 可 以 运行 良好 。 
看 如 下 的 几 个 持久 化 类 。 

Person 类 ， 是 本 示例 应 用 中 继承 树 结构 的 父 类 ， 其 代码 如 下 。 

程序 清单 ，codes\06\6.2\subclass\src\org\crazyitapp\domain\Personjava 


public class Person 
{ 
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// 标 识 属 性 

private Integer id; 

// 定 义 该 Person 实体 的 名 字 属性 

private String name; 

// 定 义 该 Person 实体 的 性 别 属性 

private char gender; 

// 定 义 该 Person 实体 的 组 件 属性 : address 
Private Address address; 

// 省 略 id 属性 的 setter 和 getter 方法 


/77 省 略 name 属性 的 setter 和 getter 方法 
/ / 省 略 gender 属性 的 setter 和 getter 方法 
/7 省 略 address 属性 的 setter 和 getter 方 法 


} 
如 以 上 粗 体 字 代码 所 示 ， 该 Person 类 中 有 一 个 组 件 属性 : address， 它 的 类 型 为 Address，Address 
是 一 个 自 定义 类 ， 这 个 类 将 作为 Person 的 组 件 属性 使 用 ， 这 个 自 定义 类 的 代码 如 下 。 
程序 清单 : codes\06\6.2\subclass\src\org\crazyit\app\domain\Address.java 
public class Address 
// 定 义 访 Address 的 详细 信息 
private String detail; 
// 定 义 该 Address 的 邮编 信息 
private String zip; 
// 定 义 该 Address 的 国家 信息 
private String country; // 无 参数 的 构造 器 


public Address() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Address(String detail , String zip , String country) 
{ 
this.detail = detail; 
this.zip = zip; 
this.country = country; 


a 
// 省 略 全 部 属性 的 setter 和 getter 方法 


} 
上 面 的 Address 类 非常 简单 , 它 是 一 个 包含 三 个 字符 串 属 性 的 自 定义 类 。 映射 Person 类 的 Address 

属性 时 ， 使 用 基本 的 组 件 属性 映射 语法 即 可 。 

除 此 之 外 ，Person 类 还 有 两 个 子 类 : Customer 和 Employee， 而 Employee 又 有 一 个 Manager 子 类 ， 
而 且 它们 之 间 还 存在 关联 关系 。 
注意 ee 
Person、Customer、Employee 和 Manager 4 个 类 之 间 不 仅 存在 关联 关系 ， 也 存在 继 | 
承 关 系 ， 还 有 组 件 属性 映射 ， 是 比较 复杂 的 映射 。 为 读者 介绍 如 此 复杂 的 映射 ， 也 是 希 要 


望 带 给 读者 更 实际 的 映射 案例 。 


Customer 类 的 代码 如 下 。 


程序 清单 : codes\06\6.2\subclass\src\org\crazyit\app\domain\Customerjava 
// 顾 客 类 继承 了 Person 类 
Public class Customer extends Person 


{ 
// 顾 客 的 评论 信息 


Private String comments; 
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// 和 员工 保持 关联 关系 的 属性 
private Employee employee; 
// 无 参数 的 构造 器 

public Customer() 

{ 


和 
// 初 始 化 comments 属性 的 构造 器 
public Customer(String comments) 
{ 

this.comments = comments; 


} 

// 省 略 comments 属性 的 setter 和 getter 方法 

/7 省 略 employee 属性 的 setter 和 getter 方 法 
a 


Customer 类 是 Person 类 的 子 类 , 在 此 基础 上 增加 了 comments 属性 , 而 且 还 提供 了 一 个 关联 关系 属性 : 
employee〈 如 上 面 的 粗 体 字 代码 所 示 )， 并 为 该 属性 提供 了 setter 和 getter 方法 。 

下 面 是 Employee 类 的 代码 。 

程序 清单 :codes\06\6.2\subclass\src\org\crazyit\app\domain\Employee.java 


// 员 工 类 继承 了 Person 类 
public class Employee extends Person 


{ 
// 定 义 该 员工 的 职位 属性 1 
private String title 
// 定 义 该 员工 的 工资 属性 
private double salary; 
// 和 顾客 保持 关联 关系 的 属性 
private Set<Customer> customers = new HashSet<Customer>(); 
// 和 经 理 保持 关联 关系 的 属性 
Private Manager manager; 
// 无 参数 的 构造 名 
public Employee() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Employee(String title , double salary) 
{ 
this.title = ti 
this.salary = salary; 


} 
// 省 略 title 属性 的 setter 和 getter 方法 
77 省 略 salary 属性 的 setter 和 getter 方 法 


//customers 属性 的 setter 和 getter 方法 

Public void setCustomers (Set<Customer> customers) 
this.customers = customers; 

二 Set<Customer> getCustomers() 

; return this.customers; 


//manager 属性 的 setter 和 getter 方法 
public void setManager (Manager manager) 
{ 

this.manager = manager; 
} 
Public Manager getManager() 


return this.manager; 
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Employee 类 和 Customer、Manage 之 间 都 存在 关联 关系 ， 所 以 上 面 的 持久 化 类 增加 了 customer 和 
manager 两 个 属性 ， 如 上 面 的 粗 体 字 代码 所 示 。 

Employee 还 存在 一 个 子 类 : Manager， 该 子 类 的 代码 如 下 。 

程序 清单 : codes\06\6.2\subclass\src\org\crazyit\app\domain\Managerjava 


// 经 理 类 继承 员工 类 
public class Manager extends Employee 


{ 
// 定 义 经 理 管辖 部 门 的 属性 
private String department; 
// 和 员工 保持 关联 关系 的 属性 
private Set<Employee> employees = new HashSet<Employee>(); 
// 无 参数 的 构造 器 
public Manager() 
{ 


} 
// 初 始 化 全 部 属性 的 构造 器 
public Manager(String department) 
{ 
this.department ~ department; 
站 
// 省 略 department 属性 的 setter 和 getter 方法 
//employees 属性 的 setter 和 getter 方法 
public void setEmployees(Set<Employee> employees) 
( 
this,employees = employees; 
} 
public Set<Employee> getEmployees() 
{ 


return this.employees; 
) 
} 


Manager 类 和 Employee 之 间 存 在 关联 关系 ， 所 以 上 面 的 持久 化 类 增加 了 一 个 employees 属性 ， 用 
于 建立 关联 关系 ， 如 上 面 的 粗 体 字 代码 所 示 。 
图 6.5 显示 了 以 上 几 个 类 之 间 的 类 关系 图 。 


6.5 ”继承 映射 中 各 类 的 类 图 
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下 面 依次 采用 Hibernate 支持 的 三 种 继承 映射 策略 来 完成 如 上 继承 、 关 联 关系 的 映射 。 
> 6.2.1 采用 subclass 元 素 的 继承 映射 


在 这 种 映射 策略 下 ， 整 个 继承 树 的 所 有 实例 都 将 保存 在 同一 个 表 内 ， 即 对 于 如 上 的 Person、 
Employee、Customer 和 Manager 实例 都 将 保存 在 同一 个 表 内 。 因 为 将 父 、 子 类 的 实例 全 部 保存 在 同一 
个 表 内 ， 因 此 ， 需 要 在 该 表 中 额外 增加 一 列 ， 使 用 该 列 来 区 分 每 行 记录 到 底 是 哪个 类 的 实例 一 一 这 个 
列 被 称 为 辨别 者 列 〈discriminator)。 

在 这 种 映射 策略 下 , 使 用 <subclass.../> 来 映射 子 持久 化 类 , 使 用 discriminator 元 素来 映射 辨别 者 列 。 
除 此 之 外 ， 每 个 类 映射 中 都 需要 指定 辨别 者 列 的 值 。 

上 面 整个 继承 树 的 映射 文件 代码 如 下 。 

程序 清单 :codes\06\6.2\subclass\src\org\crazyit\app\domain\Person.hbm.xml 

<?xml version="1.0" encoding="GBK"?> 

<!-- 指定 Hibernate 的 映射 文件 的 DTD 信息 --> 

<!DOCTYPE hibernate-mapping PUBLIC 

"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate. sourceforge.net/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 类 --> 
<class name="Person" table="person_inf" discriminator-value=" 普 通 人 "> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-- 使 用 identity 的 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 辨别 者 列 --> 
<discriminator column="wawa" type="string"/> 
<!-- 如 下 映射 两 个 基本 属性 --> 
<property name="name" length="80"/> 
<property name="gender"/> 
<!-- 下 面 映射 了 一 个 组 件 属性 --> 
<component name="address"> 
<!-- 映射 组 件 属性 的 三 个 成 员 属 性 --> 
<property name="detail"/> 
<property name="zip"/> 
<property name="country"/> 
</component> 
<!-- 使 用 subclass 元 素 映 射 Person 类 的 子 类 Employee --> 
<subclass name="Employee" discriminator-value=" 麻 员 "> 
<!- 映射 两 个 基本 属性 --> 
<property name="title" /> 
<property name="salary" /> 
<!-- 映射 N 一 1 的 关联 映射 --> 
<many-to-one name="manager" column="manager_id"/> 
<!-- 映射 与 customer 类 之 间 的 1 一 N 关联 --> 
<set name="customers" inverse="true"> 
<key column="empoyee_id"/> 
<one-to-many class="Customer"/> 
</set> 
<!-- 使 用 subclass 元 素 映射 Employee 类 的 子 类 Manager --> 
<subclass name-"Manager"”discriminator~value=" 经 理 "> 
<!-- 贞 射 Manager 类 的 基本 属性 department - 
<property name="department"/> 
<!-- 映射 Manager 类 的 关联 实体 : Employee --> 
<set name="employees" inverse="true"> 
<key column="manager_id"/> 
<one-to-many class="Employee"/> 
</set> 
</subclass> 
</subclass> 
<!-- 使 用 subclass 映射 Person 的 Customer 子 类 --> 
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<subclass name="Customer" discriminator-value=" 磊 客 "> 
<!-- 映射 Customer 类 的 comments 属性 --> 
<property name="comments"/> 
<!-- 映射 Customer 和 Employee 的 关联 关系 --> 
<many-to-one name="employee" column="empoyee_id"/> 

</subclass> 

</class> 
</hibernate-mapping> 


每 个 子 持久 化 类 不 再 使 用 <class.… 户 元 素 进行 映射 ， 而 是 改 为 使 用 <subclass.……/> 元 素 进 行 映射 。 实 
际 上 , <subclass.…/> 元 素 和 <class.…/> 元 素 的 配置 几乎 一 样 , 只 是 <subclass.…. 人 > 元 素 用 于 映射 子 持久 化 类 ， 
而 <class.… 户 元素 用 于 映射 普通 持久 化 类 。 

<subclass... 人 > 元 素 比 <class... 人 > 元 素 多 了 一 个 extends 属性 ， 该 属性 指定 该 持久 化 类 的 父 类 (必须 是 
持久 化 类 )， 当 把 <subclass... 伺 作为 <class... 人 > 元 素 或 者 <subclass... 人 > 元 素 的 子 元 素来 使 用 时 ， 无 须 指 定 
extends 属性 ，Hibernate 将 自动 把 该 <subclass... 人 > 的 父 <class... 人 > 元 素 或 者 <subclass,../> 元 素 所 映射 的 持 
和 久 化 类 当成 父 类 。 但 映射 文件 把 <subclass... 记 当成 <hibernate-mapping.…. 亿 元素 的 子 元 素 使 用 时 ， 必 须 指 
定 extends 属性 。 类 似 的 ， 后 面 介绍 的 <joined-subclass... 人 > 元 素 和 <union-subclass,../> 元 素 也 有 相同 的 
extends 属性 ， 其 用 法 与 此 处 的 extends 用 法 完全 一 样 。 

在 上 面 的 映射 文件 中 ， 指 定 了 一 个 辨别 者 列 ， 该 列 的 列 名 为 wawa， 该 列 的 值 没有 实际 意义 ， 仅 
用 于 区 分 每 条 记录 对 应 哪个 持久 化 类 。 其 中 Person 类 实例 的 wawa 列 的 值 为 普通 人 ， Employee 实例 
的 wawa 列 的 值 为 雇员 ，Manager 实例 的 wawa 列 的 值 为 经 理 ，Customer 实例 的 wawa 列 的 值 为 顾客 ， 
如 上 面 的 粗 体 字 代 码 所 示 。 

而 使 用 一 个 主 程序 保存 进 的 一 系列 的 记录 ， 分 别 为 普通 人 、 员 工 、 顾 客 和 经 理 等 角色 ， 数 据 表 的 
结构 如 图 6.6 所 示 。 


图 6.6 subclass 继承 映射 策略 的 表 结 构 


正如 图 6.6 所 示 ， 辨 别 者 列 wawa 用 于 区 分 该 条 记录 是 哪个 类 的 实例 。 在 图 6.6 中 见 到 很 多 NULL 
值 ， 这 正 是 这 种 映射 策略 的 劣势 ， 所 有 子 类 定义 的 字段 ， 不 能 有 非 空 约束 。 因 为 如 果 为 这 些 字段 增加 
非 空 约束 ， 那 么 父 类 的 实例 在 这 些 列 根本 没有 值 ， 这 肯定 引起 数据 完整 性 冲突 ， 导 致 父 类 的 实例 无 法 
保存 到 数据 库 。 


和 


但 这 种 映射 策略 也 有 一 个 非常 大 的 好 处 在 这 种 映射 策略 下 ， 整 棵 继承 树 的 所 有 数据 都 保存 在 一 
张 表 内 ， 因 此 不 管 进行 怎样 的 查询 、 不 管 查 询 继承 树 中 的 哪 一 层 的 实体 ， 底 层 数据 库 都 只 需 在 一 张 表 
中 查询 即 可 ， 无 须 进行 多 表 连 接 查 询 ， 也 无 须 进行 union 查询 ， 因 此 性 能 比较 好 。 


>>6.2.2 采用 joined-subclass 元 素 的 继承 映射 


采用 这 种 映射 策略 时 ， 父 类 实例 保存 在 父 类 表 里 ， 而 子 类 实例 则 由 父 类 表 和 子 类 表 共同 存储 。 因 
为 子 类 实例 也 是 一 个 特殊 的 父 类 实例 ， 因 此 必然 也 包含 了 父 类 实例 的 属性 ， 于 是 将 子 类 与 父 类 共有 的 


467 


http://52pdf.taobao.com 
攻 旺 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


属性 保存 在 父 类 表 中 ; 而 子 类 增加 的 属性 ， 则 保存 在 子 类 表 中 。 
在 这 种 映射 策略 下 ， 无 须 使 用 辨别 者 列 ， 但 需要 为 每 个 子 类 使 用 <key.…. 人 > 元 素 映射 共有 主键 一 一 
SE 类 表 的 主键 列 。 


四 注 总 :* . 
使 用 joined- .subclass 继承 映射 策略 时 须 使 用 <key.../> 元 素 映射 父子 类 的 共有 主键 ， 


<key.… 人 元 素 映射 的 数据 列 既 是 主键 列 ， 也 是 外 键 列 ， 这 些 共有 的 主键 列 的 列 名 无 需 可 


相同 


使 用 joined-subclass 映射 策略 的 映射 文件 如 下 。 
程序 清单 : codes\06\6.2\joined-subclass\src\org\crazyitapp\domain\Person.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 的 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="lee"> 
<!-- 胰 射 Person 类 --> 
<class name="Person" table="person_inf"> 
映射 标识 属性 一 > 
name="id" column="person_id"> 
<!-- 使 用 identity 的 主键 生成 器 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 如 下 映射 两 个 基本 属性 一 > 
<property name="name" length="80"/> 
<property name="gender"/> 
<!-~ 下 面 映射 了 一 个 组 件 属性 --> 
<component name="address"> 
<!-- 映射 组 件 属性 的 三 个 成 员 属性 --> 
<property name="detail”/> 
<property name="zip"/> 
<property name="country"/> 
</component> 
<!-- 使 用 joined-subclass 元 素 映射 Person 类 的 Employee 子 类 --> 
<joined-subclass name="Employee"> 
<!-- 必须 使 用 key Ee Ci 
<key column="employee_id"/; 
<!-- 映射 Employee 间 交 人 季风 性 ES 
<property name="title" not-null="true"/> 
<property name="salary" not-null="true"/> 
<!-- 映射 Employee 类 与 Manager 类 之 问 的 R 一 1 关联 --> 
y-to-one name="manager”column=nmanager_idn/> 
<!-- 映射 Employee 类 与 Customer 类 之 间 的 1 一 N 关联 --> 
<set name="customers" ;inverse=ntruen> 
<key column="empoyee_id"/> 
<one-to-many class="Customer"/> 
</set> 
<!-- 使 用 joined-subclass 元 素 映射 Employee 类 的 Manager 子 类 --> 
<joined-subclass name="Manager"> 
<!-- 必须 使 用 key 元 素 映射 父子 类 的 共有 主键 --> 
<key column="manager_id"/> 
<!-- 映射 Manager 类 的 department 属性 --> 
<property name="department"/> 
<!-- 映射 Employee 类 与 Manager 类 之 间 的 1 一 N 关联 --> 
<set name="employees" inverse="true"> 
<key column="manager_id"/> 
<one-to-many class="Employee"/> 
</set> 
</joined-subclass> 
</joined-subclass> 
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<!-- 使 用 joined-subclass 元 素 映射 Person 类 的 Customer 子 类 --> 

<joined-subclass name="Customer"> 
<!-- 必须 使 用 key li ped be get 
<key column="customer_id"/> 
<property name="comments" not-null="true"/> 
<!-- 映射 Employee 类 与 Customer 类 之 间 的 1 一 N 关联 --> 
<many-to-one name="employee" column="empoyee_ id" 

not-null="true"/> 
</joined-subclass> 
</class> 
</hibernate-mapping> 


看 到 如 上 配置 文件 ， 子 类 增加 的 属性 已 经 可 以 增加 非 空 约束 了 。 因 为 子 类 的 属性 和 父 类 没有 保存 
在 同 ts 所 有 子 类 的 属性 也 可 以 增加 非 空 约束 。 


i “六 计生 ， 新 翅 


4 
我 们 看 到 Employee 和 Ma 类 之 间 的 关联 ， 其 外 键 列 依然 没有 增加 非 空 约束 一 i 

一 这 不 可 能 ， 因 为 Manager 是 Employee 的 子 类 ， 它 们 之 间 的 关联 实际 是 一 种 自 关联 。 8 

所 有 的 自 关联 中 的 外 刍 列 都 不 可 能 有 非 空 约 来。 可 


使 用 主 程序 保存 进 系列 记录 后 ， 看 到 person 表 的 内 容 如 图 6.7 所 示 。 

正如 在 图 6.6 中 所 看 到 的 ， 不 仅 Person 的 实例 保存 在 person_inf 表 中 ，Employee、Manager 和 
Customer 的 实例 也 保存 在 person_inf 表 中 ， 但 仅仅 保存 它们 作为 Person 实例 的 属性 。 而 作为 子 类 的 属 
性 则 保存 在 各 自 的 表 中 。 如 图 6.8 所 示 是 employee_inf 表 的 内 容 。 


Ps select * fron person_inf; 引 
personid | neme eader detail | Zip countn 
1 Yeeku 男 “434933 “中国 
2 Grace 女 加 州 。 ”523034 ”美国 
3 老 朱 男 广州 523034 中国 
4 张 美 丽 女 广州 。 ”523034 ”中 国 
5 小 贺 男 湖南 。 233034 中国 


图 6.7 joined-subclass 映射 策略 中 父 类 表 的 内 容 


Ee Select * from employee_inf 9 


4 
图 6.8 joined-subclass 继承 映射 策略 的 子 类 表 的 内 容 


从 图 6.7 可 以 看 出 ，employee_inf 表 里 不 仅 保存 了 Employee 实体 的 信息 ， 所 有 Manager 实体 的 信 
息 也 保存 在 该 数据 表 中 。 

customer_inf 表 的 内 容 如 图 6.9 所 示 。 

将 subclass 映射 策略 生成 的 数据 表 与 图 6.7、 图 6.8、 图 6.9 进行 对 比 ， 不 难 发 现 这 种 映射 策略 其 
实 就 是 将 图 6.6 所 示 的 数据 表 进 行 竖 向 分 割 ， 因 此 笔者 也 把 这 种 策略 成 为 “纵向 分 割 映射 

正如 图 6.7、 图 6.8 和 图 6.9 所 示 ， 三 个 表 中 都 有 person_id、employee id、customer id 列 ， 这 就 
是 它们 作为 父子 类 的 共有 主键 , Hibernate 正 是 通过 相同 的 主键 值 来 查询 一 个 子 类 实例 的 数据 的 。 例 如 ， 
需要 查询 一 个 id 为 5 的 顾客 ，Hibernate 将 从 person 表 中 查询 出 id 为 5 的 数据 ， 并 查询 出 customer 表 
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中 id 为 5 的 记录 。 将 两 条 记录 拼接 成 一 个 实例 ,当然 这 种 拼接 是 通过 一 个 join SQL 语句 完成 一 这 也 
是 这 种 映射 策略 被 称 为 joined-subclass 的 原因 。 


ysql> select *# from customer_inf; 


anise es 1 
图 6.9 joined-subelass 继承 映射 策略 的 子 类 表 的 内 容 


注意 :Y - 
使 用 joined-subclass 继承 映射 策略 ， 当 程序 查询 子 类 实例 时 ， 需要 跨越 多 个 表 查 询 。 


| 到 底 需要 跨越 多 少 个 表 ， 取 决 于 该 子 类 有 多 少 层 父 类 一 一 这 是 因为 子 类 的 数据 依次 保存 
| 在 其 多 个 父 类 表 中 。 正 是 因为 这 种 策略 ， 所 以 joined-subclass 继承 映射 策略 对 查询 性 能 
| 有 一 定 的 影响 。 


约束 ， 是 
不 过 这 些 


-种 比较 理想 的 映射 策略 。 只 是 在 查询 子 类 实例 的 数据 时 ， 可 能 需要 跨越 多 个 表 来 查询 
底层 的 数据 库 实现 无 须 程序 开发 者 关心 ， 只 是 性 能 略 有 影响 而 已 。 


和 和 6.2.3 采用 union-subclass 元 素 的 继承 映射 


还 有 一 种 映射 策略 ， 与 刚才 介绍 的 joined-subclass 映射 策略 非常 相似 ， 子 类 增加 的 属性 也 可 以 有 
非 室 约 束 一 一 即 父 类 实例 的 数据 保存 在 父 表 中 ， 而 子 类 实例 的 数据 则 保存 在 子 表 中 。 与 采用 
joined-subclass 映射 策略 不 同 的 是 ， 子 类 实例 的 数据 仅 保存 在 子 类 表 中 ， 没 有 在 父 类 表 中 有 任何 记录 。 
在 这 种 映射 策略 下 ， 子 类 表 的 字段 会 比 父 类 表 字 段 要 多 ， 因 为 子 类 表 的 字段 等 于 父 类 属性 加 子 类 增加 
属性 的 总 和 。 

在 这 种 映射 策略 下 ， 既 不 需要 使 用 辨别 者 列 ， 也 无 须 使 用 <key... 人 > 元 素来 映射 共有 主键 。 如 果 单 
从 数据 库 来 看 ， 几 乎 难以 看 出 它们 之 间 存 在 的 继承 关系 。 

下 面 是 采用 union-subclass 继承 映射 策略 的 映射 文件 代码 。 

程序 清单 : codes\06\6.2\ioined-subclass\srcvorg\crazyitappwdomain\Person .hbm.xml 


<?xml version="1.0" encoding="GBK"?> 

<!-- 指定 Hibernate 的 映射 文件 的 DTD 信息 --> 

<1DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 


"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Person 类 --> 
<class name="Person" table="person_inf"> 
<!-- 映射 标识 属性 --> 
<id name="id" column="person_id"> 
<!-- 不 能 使 用 identity、sequecen 的 主键 生成 器 策略 
， 所 以 使 用 hilo 主键 生成 器 策略 --> a 
<generator class="hilo"/> 
</id> 
<!-- 如 下 映射 两 个 基本 属性 一 -> 
<property name="name" length="80"/> 
<property name="gender"/> 
<!-- 下 面 映射 了 一 个 组 件 属性 --> 
<component name="address"> 
<!-- 映射 组 件 属性 的 三 个 成 员 属 性 --> 
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<property name="detail"/> 
<property name="zip"/> 
<property name="country"/> 
</component> 
<!-- 使 用 union-subclass 元 素 映 射 Person 类 的 Employee 了 类 --> 
<union-subclass name="Employee" table=" 
<!-- 映射 Employee 类 的 两 个 普通 属性 -> 
<property name="title" not-null="true"/> 
<property name="salary" not-null="true"/> 
<!-- 映射 Employee 类 与 Manager 类 之 间 的 N 一 1 关联 --> 
<many-to-one name="manager" column="manager id"/> 
<!-- 映射 Employee 类 与 Customer 类 之 间 的 1 一 N 关联 --> 
<set name="customers" inverse="true"> 
<key column="empoyee_id"/> 
<one-to-many class="Customer"/> 
</set> 
<!-- 使 用 union-subclass 元 素 映射 Employee 类 的 Manager : 了 -> 
<union-subclass name= " table= 
<!-- 映射 Manager 类 的 department 属性 --> 
<property name="department"/> 
<!-- 映射 Employee 类 与 Manager 类 之 间 的 1 一 N 关联 --> 
<set name="employees" inverse="true"> 
<key column="manager_id"/> 
<one-to-many class="Employee"/> 
</set> 
</union-subclass> 
</joined-subclass> 
<!-- 使 用 union-subclass 元 素 映射 Person 类 的 Customer 子 类 --> 
<union-subclass name="Customer" table="customer_inf"> 
<property name="comments" not-null="true"/> 
< 上 -~ 映射 Employee 类 与 Customer 类 之 间 的 1 一 N 关联 --> 
<many-to-one name="employee" column="empoyee_id" 
not-null="true"/> 
</union-subclass> 
</class> 
</hibernate-mapping> 


查看 上 面 的 映射 文件 ， 使 用 union-subclass 映射 策略 时 ， 非 常 简洁 ， 既 不 需要 使 用 辨别 者 列 ， 也 不 
需要 使 用 key 子 元 素 映射 共有 主键 列 , 只 要 使 用 union-subclass 映射 子 类 即 可 ,这 种 策略 非常 方便 实用 ， 


因此 也 是 笔者 比较 喜欢 的 继承 映射 策略 。 
人 
io 注意 :六 


使 用 union-subclass 映射 策略 时 ， 既 不 需要 使 用 拓 别 者 列 ， 也 不 需要 使 用 key 映射 共 中 
有 主键 列 。 


这 种 方式 的 局 限 在 于 ， 如 果 一 个 属性 在 超 类 中 做 了 映射 ， 其 字段 名 必须 与 所 有 子 类 表 中 定义 的 相 
同 (Hibemate 可 能 在 后 续 发 布 版 本 中 放宽 此 限制 )。 除 此 之 外 ， 使 用 union-subclass 映射 策略 是 不 可 
使 用 identity 主键 生成 策略 ， 因 为 同一 类 继承 层次 中 所 有 实体 类 必须 使 用 同一 个 主键 种 子 〈 即 多 个 持 
久 化 实体 对 应 的 记录 的 主键 是 连续 的 )。 受 此 影响 ， 也 不 应 该 使 用 native 主键 生成 策略 ， 因 为 native 
会 根据 数据 库 来 选择 使 用 identity 或 sequence 策略 。 


在 这 种 映射 策略 下 ， 不 同 持久 化 类 实例 保存 在 不 同 的 表 中 ， 不 会 出 现 加 载 一 个 实例 内 容 时 需要 跨 
越 多 个 表 取 数据 的 情况 。 因 为 对 于 上 面 的 示例 ， 例 如 ，Person 类 的 实例 就 是 保存 在 person_inf 表 中 ， 
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而 Person 子 类 : Customer 实例 就 是 保存 在 customer_inf 表 中 ， 不 会 保存 在 person 表 中 。 

但 是 ， 在 这 种 映射 策略 下 ， 如 果 执行 多 态 查询 时 ， 也 需要 跨越 多 表 进 行 查询 。 例 如 ， 查 询 满足 某 
个 条 件 的 Person 实例 ，Hibernate 将 会 从 person_inf 表 中 查询 数据 ， 也 会 从 Person 的 所 有 子 类 对 应 的 
表 中 查询 数据 ， 然 后 对 这 些 结果 数据 进行 union 元 素 一 一 这 也 是 这 种 映射 策略 被 称 为 union-subclass 
的 原因 。 

在 这 种 映射 策略 下 ， 插 入 与 上 面 的 示例 相同 的 数据 。 如 图 6.10 所 示 是 person_inf 表 中 的 内 容 。 


ysql> select * from person_inf; 


mame gender | detail | zip country 了 | 


Ti Yeeku ii 男 天 河 434333 ”中 国 
村 em 虽 
图 6.10 ”使 用 union-subclass 映射 策略 时 父 类 实例 对 应 的 表 

正如 前 面 介绍 的 ，person_inf 表 中 仅仅 保存 Person 类 实例 的 数据 ， 而 Person 子 类 实例 的 数据 则 保 
存在 对 应 的 表 中 。 因 为 子 类 在 Person 类 的 基础 上 增加 了 额外 的 属性 ， 因 此 ， 其 子 类 对 应 表 的 数据 列 将 
更 多 。 图 6.11 显示 了 Employee 类 对 应 表 的 内 容 。 


person_id nane 


图 6.11 使 用 union-subclass 映射 策略 时 Employee 实例 对 应 的 表 


依 此 类 推 ，Manager 类 对 应 的 表 则 应 该 有 更 多 的 数据 列 ， 如 图 6.12 所 示 是 Manager 类 实例 保存 的 
数据 表 。 


J 
图 6.12 使 用 union-subclass 映射 策略 时 Manager 实例 对 应 的 表 
采用 这 种 映射 策略 时 ， 底 层 数据 库 的 数据 看 起 来 更 符合 正常 情况 下 的 数据 库 设 计 ， 不 同 实体 的 数 


| 采用 unionsubelass 映射 生 咯 时 ， 几乎 难以 看 出 子 类 和 父 类 表 之 间 的 联系, 除了 子 类 | 
。。 表 会 包含 父 类 表 的 所 有 数据 列 之 外 ， 如 果 没 有 副 除数 据 ， 整 个 继承 树 里 所 有 实例 的 主键 
加 起 来 是 连续 的 、 


将 subclass 映射 策略 生成 的 数据 表 与 图 6.10、6.11、6.12 放 在 一 起 对 比 ， 不 难 发 现 这 种 吴 遇 策略 
其 实 就 是 将 图 6.6 所 示 的 数据 表 进 行 横向 分 割 ， 因 此 笔者 也 把 这 种 策略 成 为 “横向 分 割 映射 ”。 


6.3 Hibernate 的 批量 处 理 


Hibernate 完全 以 面向 对 象 的 方式 来 操作 数据 库 ， 当 程序 里 以 面向 对 象 的 方式 操作 持久 化 对 象 时 ， 
将 被 自动 转换 为 对 数据 库 的 操作 。 例如 我 们 调用 Session 的 delete0 方 法 , 来 删除 持久 化 对 象 , Hibernate 
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将 负责 删除 对 应 的 数据 记录 : 当 我 们 执行 持久 化 对 象 的 setter 方法 时 ，Hibernate 将 自动 转换 为 底层 的 
update 语句 ， 修 改 数据 库 的 对 应 记录 。 

问题 是 ， 如果 我 们 需要 同时 更 新 100000 条 记录 ， 是 不 是 要 逐一 加 载 100000 条 记录 ， 然 后 依次 调 
用 setter 方法 一 一 这 样 不 仅 烦琐 ,数据 访问 的 性 能 也 十 分 糟糕 为 了 面 对 这 种 批量 处 理 的 场景 , Hibernate 
提供 了 批量 处 理 的 解决 方案 。 下 面 分 别 从 批量 插入 、 批 量 更 新 和 批量 删除 三 个 方面 介绍 如 何 面 对 这 种 
批量 处 理 的 情形 。 


》>》>6.3.1 批量 插入 


如 果 需 要 将 100000 条 记录 插入 数据 库 ， 通 过 Hibernate 可 能 会 采用 如 下 做 法 : 
Session session ~ sessionFactory.openSession(); 
Transaction tx = session.beginTransaction(); 
// 循 环 100000 次 来 插入 100000 条 记录 
for ( int i=0; i<100000; i++ ) 
{ 
User u = new User (..... js 
session.save lu); 
} 
tx.commit () 
session.close(); 


但 随 着 这 个 程序 的 运行 ， 总 会 在 某 个 时 候 运 行 失败 ， 并且 抛 出 OutOfMemoryException (内 存 溢 出 
异常 )。 这 是 因为 Hibernate 的 Session 持 有 一 个 必 选 的 一 级 缓存 , 所 有 的 User 实例 都 将 在 Session 级 别 
的 缓存 区 进行 了 缓存 的 缘故 。 

为 了 解决 这 个 问题 ， 有 个 非常 简单 的 思路 : 定时 将 Session 缓存 的 数据 刷 入 数据 库 ， 而 不 是 一 直 
在 Session 级 别 缓 在。 可 以 考虑 设计 一 个 累加 器 ， 每 保存 一 个 User 实例 ， 累 加 器 增加 1。 根 据 累加 器 
的 值 决 定 是 否 需 要 将 Session 缓存 中 的 数据 刷 入 数据 库 。 

下 面 是 增加 100000 个 User 实例 的 代码 片段 。 

程序 清单 : codes\06\6.3\batchInsert\src\lee\UserManager.java 

private void addUsers()throws Exception 

// 打 开 Session 
Session session = HibernateUtil.currentSession(); 
// 开 始 事务 
Transaction tx = session,.beginTransaction(); 


V/ 循 环 100000 次 ,插入 100000 条 记录 
for (int 1 = 0 ; 1 < 100000 ;i++ ) 


{ 

// 创 建 0ser 实例 

User ul = new User(); 

ul.setName ("xxxxx" + i); 

ul.setAge (i); 

ul.setNationality("china"); 

// 在 Session 级 别 缓存 User 实例 

session.save (ul); 

// 每 当 累 加 器 是 20 的 倍数 时 ， 将 Session 中 数据 刷 入 数据 库 ， 

// 并 清空 Session 缓存。 

if (i % 20 == 0) 

{ < 
session. flush(); 
session.clear(); 

} 


7/ 提交 事务 

tx.commit () 

/7 关闭 事务 
HibernateUtil.closeSession()7 
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上 面 的 代码 中 当 i% 20 一 0 时 ， 手 动 将 Session 处 缓存 的 数据 写 入 数据 ， 并 且 清空 Session 缓存 
里 的 数据 。 除 了 要 对 Session 级 别 缓存 进行 处 理 外 ， 还 应 该 通过 如 下 配置 来 关闭 SessionFactory 的 二 
级 缓存 : 


hibernate.cache.use_second level_cache false 


“六 -注意 :* 
除了 要 手动 


空 Session 级 别 的 缓存 外 ， 最 好 关闭 SessionFactory 级 别 的 二 级 缓存 。 
和 否则， 即使 手动 flush Session 级 别 的 缓存 ， 但 因为 在 SessionFactory 还 有 二 级 缓存 ， 也 可 ey 


能 引发 异常 。 关 于 二 级 缓存 的 介绍 请 参考 后 面 的 内 容 . 


> >》6.3.2 批量 更 新 


上 面 介绍 的 方法 同样 适用 于 批量 更 新 数据 ， 如 果 需 要 返回 多 行 数据 ， 应 该 使 用 scroll(0 方 法 ， 从 而 
可 以 充分 利用 服务 器 端 游标 所 带 来 的 性 能 优势 。 下 面 是 进行 批量 更 新 的 代码 片段 。 
程序 清单 : codes\06\6.3\batchUpdate\src\lee\UserManagerjava 


private void updateUsers() throws Exception 
{ 
// 打 开 Session 
Session session = HibernateUtil.currentSession(); 
// 开 始 事务 
Transaction tx = session.beginTransaction(); 
// 查 询 出 User 表 中 的 所 有 记录 
ScrollableResults users = session.createQuery ("from User") 
.setCacheMode (CacheMode . IGNORE) 
scroll (ScrollMode .FORWARD_ONLY) ; 
int count=0; 
// 遍 历 user 表 中 的 全 部 记录 
while ( users.next() ) 
{ 
User u = (User) users.get (0); 
u.setName ("新 用 户 名 "+ count); 
// 当 count 为 20 的 倍数 时 ， 
// 将 更 新 的 结果 从 Session 中 flush 到 数据 库 。 
if ( ttcount $20 == 0 ) 
{ 
session. flush() ; 
session.clear(); 
} 
} 
tx.commit () 7 
HibernateUtil.closesession(); 
2 


通过 这 种 方式 ， 虽 然 可 以 执行 批量 更 新 ， 但 效果 非常 不 好 。 执行 效率 不 高 ， 需 要 先 执行 数据 查询 ， 
然后 再 执行 数据 更 新 , 而 且 这 种 更 新 将 是 逐 行 更 新 , 即 每 更 新 一 行 记录 , 都 需要 执行 一 条 update 语句 ， 
性 能 也 非常 低下 。 

为 了 避免 这 种 情况 ，Hibernate 提供 了 一 种 类 似 于 DML 语句 的 批量 更 新 、 批 量 删除 的 HQL 语法 。 


和 6.3.3 DML 风格 的 批量 更 新 /删除 


Hibernate 提供 的 HQL 语句 也 支持 批量 的 UPDATE 和 DELETE 语法 。 
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批量 UPDATE 和 DELETE 语句 的 语法 格式 如 下 : 

UPDATE | DELETE FROM? <ClassName> [WHERE WHERE_CONDITIONS] 

关于 上 面 的 语法 格式 有 如 下 4 点 值得 注意 : 

> 在 FROM 子 句 中 ，FROM 关键 字 是 可 选 的 ， 即 完全 可 以 不 写 FROM 关键 字 。 

> 在 FROM 子 句 中 只 能 有 一 个 类 名 ， 该 类 名 不 能 有 别名 。 

> 不 能 在 批量 HQL 语句 中 使 用 连接 ， 显 式 或 者 隐 式 的 都 不 行 。 但 可 以 在 WHERE 子 句 中 使 用 
子 查 询 。 

> 整个 WHERE 子 句 是 可 选 的 。WHERE 子 句 的 语法 和 HQL 语句 中 WHERE 子 句 的 语法 完全 
相同 。 

假设 对 于 上 面 需要 批量 更 改 User 类 实例 的 name 属性 ， 可 以 采用 如 下 代码 片段 完成 。 

程序 清单 : codes\06\6.3\batchUpdate2\src\lee\UserManagerjava 


private void updateUsers()throws Exception 
{ 


// 打 开 Session 
Session session = HibernateUtil.currentSession(); 

// 开 始 事务 

Transaction tx = session.beginTransaction(); 

// 定 义 批量 更 新 的 HQL 语句 

String hqlUpdate = "update User set name = :newName"; 
// 执 行 更 新 


int updatedEntities = session.createQuery( hqlUpdate ) 
“setString( "newName", "新 名 字 ”) 
-executeUpdate() ; 
// 提 交 事务 
tx.commit (); 
HibernateUtil.closeSession(); 
} 
从 上 面 的 代码 中 可 以 看 出 ， 这 种 语法 非常 类 似 于 PreparedStatement 的 executeUpdate() 语 法 ， 实 际 
上 ，HQL 的 这 种 批量 更 新 就 是 直接 借鉴 了 SQL 语法 的 UPDATE 语句 。 
区 
“ 注 刘 :站 
使 用 这 种 批量 更 新 语法 时 ， 通 常 只 需要 执行 一 次 SQL 的 UPDATE 语句 ， 就 可 以 完 
成 所 有 满足 条 件 记 录 的 更 新 。 但 也 可 能 需要 执行 多 条 UPDATE 语句 ,这 是 因为 有 继承 映 
射 等 特殊 情况 ， 例 如 有 一 个 Person 实例 ， 它 有 Customer 于 类 实例 。 当 批量 更 新 Person 


Ea 


实例 时 ,也 需要 更 新 Customer 实例 . 如 果 采 用 joined-subclass 或 union-subclass 映射 策略 
时 ，Person 和 Customer 实例 保存 在 不 同 的 表 中 ， 因 此 可 能 需要 多 条 UPDATE 语 身 。 可 


执行 一 个 HQL DELETE， 同 样 使 用 Query.executeUpdate() 方法 ， 下 面 是 一 次 删除 上 面 全 部 记录 
的 代码 片段 。 
程序 清单 : codes\06\6.3\batchDelete\src\lee\UserManagerjava 


private void deleteUsers()throws Exception 
{ 


// 打 开 Session - 

Session session = HibernateUtil.currentSession(); 

// 开 始 事务 

Transaction tx = session.beginTransaction(); 

// 定 义 批量 删除 的 HQL 语句 

string hqlDelete = "delete User"; 

// 执 行 删除 

int deletedEntities = session.createQuery( hqlDelete ) 
a te(); 

// 提 交 事务 


tx.commit (); 
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HibernateUtil.closeSession(); 
于 


Query.executeUpdate() 方 法 返回 一 个 整 型 值 , 该 值 是 受 此 操作 影响 的 记录 数量 。 我 们 知道 , Hibernate 
的 底层 操作 实际 上 是 由 JDBC 完成 的 ， 因 此 ， 如 果 有 批量 UPDATE 或 DELETE 操作 被 转换 成 多 条 
UPDATE 或 DELETE 语句 ， 该 方法 将 只 能 返回 最 后 一 条 SQL 语句 影响 的 记录 行 数 。 


6.4 使 用 HQL 查询 


Hibernate 提供 异常 强大 的 查询 体系 ， 使 用 Hibernate 有 多 种 查询 方式 可 以 选择 ， 既 可 以 使 用 
Hibernate 的 HQL 查询 ,也 可 以 使 用 条 件 查询 ,甚至 可 以 使 用 原生 的 SQL 查询 语句 。 不 仅 如 此 ,Hibernate 
还 提供 了 一 种 数据 过 滤 功 能 ， 这 些 都 用 于 筛选 目标 数据 。 

其 中 , HQL 查询 是 Hibernate 配备 的 功能 强大 的 查询 语言 ,这 种 HQL 语句 被 设计 为 完全 面向 对 象 
的 查询 , 它 可 以 理解 如 继承 、 多 态 和 关联 之 类 的 概念 。 而 且 HQL 可 以 使 用 绝 大 部 分 SQL 函数 , EJB 3.0 
操作 和 函数 ， 并 提供 了 一 些 HQL 函数 ， 用 以 提高 HQL 查询 的 功能 。 


》>》>》6.4.1 HQL 查询 


HQL 是 Hibernate Query Language 的 缩写 ，HQL 的 语法 很 像 SQL 的 语法 ， 但 HQL 是 一 种 面向 
对 象 的 查询 语言 。SQL 的 操作 对 象 是 数据 表 、 列 等 数据 库 对 象 ， 而 HQL 的 操作 对 象 是 类 、 实 例 、 属 

HQL 是 完全 面向 对 象 的 查询 语言 ， 因 此 可 以 支持 继承 、 多 态 等 特性 。 

HQL 查询 依赖 于 Query 类 , 每 个 Query 实例 对 应 一 个 查询 对 象 。 使 用 HQL 查询 按 如 下 步骤 进行 : 

(1) 获取 Hibernate Session 对 象 。 

(2) 编写 HQL 语句 。 

(3) 以 HQL 语句 作为 参数 ， 调 用 Session 的 createQuery 方法 创建 查询 对 象 。 
(4) 如 果 HQL 语句 包含 参数 ， 则 调用 Query 的 setXxx 方法 为 参数 赋值 。 

(5) 调用 Query 对 象 的 list 等 方法 返回 查询 结果 列表 持久 化 实体 集 )。 

下 面 的 查询 示例 示范 了 HQL 查询 的 基本 用 法 ， 本 示例 程序 涉及 了 两 个 关联 实体 ， 即 Person 和 
MyEvent。 关 于 两 个 实体 的 关联 映射 ， 以 及 编写 关联 实体 的 持久 化 类 ， 此 处 不 再 袭 述 ， 读 者 可 自行 参 
考 光 盘 里 codes\06\6.4\HQL 路 径 下 的 代码 。 下 面 是 执行 HQL 查询 的 程序 。 

程序 清单 : codes\06\6.4\HQL\src\lee\HqlQueryjava 
public class HqlQuery 
public static void main(String[] args) 
throws Exception 
: HqlQuery mgr = new HqlQuery(); 


// 调 用 查询 方法 

mgr. findPersons (); 

// 调 用 第 二 个 查询 方法 
mgr. findPersonsByHappenDate (); 
/调用 第 二 个 查询 方法 

mgr. findPersonProperty (); 


} 

// 第 一 个 查询 方法 

private void findPersons() 

{ 
// 获 得 Hibernate Session 
Session sess = HibernateUtil.currentSession(); 
// 开 始 事务 


Transaction tx = sess.beginTransaction(); 
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// 以 HQL 语句 创建 Query 对 象 . 
// 执 行 setString 方法 为 HQL 语句 的 参数 赋值 
//Query 调用 1ist 方法 访问 查询 的 全 部 实例 
List pl = sess.createQuery ("select distinct P from Person p " 
+ "join p.myEvents where title = :eventTitle") 
.setstring ("eventTitle", "很 普通 的 事情 ") 
1ist(); 
// 遍 历 查询 的 全 部 结果 
for (Iterator pit = pl.iterator() ; pit.hasNext(); ) 
{ 
Person p = (Person)pit.next(); 
System.out .println (p.getName () ); 


} 

// 提 交 事务 

tx.commit (); 
HibernateUtil.closesession(); 


} 
/7 第 二 个 查询 方法 
private void findPersonsByHappenDate()throws Exception 
{ 
// 获 得 Hibernate Session 对 象 
Session sess = HibernateUtil.currentSession(); 
Transaction tx = sess.beginTransaction(); 
// 解 析出 Date 对 象 
SimpleDateFormat sdf ~ new SimpleDateFormat ("yyyy-MM-dd"); 
Date start = sdf.parse("2005-01-01"); 
System.out .println ("系统 开始 通过 日 期 查找 人 "+ start); 
// 通 过 Session 的 createQuery 方法 创建 Query 对 象 
List pl = sess.createQuery ("select distinct P from Person p " 
+ "inner join p.myEvents event where event.happenDate " 
+ "between :firatDate and :endDate") 
// 设 置 参数 
-setDate("firstDate", start) 
.setDate ("endDate",new Date()) 
// 返 回 结果 集 
list(); 
// 遍 历 结果 集 
for (Iterator pit = pl.iterator() ; pit.hasNext(); ) 
{ 
Person p = ( Person )pit.next(); 
System.out .println(p.getName ())» 
} 
tx.commit (); 
HibernateUtil.closesession(); 


} 
// 第 三 个 查询 方法 ， 查 询 属性 
private void findPersonProperty() 
{ 
// 获 得 Hibernate Session 
Session sess = HibernateUtil.currentSession{)7 
// 开 始 事务 
Transaction tx = sess.beginTransaction(); 
// 以 HQL 语句 创建 Query 对 象 . 
// 执 行 setString 方法 为 HQL 语句 的 参数 莱 值 
//Query 调用 1ist 方法 访问 查询 的 全 部 属性 
List pl = sess.createQuery ("select distinct p.id, p.name , p.age " 
+ "from Person P join " 
+ "p.myEvents") 
-1ist(); 
// 踪 历 查 询 的 全 部 结果 
for (Iterator pit = pl.iterator().; pit.hasNext(); ) 
{ 
Object{] objs = (Object[])pit.next(); 
System.out.printin(java.util.Arrays.tostring (objs))7 


// 提 交 事务 
tx.commit (); 
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HibernateUtil.closeSession()7 
二 
} 


由 上 面 的 HQL 语句 可 以 看 出 ， 执 行 HQL 语句 类 似 于 用 PreparedStatement 执行 SQL 语句 ， 因 此 
HQL 语句 中 可 以 使 用 占 位 符 作为 参数 。HQL 的 占 位 符 既 可 使 用 英文 问号 (?)， 这 与 SQL 语句 中 的 占 
位 符 完全 一 样 ， 也 可 使 用 有 名 字 的 占 位 符 ， 使 用 有 名 字 的 占 位 符 时 ， 应 该 在 占 位 符 名 字 前 增加 英文 时 
号 (:)， 如 上 HQL 语句 所 示 。 

成 功 编写 了 HQL 语句 之 后 ， 就 可 使 用 Session 的 createQuery(hql) 方 法 创建 一 个 Query，Query 对 
象 使 用 setXxx() 方 法 为 HQL 语句 的 参数 赋值 。Query 的 所 有 setXxx() 方 法 都 有 两 个 版 本 ， 分 别 用 于 根 
据 参 数 索引 赋值 和 根据 参数 名 字 赋 值 ， 具 体 请 查阅 Query 接口 的 API 说 明 。 

Query 对 象 可 以 连续 多 次 为 HQL 参数 赋值 ， 这 得 益 于 Hibernate Query 的 设计 。 通 常 的 setXxxO 
方法 返回 值 都 是 void, 但 Hibernate Query 的 setXxx0 方 法 返回 值 是 Query 本 身 。 因此 , 程序 通过 Session 
创建 Query 后 ， 直 接 多 次 调用 setXxx0 方 法 为 HQL 语句 的 参数 赋值 。 

Query 最 后 调用 list() 方 法 返回 查询 到 的 全 部 结果 。 

Query 还 包含 如 下 两 个 方法 。 

> ”setFirstResult(int firstResult)， 设 置 返回 的 结果 集 从 第 几 条 记录 开始 。 

> ”setMaxResults(int maxResults): 设置 本 次 查询 返回 的 结果 数目 。 

这 两 个 方法 用 于 对 HQL 查询 实现 分 页 控制 。 

业 


”执行 上 面 程序 之 前 ,一定 要 先导 入 codes\06\6.4\HQL 目录 下 的 data .sql 脚本 ,通过 该 
脚本 为 本 程序 准备 数据 。 ky 


HQL 语句 本 身 是 不 区 分 大 小 写 的 。 也 就 是 说 ，HQL 语句 的 关键 字 、 函 数 都 是 不 区 分 大 小 写 的 。 
但 HQL 语句 中 所 使 用 的 包 名 、 类 名 、 实 例 名 、 属 性 名 都 区 分 大 小 写 。 


下 面 简单 介绍 HQL 语句 的 语法 。 
>>6.4.2 HQL 查询 的 from 子 句 
from 是 最 简单 的 HQL 语句 , 也 是 最 基本 的 HQL 语句 。from 关键 字 后 紧 跟 持久 化 类 的 类 名 。 例如; 


form Person 

表明 从 Person 持久 化 类 中 选 出 全 部 的 实例 。 

大 部 分 时 候 ， 推 荐 为 该 Person 的 每 个 实例 起 别名 。 例 如 : 

from Person as P 

在 上 面 的 HQL 语句 中 ，Person 持久 化 类 中 实例 的 别名 为 p， 既 然 p 是 实例 名 ， 因 此 也 应 该 遵守 
Java 的 命名 规则 :第 一 个 单词 的 首 字母 小 写 ， 后 面 每 个 单词 的 首 字母 大 写 。 

命名 别名 时 ，as 关键 字 是 可 选 的， 但 为 了 增加 可 读 性 ， 建 议 保留 

from 后 还 可 同时 出 现 多 个 持久 化 类 ， 此 时 将 产生 一 个 笛 卡 儿 积 或 跨 表 的 连接 ， 但 实际 上 这 种 用 法 
很 少 使 用 ， 因 为 通常 当 我 们 可 能 需要 使 用 跨 表 的 连接 时 ， 可 以 考虑 使 用 隐 式 连接 或 者 显 式 连接 ， 而 不 
是 直接 在 from 后 紧 跟 多 个 表 名 。 


>>6.4.3 关联 和 连接 


当 程 序 需要 从 多 个 数据 表 中 取得 数据 时 ，SQL 语句 将 会 考虑 使 用 多 表 连 接 查 询 。Hibernate 使 用 关 
联 映射 来 处 理 底层 数据 表 之 间 的 连接 , 一 旦 我 们 提供 了 正确 的 关联 映射 后 ， 当 程序 通过 Hibernate 进行 
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持久 化 访问 时 ， 将 可 利用 Hibemate 的 关联 来 进行 连接 。 

HQL 支持 两 种 关联 连接 (join) 形式 ， 隐 式 (implicit) 与 显 式 (explicit)。 

隐 式 连接 形式 不 使 用 join 关键 字 ， 使 用 英文 点 号 〈.) 来 隐 式 连接 关联 实体 ， 而 Hibernate 底层 将 
自动 进行 关联 查询 。 例 如 如 下 HQL 语句 (具体 示例 请 参考 codes\06\6.4\ 下 的 implicit join 应 用 ): 

// 查 询 Person 持久 化 实体 ， 

from Person p where p.myEvent.title > :title 

上 面 的 p.myEvent 属性 的 实质 是 一 个 持久 化 实体 ， 因 此 Hibernate 底层 隐 式 地 自动 进行 连接 查询 。 

显 式 连 接 则 需要 使 用 xxx join 关键 字 ， 例 如 如 下 语句 : 

// 使 用 显 式 连接 

from Person p 


inner join p.myEvent event 
where event.happenDate < :endDate 


使 用 显 式 连接 时 可 以 为 相关 联 的 实体 ， 甚 至 是 关联 集合 中 的 全 部 元 素 指定 一 个 别名 。 

Hibernate 支持 的 HQL 连接 类 型 直接 借鉴 了 SQL99 多 表 查 询 的 关键 字 , 可 使 用 如 下 几 种 连接 方式 。 
> innerjoin (内 连接 ) ， 可 简写 成 join。 

> left outer join( 左 外 连接 ) ， 可 简写 成 leftjoin。 

> right outer join〔 右 外 连接 ) ， 可 简写 成 right join。 

> ”fulljoin (全 连接 ) ， 并 不 常用 。 

使 用 显 式 连接 时 ， 还 可 通过 HQL 的 with 关键 字 来 提供 额外 的 连接 条 件 ， 例 如 如 下 HQL 语句 : 

// 使 用 显 式 连接 

from Person p 

inner join p.myEvent event 


with p.id > event.id 
where event.happenDate < :endDate 


Hibernate 会 将 这 种 显 式 连接 转换 成 SQL99 多 表 连 接 的 语法 , 所 以 HQL 语句 中 的 with 关键 字 的 作 
用 基本 等 同 于 SQL99 中 on 关键 字 的 作用 : 都 是 用 于 指定 连接 条 件 。 通 过 在 HQL 语句 中 使 用 with 关 
键 字 ， 可 以 让 HQL 语句 执行 非 等 值 连接 查询 。 
提示 :一 一 一 一 一 一 一 一 一 一 一 一 一.… 
Fo -前面 已 经 提 到 过 ， 虽 然 Hibernate 号 称 是 持久 层 的 全 面 解决 方案 ， 使 用 Hibernate 可 以 
吕 无 须 使 用 JDBC 编程 。 但 实际 上 不 懂 SQL 语句 、 不 懂 JDBC 是 很 难 掌 握 Hibernate 的 。 关 | 
| ”于 SQL92、SQL99 的 多 表 连 接 查询 ， 请 参考 疯狂 Java 体系 的 《疯狂 Java 讲义 》. j 
还 有 一 点 必须 指出 : 由 于 此 处 的 inner join、left join 、right join、full join 的 实质 依然 是 基于 底层 
SQL 的 内 、 左 、 右 、 外 连接 的 ， 所 以 如 果 底 层 SQL 不 支持 这 些 外 连接 ， 那 么 执行 对 应 的 HQL 时 就 会 
相应 地 引发 异常 。 
对 于 隐 式 连接 和 显 式 连接 还 有 如 下 两 点 区 别 : 
> ” 隐 式 连接 底层 将 转换 成 SQL99 的 交叉 连接 , 显 式 连接 底层 将 转换 成 SQL99 的 inner join、 left 
join、right join 等 连接 。 
对 于 from Person p where p.myEvent.title > :title 这 条 隐 式 连 接 的 HQL 语句 , 执行 HQL 查询 后 将 看 
到 产生 如 下 所 示 的 SQL 语句 : 
select 
person0_.person_id as personl_0_, 
person0_.name as name0_, 
Person0_.age as age0_, 
person0_.event_id as event4 0_ 
from 
person_inf person0_ eross 
join 


479 


http://52pdf.taobao.com 
米 量 狼 Java EE 企业 应 用 实战 (第 3 版) 一 


event_inf myeventl_ 

where 
person0_.event_id-myevent1_.event_id 
and myeventl1_.title>? 


而 对 于 from Person p left join p.myEvent event where event.happenDate < :endDate 这 条 显 式 连接 的 
HQL 语句 ， 执 行 HQL 查询 后 将 看 到 产生 如 下 所 示 的 SQL 语句 : 


select 
person0_.person_id as personl_0_， 
Person0_.name as name0_, 
Person0_.age as age0_, 
person0_.event_id as event4 0 
from 
person_inf person0_ 
left outer join 
@vent_inf myevent1_ 
on person0_.event_id=myeventl_.event_id 
where 
myeventl_.happenDate<? 


对 比 这 两 条 SQL 语句 ， 不 难 发 现 第 一 条 SQL 语句 是 SQL99 的 交叉 连接 ， 而 第 二 条 SQL 语句 则 
是 SQL99 的 左 外 联接 语法 一 一 具体 到 底 使 用 哪 种 连接 方法 ， 则 取决 于 HQL 语句 的 显 式 连接 使 用 了 哪 
种 连接 方式 。 

> ” 隐 式 连接 和 显 式 连接 查询 后 返回 的 结果 不 同 。 

当 HQL 语句 中 省 略 select 关 键 字 时 ,使 用 隐 式 连接 查询 返回 的 结果 是 多 个 被 查询 实体 组 成 的 集合 。 
如 上 面 第 一 条 SQL 语句 所 示 ， 它 只 选择 了 person 表 中 的 数据 列 ， 所 以 查询 得 到 的 结果 是 Person 对 象 
组 成 的 集合 。 

当 使 用 显 式 连接 查询 的 HQL 语句 中 省 略 select 关键 字 时 ,返回 的 结果 也 是 集合 ， 但 集合 元 素 是 被 
查询 持久 化 对 象 、 所 有 被 关联 的 持久 化 对 象 所 组 成 的 数组 。 如 上 面 第 二 条 SQL 语句 所 示 ， 它 同时 选择 
了 person、event_table 表 中 的 所 有 数据 列 ， 查 询 到 的 结果 集 的 每 条 记录 既 包 含 了 Person 实体 的 全 部 属 
性 ， 也 包含 了 MyEvent 实体 的 全 部 属性 。Hibernate 会 把 每 条 记录 封装 成 一 个 集合 元 素 ， 用 属于 Person 


的 属性 创建 Person 对 象 ， 属 于 MyEvent 的 属性 创建 MyEvent 对 象 …… 多 个 持久 化 实体 最 后 封装 成 一 
个 数组 来 作为 集合 元 素 。 


关于 隐 式 连接 和 显示 连接 还 有 非常 重要 的 一 点 需要 指出 , 这 是 由 Hibernate 版 本 升级 所 引发 的 问 
题 。 在 Hibernate 3.2.2 以 前 的 版 本 ，Hibernate 会 对 所 有 关联 实体 自动 使 用 隐 式 连接 。 对 于 如 下 HQL 
语句， 

from Person p 

Where p.myBvents.title = :eventTitle 


无 论 如 何 ，Hibernate 将 对 上 面 的 p.myEvents.title 自动 使 用 隐 式 内 连接 ， 因 此 上 面 的 HQL 语句 总 
是 有 效 的 。 
从 Hibernate 3.2.3 以 后 ，Hibernate 改变 了 这 种 隐 式 连接 的 策略 ， 还 是 对 于 这 条 同样 的 HQL 语句 ， 
则 可 能 出 现 以 下 两 种 情况 : 
> 如果 myEvents 是 普通 组 件 属性 ， 或 单个 的 关联 实体 ， 则 Hibernate 会 自动 生成 隐 式 内 连接 ， 
上 面 HQL 语句 依然 有 效 。 
> 如果 myEvents 是 一 个 集合 (包括 1 一 N、N 一 N 关联 ) ， 那 么 系统 将 会 出 现 QueryException 
异常 ， 异 常 提示 信息 为 : illegal attempt to dereference collection 。 
根据 Hibernate 官方 说 法 : 这 样 可 以 使 得 隐 式 连接 更 具 确 定性 (原文 : This makes implicit joins more 
deterministic ) 。 
为 此 ，Hibernate 推荐 将 上 面 的 HQL 语句 写成 : 
from Person p 


inner join p.myEvents © 
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where e.title = :eventTitle 
这 条 HQL 语句 将 会 返回 一 个 集合 ， 集 合 元 素 是 Person 实体 和 MyEvent 实体 组 成 的 数组 。 
如 果 只 想 获 取 Person 组 成 的 集合 ， 则 需要 改写 成 : 


select p from Person p 
inner join p.myEvents @ 
where e.title = :eventTitle 


但 上 面 的 语句 有 可 能 返回 多 个 完全 相同 的 Person 对 象 ， 想 一 想 SQL 多 表 连 接 查 询 的 结果 就 可 知 
道 原因 了 。 
如 果 想 得 到 由 Person 实体 组 成 的 集合 ， 且 元 素 不 重复 ， 应 该 改 为 如 下 HQL 语句 : 


aelect diatinct p from Person p 
inner join p.myEvents e 
where e.title = :eventTitle 


也 就 是 说 ， 对 于 Hibemate 3.2.3 以 后 的 版 本 ， 如 果 关 联 实体 是 单个 实体 或 单个 的 组 件 属 性 ，HQL 
依然 可 以 使 用 英文 点 号 〈.) 来 隐 式 连接 关联 实体 或 组 件 ， 但 如 果 关 联 实体 是 集合 (包括 1 一 N 关联 、 
NN 一 N 关联 和 集合 元 素 是 组 件 等 )， 则 必须 使 用 xxx join 来 显 式 连接 关联 实体 或 组 件 。 

对 于 有 集合 属性 的 ，Hibernate 默认 采用 延迟 加 载 策略 。 例 如 ， 对 于 持久 化 类 Person， 有 集合 属性 
scores。 加 载 Person 实例 时 ， 默 认 不 加 载 scores 属性 。 如 果 Session 被 关闭 ，Person 实例 将 无 法 访问 关 
联 的 scores 属性 。 

为 了 解决 该 问题 ， 可 以 在 Hibernate 映射 文件 中 指定 lazy="fasle" 来 关闭 延迟 加 载 。 

还 有 一 种 方法 ， 使 用 join fetch， 例 如 : 


from Person as p 
”join fecth p.scores 


上 面 的 fetch 关键 字 将 导致 Hibernate 在 初始 化 Person 对 象 时 ， 同 时 抓 取 该 Person 关联 的 scores 
集合 属性 。 

使 用 join fetch 时 通常 无 须 指定 别名 ， 因 为 相关 联 的 对 象 不 应 当 在 where 子 句 或 其 他 任何 子 句 ) 
中 使 用 。 而 且 被 关联 的 对 象 也 不 会 在 被 查询 的 结果 中 直接 返回 ， 而 是 应 该 通过 其 父 对象 来 访问 。 

关于 fecth 关键 字 的 作用 ， 读 者 可 以 查看 光盘 中 codes\06\6.4\ 路 径 下 的 implicit_ join 应 用 ， 对 比 
HqlQuery 类 里 findPersonsByHappenDate0 和 findPersonsFetchMyEvent0 两 个 方法 ， 将 会 对 fetch 关键 字 
有 更 深刻 的 认识 。 

使 用 fecth 关键 字 时 有 如 下 几 个 注意 点 : 

> fetch 不 应 该 与 setMaxResults() 或 setFirstResult() 共 用 。 因 为 这 些 操作 是 基于 结果 集 的 , 而 
在 预先 抓 取 集合 类 时 可 能 包含 重复 的 数据 ， 即 无 法 预先 知道 精确 的 行 数 。 
fetch 不 能 与 独立 的 with 条 件 一 起 使 用 。 
如 果 在 一 次 查询 中 fetch 多 个 集合 ， 可 以 查询 返回 笛 卡 儿 积 ， 因 此 请 多 加 注意 。 
对 bag 映射 而 言 ， 同 时 join fetch 多 个 集合 时 可 能 出 现 非 预 期 结果 ， 因 此 需要 谨慎 使 用 。 

> ”fulljoin fetch 与 right join fetch 是 没有 任何 意义 的 。 

如 果 在 映射 文件 映射 属性 时 通过 指定 lazy="true" 启 用 了 延迟 加 载 〈 这 种 延迟 加 载 是 通过 字 节 码 增 
强 来 实现 的 ), 然后 程序 里 又 希望 预 加 载 那 些 原本 应 延迟 加 载 的 属性 , 则 可 以 通过 fetch all properties 来 
强制 Hibernate 立即 抓 取 这 些 属性 。 例 如 : 


from Document fetch all properties order by name 
from Document doc feteh all properties where lower(doc.name) like ‘gcats$' 


》>》>6.4.4 HQL 查询 的 select 子 名 


澡 - 浊 本 


select 子 句 用 于 选择 指定 的 属性 或 直接 选择 某 个 实体 ， 当 然 select 选择 的 属性 必须 是 from 后 持久 
化 类 包含 的 属性 。 例 如 : 
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select p.name from Person as p 

select 可 以 选择 任意 属性 ， 即 不 仅 可 以 选择 持久 化 类 的 直接 属性 ， 还 可 以 选择 组 件 属性 包含 的 属 
性 。 例 如 : 

select p.name.firstName from Person as Pp 

在 通常 情况 下 ， 使 用 select 子 句 查询 的 结果 是 集合 ， 而 集合 元 素 就 是 select 后 的 实例 、 属 性 等 组 
成 的 数组 。 

在 特殊 情况 下 ， 如 果 select 后 只 有 一 项 (包括 持久 化 实例 或 属性 )， 则 查询 得 到 的 集合 元 素 就 是 该 
持久 化 实例 或 属性 。 

如 果 select 后 有 多 个 项 ， 则 每 个 集合 元 素 就 是 选择 出 的 多 项 组 成 的 数组 。 例 如 如 下 HQL 语句 : 

select p.name ，P from Person as p 

执行 该 HQL 语句 得 到 的 集合 元 素 是 类 似 于 [String , Person] 结 构 的 数组 ， 其 中 第 一 个 元 素 是 Person 
实例 的 name 属性 ， 第 二 个 元 素 是 Person 实例 。 


即使 seleet 后 的 列表 项 先 出 革 个 持久 化 类 的 全 部 属性 ， 这 些 属性 依然 是 属性 ， 
Hibernate 不 会 将 这 些 属性 封装 成 对 象 .只 有 在 select 后 的 列表 里 给 出 持久 化 类 的 别名 (其 订 


select 也 支持 将 选择 出 的 属性 存 入 一 个 List 对 象 中 。 例 如 : 

select new list(p.name , p.address) from Person as 了 

执行 上 面 的 HQL 语句 后 得 到 一 个 集合 ， 其 集合 元 素 是 List 对 象 〈 默 认 的 集合 元 素 是 数组 )。 
甚至 可 以 将 选择 出 的 属性 直接 封装 成 对 象 。 例 如 : 


select new ClassTest(p.name ，P-address) from Person as p 


前 提 是 ClassTest 支持 p.name，p.address 的 构造 器 ， 假 如 p.name 的 数据 类 型 是 String， p.address 
的 数据 类 型 是 String， 则 ClassTest 必须 有 如 下 的 构造 器 : 

ClassTest (String s1，String s2) 

执行 上 面 的 HQL 语句 返回 的 结果 是 集合 ， 其 中 集合 元 素 是 ClassTest 对 象 〈 默 认 的 集合 元 素 是 
数组 )。 

select 还 支持 给 选中 的 表达 式 命名 别名 。 例 如 : 

select p.name as personName from Person as P 

这 种 用 法 与 new map 结合 使 用 更 普遍 。 例 如 : 

select new map (P -name as personName) from Person as p 

执行 上 面 的 HQL 语句 返回 的 结果 是 集合 ， 其 中 集合 元 素 是 Map 对 象 ， 以 personName 作为 Map 
的 key， 实 际 选 出 的 值 作为 Map 的 value。 


>>6.4.5 HQL 查询 的 聚集 函数 


HQL 也 支持 在 选 出 的 属性 上 ， 使 用 聚集 函数 。HQL 支持 的 聚集 函数 与 SQL 的 完全 相同 ， 有 如 下 


5 个 
avg: 计算 属性 平均 值 。 
count: 统计 选择 对 象 的 数量 。 
max: 统计 属性 值 的 最 大 值 
min: 统计 属性 值 的 最 小 值 。 
sum: 计算 属性 值 的 总 和 。 


YY" 
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例如 ， 如 下 HQL 语句 : 
select count(*) from Person 
select max(p.age) from Person as p 


select 子 句 还 支持 字符 串 连接 符 、 算 术 运 算 符 ， 以 及 SQL 函数 。 例 如 : 
select p.name || “” || p.address from Pers6n as p 


select 子 句 也 支持 使 用 distinct 和 all 关键 字 ， 此 时 的 效果 与 SQL 中 的 效果 完全 相同 。 
>>6.4.6 多 态 查询 


HQL 语句 被 设计 成 能 理解 多 态 查询 , from 后 跟 持久 化 类 名 ,不 仅 会 查询 出 该 持久 化 类 的 全 部 实例 ， 
还 会 查询 出 该 类 的 子 类 的 全 部 实例 。 

如 下 面 的 查询 语句 : 

from Person as p 

该 查询 语句 不 仅 会 查询 出 Person 的 全 部 实例 , 还 会 查询 出 Person 的 子 类 , 如 Teacher 的 全 部 实例 ， 
前 提 是 Person 和 Teacher 完成 了 正确 的 继承 映射 。 

HQL 支持 在 from 子 句 中 指定 任何 Java 类 或 接口 ， 查 询 会 返回 继承 了 该 类 的 持久 化 子 类 的 实例 
或 返回 实现 该 接口 的 持久 化 类 的 实例 。 下 面 的 查询 语句 返回 所 有 的 被 持久 化 的 对 象 。 

from java.lang.object o 


如 果 Named 接口 有 多 个 持久 化 实现 类 ， 下 面 语句 将 返回 这 些 持久 化 类 的 全 部 实例 。 


from Named as n 


| 后 面 的 两 个 查询 将 需要 多 个 SQL SELECT 语句 ， 因 此 无 法 使 用 order by 子 句 对 结果 
|。 集 排序 ， 从 而 不 多 许 对 这 些 查 询 结果 使 用 Query.scroll0 方 法 


》》6.4.7 HQL 查询 的 where 子 句 


where 子 句 用 于 筛选 选中 的 结果 ， 缩 小 选择 的 范围 。 如 果 没 有 为 持久 化 实例 命名 别名 ， 则 可 以 直 
接 使 用 属性 名 来 引用 属性 。 

如 下 面 的 HQL 语句 : 

from Person where name like \toms' 

上 面 的 HQL 语句 与 下 面 的 语句 效果 相同 : 

from Person as p where p.name like “tomg” 

在 后 面 的 HQL 语句 中 ， 如 果 为 持久 化 实例 命名 了 别名 ， 则 应 该 使 用 完整 的 属性 名 。 两 个 HQL 语 
句 都 可 返回 name 属性 以 tom 开头 的 实例 。 

复合 属性 表达 式 加 强 了 where 子 句 的 功能 ， 例 如 ， 如 下 的 HQL 语句 : 

from Cat cat where cat.mate.name like “kite” 

该 查询 将 被 翻译 成 一 个 含有 内 连接 的 SQL 查询 ， 翻 译 后 的 SQL 语句 如 下 : 

select * from cat_table as tablel cat_table as table2 


where tablel.mate = table2.id 
and tablel.name like “kits” 


实际 上 这 种 用 法 使 用 了 隐 式 连接 查询 ， 从 Hibemate 3.2.3 之 后 ， 只 有 当 cat.mate 属性 引用 的 是 普 
通 组 件 属性 或 者 单独 的 关联 实体 时 才 可 接着 在 后 面 使 用 点 号 (.) 来 引用 mate 的 属性 , 如 cat.mate.name; 
如 果 cat.mate 是 集合 属性 ，Hibernate 3.2.3 以 后 的 版 本 不 支持 这 种 用 法 。 


483 


http://52pdf.taobao.com 
蒋 量 角 Java EE 企业 应 用 实战 (第 3 版 ) 一 


只 要 没有 出 现 集合 属性 ，HQL 语句 可 使 用 点 号 来 隐 式 连接 多 个 数据 表 ， 如 下 面 的 HQL 查询 语句 
所 示 : 


from Foo foo 
where foo.bar.baz.customer.address.city like"guangzhous" 


执行 上 面 HQL 语句 时 会 生成 对 应 的 SQL 查询 语句 ， 将 变 成 一 个 四 表 连 接 的 查询 。 
“=” 运 算 符 不 仅 可 以 被 用 来 比较 属性 的 值 ， 也 可 以 用 来 比较 实例 。 


from Cat cat, Cat rival 
where cat.mate = rival.mate 
select cat, mate 

from Cat cat, Cat mate 
where cat.mate = mate 


特殊 属性 〈 小 写 ) id 可 以 用 来 表示 一 个 对 象 的 标识 符 。( 当然 也 可 以 使 用 该 对 象 的 属性 名 ， 使 用 
id 只 是 一 种 更 简洁 的 写法 。) 

from Cat as cat 

where cat.id = 123 


from Cat ,as cat where 
cat.mate.id = 69 


上 一 个 查询 是 一 个 内 连接 查询 ， 但 在 HQL 查询 语句 下 ， 无 须 体会 多 表 连 接 ， 而 完全 使 用 面向 对 
象 的 方式 查询 。 
id 甚至 可 代表 组 件 类 型 的 标识 符 ， 例 如 Person 类 有 一 个 组 件 类 型 的 标识 符 ， 它 由 country 属性 与 
medicareNumber 两 个 属性 组 成 。 
下 面 的 HQL 语句 有 效 : 
from Person as person 
where person.id.country = 'AU' 
and person.id.medicareNumber = 123456 
from Account as account 


where account.owner.id.country = 'AU' 
and account.owner.id.medicareNumber = 123456 


上 两 个 查询 跨越 两 个 表 : Person 和 Account， 是 一 个 多 表 连 接 查 询 ， 因 为 使 用 了 隐 式 连接 的 简洁 
语法 ， 所 以 感受 不 到 多 表 连 接 查询 的 烦琐 。 
在 进行 多 态 持久 化 的 情况 下 ，elass 关键 字 用 来 存 取 一 个 实例 的 鉴别 值 (discriminator value)。 顽 入 
where 子 句 中 的 Java 类 名 ， 将 被 作为 该 类 的 鉴别 值 。 例 如 : 
// 执 行 多 态 查询 时 ， 默 认 会 选 出 Cat 及 其 所 有 子 类 的 实例 
// 在 如 下 HQL 语句 中 ， 将 只 选 出 Domesticcat 类 的 实例 
from Cat cat where cat.class = DomesticCat 
当 where 子 句 中 的 运算 符 只 支持 基本 类 型 或 者 字符 串 时 ，where 子 句 中 的 属性 表达 式 必须 以 基本 
类 型 或 者 字符 串 结尾 ， 不 要 使 用 组 件 类 型 属性 结尾 ， 例 如 Account 有 Person 属性 ， 而 Person 有 Name 
属性 ，Name 有 firstName 属性 。 
看 下 面 两 条 语句 的 对 比 。 
下 面 的 属性 表达 式 正确 ， 因 为 Person 的 Name 属性 的 firstName 是 String 类 型 : 
from Account as a where a.person.name.firstName like "dd$" 
但 下 面 的 语句 是 错误 的 ， 因 为 Person 的 Name 属性 是 复合 类 型 的 ， 不 是 String 类 型 : 


from Account as a where a.person.name like "dds" 


>>6.4.8 表达 式 


HQL 的 功能 非常 丰富 ，where 子 句 后 支持 的 运算 符 异 常 丰富 ， 不 仅 包括 SQL 的 运算 符 ， 也 包括 
EJB-QL 的 运算 符 等 。 
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where 子 句 中 允许 使 用 大 部 分 SQL 支持 的 表达 式 ， 包 括 如 下 种 类 。 

> “数学 运算 符 : +、-、”、/ 等 。 

> ”二进制 比较 运算 符 ，=、>=、<=、<>、!=、like 等 。 

> ”逻辑 运算 符 : and、or、not 等 。 

> in,notin, between., isnull, is notnull, is empty、is notempty、 member of and not member 


of 等 。 

> 简单 的 case，case .… when ... then ... else ... end 和 case, case when ... then ... else ... 
end 等 。 

> ”字符 串 连 接 符 ， 如 value1 || value2， 或 使 用 字符 串 连 接 函 数 concat(value1 , value2)。 


> ”时 间 操 作 函 数 : current_date()、current_time()、current_timestamp()、second()、minute()、 
hour()、day()、month()、year() 等 。 

> HQL 还 支持 EJB-QL 3.0 所 支持 的 函数 或 操作 : substring()、trim()、lower()、upper()、length()、 
locate()、abs()、sqrt()、bit_length()、coalesce() 和 nullif() 等 。 

> ”支持 数据 库 的 类 型 转换 函数 ， 如 cast(… as …)， 第 二 个 参数 是 Hibernate 的 类 型 名 ， 或 者 
extract(… from …)， 前 提 是 底层 数据 库 支持 ANSI cast() 和 extract()。 

> ”如 果 底 层 数据 库 支 持 如 下 单行 函数 : sign()、trunc()、rtrim()、sin()， 则 HQL 语句 也 完全 可 

> HQL 语句 支持 使 用 英文 问号 〈?) 作为 参数 占 位 符 ， 这 与 JDBC 的 参数 占 位 符 一 致 ， 也 使 用 
命名 参数 占 位 符号 ， 方 法 是 在 参数 名 前 加 英文 冒号 (:) ， 例 如 :start_date，:x1 等 。 

当然 也 可 在 where 子 句 中 使 用 SQL 常量 , 例如 'foo'、69、'1970-01-01 10:00:01.0' 等 。 还 可 以 在 HQL 

语句 中 使 用 Java 中 的 public static final 类 型 的 常量 ， 例 如 ColorRED。 

除 此 之 外 ，where 子 句 还 支持 如 下 的 特殊 关键 字 用 法 。 

> ”HQL index() 函数 ， 作 用 于 join 的 有 序 集合 的 别名 。 

> HQL 函数 , 把 集合 作为 参数 ， size()、 minelement()、 maxelement()、 minindex()、maxindex()， 
还 有 特别 的 elements() 和 indices 函数 ， 可 以 用 数量 词 加 以 限定 ， some、all、exists、any、in。 

> in 与 between...and 可 按 如 下 方法 使 用 : 


from DomesticCat cat where cat.name between 'A' and 'B'; 
from DomesticCat cat where cat.name in ('Foo','Bar,'Bazs'); 


当然 ， 也 支持 not in 和 not between..…and 的 使 用 。 例 如 : 


from DomesticCat cat where cat.name not between 'A'! and 'B'; 
from DomesticCat cat where cat.name not in {('Foo','Bar','Baz'); 


> 子 句 is null 与 is not null 可 以 被 用 来 测试 空 值 。 例 如 : 


from DomesticCat cat where cat.name is null; 
from Person as p where p.address is not null; 


如 果 在 Hibernate 配置 文件 中 进行 如 下 声明 : 


<property name="hibernate.query. substitutions"strue 1, false 0</property> 

上 面 的 声明 表明 : HQL 转换 SQL 语句 时 ， 将 使 用 字符 1 和 0 来 取代 关键 字 tue 和 false， 然 
后 将 可 以 在 表达 式 中 使 用 布尔 表达 式 。 例 如 : 

from Cat cat where cat.alive = 0; 

> size 关键 字 用 于 返回 一 个 集合 的 大 小 。 例 如 : 


from Cat cat where cat.kittens.size > 0; 
from Cat cat where size(cat.kittens) > 0; 


> ”对 于 有 序 集合 ， 还 可 使 用 minindex 与 maxindex 函数 代表 最 小 与 最 大 的 索引 序数 。 同 理 ， 
可 以 使 用 minelement 与 maxelement 函数 代表 集合 中 最 小 与 最 大 的 元 素 。 例 如 : 
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from Calendar cal where maxelement (cal.holidays) > current_ date; 
from Order order where maxindex(order.items) > 100; 
from Order order where minelement (order.items) > 10000; 


> ”还 有 特别 有 用 的 elements() 和 indices() 函 数 , 用 于 返回 指定 集合 的 所 有 元 素 和 所 有 索引 。 还 
可 以 使 用 SQL 函数 any、some、all、exists、in 操作 集合 里 的 元 素 。 例 如 : 
7/ 操作 集合 元 素 


select mother from Cat as mother, Cat as kit 

where kit in elements (foo .kittens) 7 

//VP 的 name 属性 等 于 集合 中 某 个 元 素 的 name 属性 

select p from NameList list, Person p 

where p.name = some elements(list.names); 

// 操 作 集合 元 素 。 

from Cat cat where exists elements(cat.kittens) 

from Player p where 3 > all elements(p.scores) 

from Show show where 'fizard' in indices(show.acts); 

值得 指出 的 是 , 这 些 结构 变量 : size、 elements、 indices、 minindex、 maxindex、 minelement、 maxelement 
等 ， 只 能 在 where 子 句 中 使 用 。 

> 在 where 子 句 中 ， 有 序 集合 (数组 、List 集合 、Map 对 象 ) 的 元 素 可 以 通过 [ ] 运 算 符 访问 。 

例如 : 

//items 是 有 序 集合 属性 ，items [0] 代表 第 一 个 元 素 

from Order order where order.items[0] .id = 1234; 

//holidays 是 map 集合 属性 ，holidays [national] 代 表 key 为 national 的 元 素 

select person from Person person, Calendar calendar 

where calendar.holidays['national day'] = person.birthDay 

and person.nationality.calendar = calendar; 

// 下 面 同时 使 用 list 集合 map 集合 属性 

select item from Item item, Order order 

where order.items [order.deliveredItemIndices[0]] = item and order.id = 11; 

select item from Item item, Order order 

where order ,items[ maxindex(order.items) ] = item and order.id = 11; 

在 0 中 的 表达 式 甚至 可 以 是 一 个 算术 表达 式 。 例 如 : 

select item from Item item, Order order 

where order.items[size(order.items) - 1] = item; 


>》>6.4.9 orderby 子 名 
查询 返回 的 集合 可 以 根据 类 或 组 件 属性 的 任何 属性 进行 排序 。 例 如 : 


from Person as p 
order by p.name, p.age; 


还 可 使 用 asc 或 desc 关键 字 指 定 升序 或 降序 的 排序 规则 。 例 如 


from Person as p 
order by p.name asc , p.age desc; 


如 果 没有 指定 排序 规则 ， 默 认 采 用 升序 规则 。 即 : 使 用 和 不 使 用 asc 关键 字 是 没有 区 别 的 ， 加 asc 
是 升序 排序 ， 不 加 asc 也 是 升序 排序 。 


>>6.4.10 group by 子 名 


返回 聚集 值 的 查询 可 以 对 持久 化 类 或 组 件 属性 的 属性 进行 分 组 ， 分 组 使 用 group by 子 句 。 看 下 面 
的 HQL 查询 语句 : 


select cat.color, sum(cat.weight), count (cat) 
from Cat cat 
group by cat.color; 
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类 似 于 SQL 的 规则 ， 出 现在 select 后 的 属性 ， 要 么 出 现在 聚集 函数 中 ， 要 么 出 现在 group by 的 属 
性 列表 中 。 看 下 面 的 示例 : 
//select 后 出 现 的 id 处 在 grouP by 之 后 ， 而 name 属性 则 出 现在 聚集 函数 中 


select foo.id，avg (name)，max (name) 
from Foo foo join foo.names name 
group by foo.id 


having 子 句 用 于 对 分 组 进行 过 滤 ， 如 下 所 示 : 

select cat.color, sum(cat.weight), count(cat) 

from Cat cat 

group by cat.color 

having cat.color in (eg.Color.TABBY, eg.Color.BLACK) 


三 -注意 :w 一 


having 子 句 用 于 对 分 组 进行 过 滤 , 因此 having 子 句 只 能 在 有 group by 子 句 时 才 可 以 
使 用 ， 没 有 group by 子 句 ， 不 能 使 用 having 子 句 。 


Hibernate 的 HQL 语 会 直接 翻译 成 数据 库 SQL 语句 。 因 此 ,如 果 底 层 的 数据 库 支持 在 having 子 句 
和 group by 子 句 中 使 用 普通 函数 或 聚集 函数 ，HQL 的 having 与 order by 子 句 中 也 可 以 使 用 普通 函数 
和 聚集 函数 。 

例如 如 下 的 HQL 语句 : 

select cat 

from Cat cat 

join cat.kittens kitten 

group by cat 


having avg(kitten.weight) > 100 
order by count (kitten) asc, sum(kitten.weight) desc 


区 
p= 天 .注意 :有 … 
| group by 子 句 与 order by 子 句 中 都 不 能 包含 算术 表达 式 


>》6.4.11 了 于 查询 


如 果 底 层 数据 库 支持 子 查 询 , 则 可 以 在 HQL 语句 中 使 用 子 查询 , 与 SQL 中 子 查询 相似 的 是 , HQL 
中 的 子 查询 也 需要 使 用 英文 括号 〈0) 括 起 来 。 例 如 : 
from cat as fatcat 
where fatcat.weight > (select avg(cat.weight) from DomesticCat cat); 
与 SQL 子 查 询 语法 完全 类 似 ， 如 果子 查询 是 多 行 结果 集 ， 则 应 该 使 用 多 行 运 算 符 。 例 如 如 下 的 
HQL 语句 : 


from Cat as cat 

where not ( cat.name, cat.color ) in 

{select cat.name, cat.color from DomesticCat cat); 
from DomesticCat as cat 

where cat.name not in 

(select name.nickName from Name as name); 


SQL 语法 中 子 查 询 还 可 以 出 现在 select 子 句 之 后 ，HQL 也 支持 这 种 用 法 。 看 如 下 HQL 语句 : 


select cat.id, (select max(kit.weight)from cat.kitten kit) 
from Cat as cat 


区 
六 -注意 :站 
HQL 子 查询 只 可 以 在 select 子 句 或 者 where 子 名 中 出 现 . 
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如 果 在 select 子 查询 后 的 列表 中 包含 多 项 , 则 在 HQL 中 需要 使 用 一 个 元 组 构造 符 。 看 如 下 HQL 语句 : 


from Cat as cat 
where not (cat.name, cat.color) in 
(select cat.name, cat.color from DomesticCat cat); 


> >6.4.12 命名 查询 


HQL 查询 还 支持 将 查询 所 用 的 HQL 语句 放 入 配置 文件 中 ， 而 不 是 代码 中 。 通 过 这 种 方式 ， 可 以 
大 大 提高 程序 的 解 厢 。 

在 Hibernate 映射 文件 的 <hibernate-mapping.…. 亿 元 素 中 使 用 <query.…. 人 > 子 元 素来 定义 命名 查询 ， 使 
用 <query.. 人 > 元 素 只 需 指定 一 个 name 属性, 指定 该 命名 查询 的 名 字 。 该 元 素 的 内 容 就 是 命名 查询 的 HQL 
语句 。 下 面 是 定义 命名 查询 的 配置 文件 片段 。 

<!-- 定义 命名 查询 --> 

<query name="myNamedQuery"> 


<!-- 此 处 确定 命名 查询 的 HQL 语句 --> 
from Person as p where p-.age > ? 


</query> 
Session 里 提供 了 一 个 getNamedQuery(String name) 方 法 ， 该 方法 用 于 创建 一 个 Query 对 象 ， 一 旦 
获得 了 Query 对 象 ， 剩 下 的 操作 与 普通 HQL 查询 完全 一 样 。 下 面 是 程序 调用 命名 查询 的 示例 代码 。 
程序 清单 ，codes\06\6.4\named_HQL\src\lee\HqlQueryjava 
private void findByNamedouery1) 
throws Exception 


{ 

// 打 开 Hibernate 的 Session 和 事务 

Session sess ~ HibernateUtil.currentSession(); 

Transaction tx = sess.beginTransaction(); 

System.out ,println("=== 执 行 命名 查询 ===") ; 

// 执 行 命名 查询 

List pl = sess.getNanedQuery ("myNamedQuery") 
// 根 据 RQL 语句 里 参数 索引 为 参数 赋值 
.setInteger (0 ,20) 
,1ist(); 


// 选 代 输 出 查询 得 到 的 每 个 Person 对象 
for (Tterator pit = pl.iterator() ; pit.hasNext(); ) 


{ 
Person p = (Person )pit.next(); 
System.out.println(p.getName ()); 


上 
// 提 交 事 务 、 关 闭 session 

tx. commit ()» 
HibernateUtil.closesession(); 


由 上 面 的 程序 中 粗 体 字 代 码 可 以 看 出 ， 使 用 命名 查询 与 普通 查询 的 效果 基本 相似 ， 只 是 将 原来 的 
createQuery(String hql) 方 法 换 成 了 getNamedQuery(String name)， 剩 下 的 事情 几乎 完全 一 样 。 实 际 上 ， 
命名 查询 的 作用 仅仅 是 将 HQL 语句 从 Java 代码 中 提取 出 来 ， 放 到 映射 文件 中 配置 而 已 。 


提示 : 本 
总 命名 HQL 查询 (包括 后 面 的 命名 SQL 查询 ) 的 本 质 就 是 把 查询 语句 从 Java 代码 中 取 
出 来 ， 放 到 配置 文件 中 进行 管理 ， 并 为 这 条 查询 语句 起 个 名 字 。 这样 当 应 用 需要 修改 查询 | 

| 语句 时 ， 开 发 者 无 须 打 开 Java 代码 进行 修改 ， 直 接 修改 配置 文件 中 的 查询 语句 即 可 。 J 


6.5 条件 查询 


条 件 查询 是 更 具 面向 对 象 特 色 的 数据 查询 方式 。 条 件 查询 通过 如 下 三 个 类 完成 。 
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> ”Criteria: 代表 一 次 查询 。 

> ”Criterion: 代表 一 个 查询 条 件 。 

> Restrictions: 产生 查询 条 件 的 工具 类 。 

执行 条 件 查询 的 步骤 如 下 : 

(1) 获得 Hibernate 的 Session 对 象 。 

(2) 以 Session 对 象 创建 Criteria 对 象 。 

(3) 使 用 Restrictions 的 静态 方法 创建 Criterion 查询 条 件 。 
(4) 向 Criteria 查询 中 添加 Criterion 查询 条 件 。 

(5) 执行 Criteria 的 list 等 方法 返回 结果 集 。 

看 下 面 的 条 件 查 询 的 示例 程序 。 

程序 清单 :codes\06\6.5\eriteria\src\lee\CriteriaTestjava 


public class CriteriaTest 
{ 
public static void main(String[] args) 
{ 
CriteriaTest criteriaTest = new CriteriaTest (); 
criteriaTest. query(); 
criteriaTest. queryWithJoin(); 
criteriaTest .queryWithFecth(); 
HibernateUtil. sessionFactory.close(); 
} 
private void query() 


// 打 开 Session 和 事务 
Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction()} 
// 使 用 createcriteria 开始 条 件 查询 
List 1 = ion. createCriteria (Student.class) 

// 根 据 student 的 局 

"add( Restrictions.gt("name” , "a")) 

“list( 
Iterator it = 1.iterator(); 
System.out .println ("===== 简 单条 件 查询 获取 所 有 学 生 记录 =====") ; 
while (it.hasNext()) 
{ 


Student s = (Student)it.next(); 
System.out .println(s.getName ()); 
Set enrolments = s.getEnrolments(); 
Iterator iter ~ enrolments.iterator(); 
System.out .printin("===== 获 取 -" + s.getName() 
+ "~ 的 选课 记录 =====") ; 
while (iter.hasNext ()) 
{ 
Enrolment e = (Enrolment)iter.next(); 
System.out.println (e.getCourse () .getName ())’; 
} 
} 
txCommit (); 
HibernateUtil.closesession(); 


} 
// 示 范 根据 关联 实体 的 属性 过 滤 数 据 
private void queryWithJoin() 
{ 
// 打 开 Session 和 事务 
Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction(}; 
// 使 用 createCriteria 开始 条 件 查询 
List 1 = session.createCriteria (Student.class) 
// 此 处 增加 限制 条 件 必 须 是 Student 已 经 存在 的 属性 
-add( Restrictions.gt("studentNumber" , 20050231L)) 
// 如 果 要 增加 对 student 的 关联 类 的 属性 的 限制 
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Iterator it = 1.iterator(); 
System.out .println ("===== 关 联 条 件 查询 获取 所 有 学 生 记录 =====") ; 
while (it.hasNext () ) 
Student s = (Student)it.next(); 
System.out .println(s.getName()); 
Set enrolments = s.getEnrolments(); 
Iterator iter = enrolments.iterator(); 
System.out .println ("===== 获 取 -" + s.getName() 
+ "~ 的 选课 记录 =====") 7 
while(liter.hasNext ()) 
{ 
Enrolment e = (Enrolment)iter.next(); 
System.out.println(e.getCourse() .getName()); 
} 
} 
tx.commit () 7 
HibernateUtil.closeSession()7 
} 
} 


在 条 件 查询 中 ，Criteria 接口 代表 一 次 查询 ， 该 查询 本 身 不 具备 任何 的 数据 筛选 功能 ，Session 调 
用 createCriteria(Class clazz) 方 法 对 某 个 持久 化 类 创建 条 件 查询 实例 


不 下 
部 执行 该 程序 之 前 ， 应 该 先 将 codes\06\6.5\eriteria 路 径 下 的 datasql 脚本 导入 MySQL 数 : 


据 库 ， 这 样 保证 查询 的 数据 表 中 已 有 数据 。 | 


Criteria 对 象 并 不 具备 任何 数据 筛选 功能 , 但 程序 可 以 通过 向 Criteria 对 象 中 组 合 多 个 Criterion (每 
个 Criterion 对 象 代表 一 个 过 滤 条 件 ) 即 可 实现 数据 过 滤 了 。 

Criteria 包含 如 下 两 个 方法 。 

> ”Criteria setFirstResult(int firstResult)， 设 置 查询 返回 的 第 一 行 记录 。 

> ”Criteria setMaxResults(int maxResults)， 设 置 查询 返回 的 记录 数 。 

这 两 个 方法 与 Query 的 两 个 类 似 方法 的 功能 一 样 ， 都 用 于 完成 查询 分 页 。 

而 Criteria 还 包含 如 下 常用 方法 。 

> ”Criteria add(Criterion criterion): 增加 查询 条 件 。 

> ”Criteria addOrder(Order order): 增加 排序 规则 。 

> ”List list(): 返回 结果 集 。 

Criterion 接口 代表 一 个 查询 条 件 ， 该 查询 条 件 由 Restrictions 负责 产生 。Restrictions 是 专门 用 于 产 

生 查 询 条 件 的 工具 类 ， 它 的 方法 大 部 分 都 是 静态 方法 ， 常 有 的 方法 如 下 。 

> static Criterion allEq(Map propertyNameValues): 判断 指定 属性 (由 Map 参数 的 key 指定 ) 
和 指定 值 〈 由 Map 参数 的 value 指定 ) 是 否 完全 相等 。 

> static Criterion between(String propertyName, Object lo, Object hi): 判断 属性 值 在 某 个 值 范 
围 之 内 。 

> _static Criterion ilike(String propertyName, Object value): 判断 属性 值 匹配 某 个 字符 串 。 

> static Criterion ilike(String propertyName, String value, MatchMode matchMode): 判断 属性 
值 匹配 某 个 字符 串 ， 并 确定 匹配 模式 。 

> static Criterion in(String propertyName, Collection values): 判断 属性 值 在 某 个 集合 内 。 

> static Criterion in(String propertyName, Object values): 判断 属性 值 是 数组 元 素 的 其 中 之 一 。 
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static Criterion isEmpty(String propertyName): 判断 属性 值 是 否 为 空 。 

static Criterion isNotEmpty(String propertyName): 判断 属性 值 是 否 不 为 空 。 

static Criterion isNotNull(String propertyName): 判断 属性 值 是 否 为 空 。 

static Criterion isNull(String propertyName): 判断 属性 值 是 否 不 为 空 。 

static Criterion not(Criterion expression): 对 Criterion 求 否 。 

static Criterion sizeEq(String propertyName, int size)。 判 断 某 个 属性 的 元 素 个 数 是 否 与 size 

相等 。 

> ”static Criterion sqlRestriction(String sql): 直接 使 用 SQL 语句 作为 筛选 条 件 
static Criterion sqlRestriction(String sql, Object[] values, Typel] types): 直接 使 用 带 参数 占 
位 符 的 SQL 语句 作为 条 件 ， 并 指定 多 个 参数 值 。 

> static Criterion sqlRestriction(String sql, Object value, Type type): 直接 使 用 带 参数 占 位 符 
的 SQL 语句 作为 条 件 ， 并 指定 参数 值 。 

Order 实例 代表 一 个 排序 标准 ，Order 有 如 下 静态 方法 。 

> static Order asc(String propertyName): 根据 propertyName 属性 升序 排序 。 

> static Order desc(String propertyName): 根据 propertyName 属性 降序 排序 。 


>》6.5.1 关联 和 动态 关联 


如 果 需 要 使 用 关联 实体 的 属性 来 增加 查询 条 件 ， 则 应 该 对 属性 再 次 使 用 createCriteria 方法 。 正 如 
上 面 的 条 件 查 询 示 例 的 queryWithJoin() 方 法 看 到 的 ; 


List 1 = session,createCriteria(Student.class) 
// 此 处 增加 限制 条 件 必须 是 Student 已 经 存在 的 属性 
‘add( Restrictions.gt ("studentNumber” , 20050231L)) 
.createCriteria("enrolments") 
-add( Reatrictions.gt("senester" ,2)) 
list()» 
上 面 的 代码 表示 建立 Person 类 的 条 件 查询 , 第 一 个 查询 条 件 是 直接 过 滤 Person 的 属性 。 第 二 个 查 
询 条件 则 过 滤 Person 的 关联 实体 的 属性 ， 其 中 enrolments 是 Person 类 的 关联 实体 ， 而 semester 则 是 
Enrolment 类 的 属性 。 值 得 注意 的 是 ， 返 回 的 并 不 是 Enrolment 对 象 ， 而 是 Person 对 象 的 集合 。 
来 
关注 意 : 
使 用 关联 类 的 条 件 查询 ， 依 然 是 查询 原 有 持久 化 类 的 实例 ， 而 不 是 查询 被 关联 类 的 
实例 


vvvvyvyv 


为 了 达到 这 种 效果 ， 还 可 使 用 条 件 查询 支持 的 替换 形态 ， 即 上 面 的 查询 可 以 替换 成 如 下 形式 : 


List 1 = session.createCriteria(Student.class) 
-add( Restrictions.gt ("studentNumber" , 200502315)) 
-createAlias ("enrolments", "en") 
-add( Restrictions.gt("en.semester" , 2)) 
"list(); i 


createAlias() 方 法 并 不 创建 一 个 新 的 Criteria 实例 ， 它 只 是 给 关联 实体 (包括 集合 里 包含 的 关联 实 
体 ) 起 一 个 别名 ， 让 后 面 的 过 滤 条 件 可 根据 该 关联 实体 进行 筛选 。 

在 默认 情况 下 ， 条 件 查询 将 根据 映射 文件 指定 的 延迟 加 载 策略 来 加 载 关 联 实体 ， 如 果 希 望 在 条 件 
查询 中 改变 延迟 加 载 策略 〈 就 像 在 HQL 查询 中 使 用 fetch 关键 字 一 样 )， 就 可 通过 Creteria 的 
setFetchMode() 方 法 来 实现 ， 该 方法 接受 一 个 FetchMode 参数 。 

FetchMode 里 有 如 下 几 个 常量 。 

> ”DEFAULT: 使 用 配置 文件 指定 的 延迟 加 载 策略 处 理 。 
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> ”JOIN: 使 用 外 连接 、 预 初始 化 所 有 关联 实体 。 

> ”SELECT: 启用 延迟 加 载 ， 系 统 将 使 用 单独 的 select 语句 来 初始 化 关联 实体 。 只 有 当真 正 访 
问 关联 实体 的 时 候 ， 才 会 执行 第 二 条 select 语句 。 

如 果 我 们 想 让 程序 在 初始 化 Student 对 象 时 ， 也 可 以 初始 化 Student 关联 的 Enrolment 实体 ， 则 应 

该 使 用 如 下 代码 片段 : 

List 1 = session.createCriteria (Student .class) 
// 此 处 增加 限制 条 件 必须 是 Student 已 经 存在 的 属性 
.add( Restrictions.gt ("studentNumber”" , 20050231L)) 


.setFetchMode ("enrolments", FetchMode.JOIN) 
list(); 


以 上 程序 的 粗 体 字 代码 将 会 预 初始 化 Student 关联 的 enrolments 集合 。 关 于 使 用 setFetchMode(O 改 变 
延迟 加 载 策略 的 示例 , 请 参看 codes\06\6.S\eriteria\src\lee\CriteriaTestjava 文件 的 queryWithFecth( 方 法 。 


》》>6.5.2 投影 、 聚 合 和 分 组 


投影 运算 实际 上 就 是 一 种 基于 列 的 运算 , 通常 用 于 投影 到 指定 列 (也 就 是 过 滤 其 他 列 ， 类似 select 
子 旬 的 作用 )， 还 可 以 完成 SQL 语句 中 常用 的 分 组 、 组 筛选 等 功能 。 

Hibernate 的 条 件 过 滤 中 使 用 Projection 代表 投影 运算 ，Projection 是 一 个 接口 ， 而 Projections 作为 
Projection 的 工厂 ， 负 责 生成 Projection 对 象 。 

- 旦 产生 了 Projection 对 象 之 后 ， 就 可 通过 Criteria 提供 的 setProjection(Projection projection) 方 法 

来 进行 投影 运算 。 从 该 方法 上 看 ， 每 个 Criteria 只 能 接受 一 个 投影 运算 ， 似 乎 无 法 进行 多 个 投影 运算 ， 
但 实际 上 Hibernate 又 提供 了 一 个 ProjectionList 类 ， 该 类 是 Projection 的 子 类 ， 并 可 以 包含 多 个 投影 运 
算 ， 通 过 这 种 方式 即 完成 多 个 投影 运算 。 

因此 ， 一 个 条 件 查询 的 投影 运算 通常 有 如 下 程序 结构 : 


List ec 


= session.createCriteria (Cat.class) 
rojection( Projections.projectionList() 
( Projections ,rowCount() ) 

-add( Projections.avg("weight") ) 

-add( Projections.max("weight") ) 

.add( Projections.min("weight") ) 

-add( Projections.groupProperty ("color") )) 
.addorder( Order.asc{"color") ) 

.1ist() 


从 上 面 的 粗 体 字 代码 中 可 以 看 出 , 所 谓 投影 运算 实际 上 和 SQL 语句 里 的 聚集 函数 、 分 组 语句 (group 
by 子 句 ) 有 类 似 的 功能 。 使 用 条 件 查询 的 投影 运算 时 ， 不 能 使 用 显 式 的 分 组 子 句 ， 但 某 些 投影 类 型 的 实 
质 就 是 分 组 投影 ,这 些 投影 运算 将 出 现在 SQL 的 group by 子 句 中 一 一 如 上 的 groupProperty("color") 投 影 。 
在 Projections 工具 类 中 提供 了 如 下 几 个 静态 方法 。 
> “AggregateProjection avg(String propertyName): 计算 特定 属性 的 平均 值 。 类 似 于 avg 函数 。 
> ”CountProjection count(String propertyName): 统计 查询 结果 在 某 列 上 的 记录 条 数 。 类 似 于 
count(column) 函 数 。 
> ”CountProjection countDistinct(String propertyName): 统计 查询 结果 在 某 列 上 不 重复 的 记录 
条 数 。 类 似 于 count(distinct column) 函 数 。 
> PropertyProjection groupProperty(String propertyName): 将 查询 结果 按 某 列 上 的 值 进 行 分 
组 。 类似 于 添加 group by 子 句 。 
> AggregateProjection max(String propertyName): 统计 查询 结果 在 某 列 上 的 最 大 值 。 类 似 于 
max 函数 。 
> AggregateProjection min(String propertyName): 统计 查询 结果 在 某 列 上 的 最 小 值 。 类 似 于 
min 函数 。 
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> ”Projection rowCount(): 统计 查询 结果 的 记录 条 数 。 类 似 于 count(*) 的 功能 。 
> ” AggregateProjection sum(String propertyName): 统计 查询 结果 在 某 列 上 的 总 和 。 类 似 于 
sum 函数 。 
下 面 的 程序 示范 了 如 何 通过 投影 运算 来 进行 分 组 ， 使 用 聚集 函数 功能 。 
程序 清单 : codes\06\6.5\projection\src\lee\ProjectionTestjava 
public class ProjectionTest 
public static void main(String[] args) 
~ ProjectionTest pt = new ProjectionTest(); 
pt-query(); 


HibernateUtil.sessionFactory.close(); 
} 


Private void query() 


// 打 开 session 和 事务 

Session session = BibernateUtil.currentSession()7 

Transaction tx = session.beginTransaction(); 

// 使 用 createCriteria 开始 条 件 查询 

List 1 = session.createCriteria(Enrolment.class) 
createAlias ("student", "s") 


-add (Projections .rowCount ()) 
// 统 计 选择 该 课程 里 最 大 的 学 生 姓名 
-add (Projections.max("s.name")) 
// 按 course 进行 分 组 
.add (Projections.groupProperty ("course")) 
) .Tist()7 
for (Iterator it = l,iterator() ; it.hasNext{() ;) 
{ 

Object{] objs = (Object[])it.next(); 

Course c = (Course)objs[2]; 

System:out .println ("=s====<" + c.getName() 

+ "> 课程 的 选课 统计 =====”) 7 
System.out.printin ("选课 入 数 :”+ objs[0]); 
System.out .println ("选课 的 姓名 最 大 的 学 生 为 : ”+ objs[1]); 

} 


tx.commit (); 
HibernateUtil.closeSession(); 


上 

} 

以 上 程序 的 粗 体 字 代码 为 条 件 查询 增加 了 分 组 功能 ， 并 通过 Projections 统计 了 每 组 的 记录 条 数 ， 
统计 Student 名 字 最 大 的 值 。 

从 上 面 的 程序 可 以 看 出 ， 对 于 增加 了 投影 运算 后 的 条 件 查询 ， 查 询 返回 的 结果 是 数组 ， 数 组 的 前 
N 个 元 素 依次 是 投影 运算 的 结果 ， 最 后 一 个 数组 元 素 才 是 条 件 查询 得 到 的 实体 。 由 此 可 见 ， 投 影 运 算 
的 实质 和 group by 子 句 、 聚 集 函数 的 功能 大 致 一 致 

除 此 之 外 ， 如 果 我 们 希望 对 分 组 〈 投 影 ) 后 属性 进行 排序 ， 那 就 需要 为 投影 运算 指定 一 个 别名 。 
为 投影 运算 指定 别名 有 如 下 三 种 方法 。 

> ”使 用 Projections 的 alias() 方 法 为 指定 投影 指定 别名 。 

Projections 的 alias0 方 法 为 指定 Projection 指定 别名 ， 并 返回 原 Projection 对 象 。 一 旦 为 指定 
Projection 指定 了 别名 ， 则 程序 就 可 以 根据 该 Projection 别名 来 进行 其 他 额外 操作 了 ， 比 如 排序 。 条 件 
查询 示例 如 下 : 


List 1 = session.createCriteria (Enrolment.class) 
setProjection (Projections.projectionList () 
// 按 course 进行 分 组 
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.add (Projections.groupProperty{"course")) 
// 统 计 记录 条 数 ， 并 为 统计 结果 指定 别名 c 

.add (Projections.alias (Projections. rowCount (), "c"))) 
-addorder (Order.asc("c")) 

.list(); 


以 上 程序 的 粗 体 字 代码 示范 了 为 Projection 指定 别名 的 方法 。 
> ”使 用 SimpleProjection 的 as() 方 法 为 自身 指定 别名 。 
如 果 条 件 查询 所 使 用 的 投影 运算 是 SimpleProjection 及 其 子 类 ， 则 可 直接 使 用 该 投影 对 象 的 as() 


方法 来 为 自身 指定 别名 。 条 件 查询 片段 如 下 : 
List 1 = session.createCriteria(Enrolment.class) 

.setProjection (Projections.projectionList () 
// 按 course 进行 分 组 
.add (Projections.groupProperty ("course") .as ("c")) 
// 统 计 记 录 条 数 ， 并 为 统计 结果 指定 别名 c 
.add(Projections.rowCount())) 
.addOrder (Order.asc("c")) 
list(); 


> ”使 用 ProjectionList 的 add() 方 法 添加 投影 时 指定 别名 。 
ProjectionList 的 add0 方 法 有 两 个 重 载 形式 ， 一 个 是 直接 添加 一 个 投影 ， 另 一 个 可 以 在 添加 投影 时 
指定 别名 。 条 件 查询 片段 如 下 : 
List 1 = session.createCriteria(Enrolment.class) 
.setProjection (Projections.projectionList () 
// 按 course 进行 分 组 ,指定 别名 为 c 
,add (Projections.groupProperty ("course") , "c") 
// 统 计 每 组 记录 的 条 数 , 指定 别名 为 rc 
:add (Projections. rowCount () , "re")) 
“addOrder (Order.asc ("rc")) 
‘list(); 
除 此 之 外 ，Hibernate 还 提供 了 Property 执行 投影 运算 ，Property 投影 的 作用 类 似 于 SQL 语句 中 的 
select， 条 件 查 询 的 结果 只 有 被 Property 投影 的 列 才 会 被 选 出 。 看 如 下 的 条 件 查 询 : 
// 使 用 Property 只 选 出 指定 列 
List 1 = session.createCriteria(Student.class) 


setProjection (Property .forName ("name")) 
list(); 
上 面 的 条 件 查 询 执行 的 结果 不 再 是 Student 对 象 集合 ， 而 是 name 属性 所 组 成 的 集合 。 
使 用 Property 还 可 根据 指定 列 来 过 滤 记 录 ， 看 如 下 的 条 件 查询 : 
// 使 用 Property 选 出 指定 列 ， 并 根据 指定 列 过 滤 数 据 
List 1 = session.createCriteria(Enrolment ,class) 
-createAlias ("student", "s") 
.setProjection (Projections.projectionList() 
.add (Property. forName ("course")) 
-add (Property. forName ("s.name"))) 
sh 
-list(); 


上 面 的 条 件 查询 稍微 有 点 复杂 ， 条 件 查 询 中 粗 体 字 代码 用 于 创建 一 个 ProjectionList 对 象 ， 其 中 两 
个 add 方法 都 属于 ProjectionListd 对 象 ,表明 选 出 Enrolment 的 couse 属性 、Enrolment 的 student 的 name 
属性 。 四 号 粗 体 字 代码 的 Property 用 于 根据 指定 列 过 滤 属 性 ， 即 只 选 出 Enrolment 的 student 的 name 
属性 等 于 “和 孙悟空 ”的 记录 。 执 行 上 面 的 条 件 查询 ， 将 生成 如 下 的 SQL 语句 : 


select 
this_.course_code as y0_, 
sl_.name as yl_ 

from 
enrolment_inf this_ 

inner join 
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student_inf sl_ 
on this_.student_id=sl_.student_id 


where 
sl_.name=? 


>>6.5.3 离线 查询 和 于 查询 


条 件 查询 的 离线 查询 由 DetachedCriteria 来 代表 ，DetachedCriteria 类 允许 在 一 个 Session 范围 之 外 
创建 一 个 查询 ， 并 且 可 以 使 用 任意 Session 来 执行 它 。 
使 用 DetachedCriteria 来 执行 离线 查询 ， 通 常 使 用 如 下 方法 获得 一 个 离线 查询 : 


// 创 建 指定 持久 化 类 的 离线 查询 
DetachedCriteria. forClass (Class po) 


除 此 之 外 ，DetachedCriteria 还 可 代表 子 查 询 ， 当 我 们 把 DetachedCriteria 传 入 Criteria 中 作为 查询 
条 件 时 , DetachedCriteria 就 变 成 了 子 查询 . 条 件 实例 包含 子 查询 通过 Subqueries 或 者 Property 来 获得 。 
如 下 程序 示范 了 使 用 DetachedCriteria 进行 离线 查询 和 子 查 询 的 效果 。 
程序 清单 : codes\06\6.5\DetachedCriteria\src\lee\DetachedCriteriaTest.java 
public class DetachedCriteriaTest 
public static void main(String[] args) 


DetachedCriteriaTest pt = new DetachedCriteriaTest()7 
pt,datached( 
pt. subQuery (); 
HibernateUtil.sessionFactory.close(); 


上 


// 执 行 离线 查询 
private void datached() 


{ 

// 定 义 一 个 离线 查询 

Detachedcriteria query = DetachedCriteria 
.forclass (Student .class) 
-setProjection (Property. forName ("name")) ; 

// 打 开 Session 和 事务 

Session session = HibernateUtil.currentSession(); 

Transaction tx = session.beginTransaction(); 

// 执 行 离线 查询 

List 1 = query.getExecutableCriteria(session) 
-list(); 

7/ 遍历 查询 的 结果 

for (Tterator it = 1.iterator();it.hasNext() ; ) 

{ 


System.out .println(it.next ()); 
} 
tx.commit (); 
HibernateUtil.closesession(); 


} 
// 执 行 子 查询 
private void subouery() 


{ 

// 定 义 一 个 离线 查询 

DetachedCriteria = Detachedcriteria 
.forClass (Student .class) 
-setProjection (Property. forName ("name")) ; 

// 打 开 Session 和 事务 

Session session = HibernateUtil.currentsession(); 

Transaction tx = session.beginTransaction(); 

// 执 行 子 查询 

List 1 = session.createCriteria(Student.class) 
-add( Property. forNane ("name") .in(subQuery)) 
-list(); 
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// 遍 历 查 询 的 结果 
for (Iterator it = 1.iterator();it.hasNext() ; ) 


{ 
System.out.println(it.next ()); 
} 
tx.commit () 7 
HibernateUtil.closeSession(); 
} 
} 


从 上 面 的 程序 来 看 ， 当 创建 一 个 DetachedCriteria 对 象 之 后 ， 该 对 象 到 底 被 作为 离线 查询 使 用 ， 还 
是 作为 子 查询 使 用 ， 与 DetachedCriteria 对 象 无 关 。 

如 果 程 序 使 用 Session 的 getExecutableCriteria() 方 法 来 执行 DetachedCriteria 对 象 ， 则 它 被 当成 离 
线 查询 使 用 ; 如 果 程序 使 用 Property 的 系列 方法 来 操作 DetachedCriteria 对 象 , 则 它 被 当成 子 查询 使 用 。 

Property 类 提供 了 eq0、eqAll0、geO、geAll0、gt0、gtAll0、in 等 系列 方法 ， 这 些 方法 与 SQL 
子 查询 中 的 运算 符 一 一 对 应 。 除 此 之 外 ， 还 可 使 用 Subqueries 操作 DetachedCriteria 对 象 ， 此 时 
DetachedCriteria 也 被 当成 子 查询 使 用 。 关 于 Property 的 方法 、Subqueries 的 用 法 ， 请 参考 Hibernate 相 
关 ApPI 文档 。 


6.6 SQL 查询 


Hibernate 还 支持 使 用 原生 SQL 查询 ， 使 用 原生 SQL 查询 可 以 利用 某 些 数据 库 的 特性 ， 或 者 需要 
将 原 有 的 JDBC 应 用 迁移 到 Hibernate 应 用 上 ， 也 可 能 需要 使 用 原生 SQL 查询 。 类似 于 HQL 查询 ， 原 
生 SQL 查询 也 支持 将 SQL 语句 放 在 配置 文件 中 配置 ， 从 而 提高 程序 的 解 耦 。 命 名 SQL 查询 还 可 以 用 
于 调用 存储 过 程 。 

如 果 是 一 个 新 的 应 用 ， 通 常 不 要 使 用 SQL 查询 。 

SQL 查询 是 通过 SQLQuery 接口 来 表示 的 。SQLQuery 接口 是 Query 接口 的 子 接口 ， 因 此 完全 可 
以 调用 Query 接口 的 方法 ， 如 下 所 示 。 

> ”setFirstResult()， 设置 返回 的 结果 集 的 起 始点 。 

> ”setMaxResults(): 设置 查询 获取 的 最 大 记录 数 。 

> list(): 返回 查询 到 的 结果 集 。 

但 SQLQuery 比 Query 多 了 如 下 两 个 重 载 的 方法 。 

> ”addEntity(): 将 查询 到 的 记录 与 特定 的 实体 关联 。 

> ”addScalar(): 将 查询 的 记录 关联 成 标量 值 。 

执行 SQL 查询 的 步骤 如 下 : 

人 获取 Hibemate Session 对 象 。 

人 @ 编写 SQL 语句。 

@ 以 SQL 语句 作为 参数 ， 调 用 Session 的 createSQLQuery 方法 创建 查询 对 象 。 

人 @ 调用 SQLQuery 对 象 的 addScalar0 或 addEntity0 方 法 将 选 出 的 结果 与 标量 值 或 实体 进行 关联 ， 
分 别 用 于 进行 标量 查询 或 实体 查询 。 

人 如 果 SQL 语句 包含 参数 ， 则 调用 Query 的 setXxx 方法 为 参数 赋值 。 

@ 调用 Query 的 list 方法 返回 查询 的 结果 集 。 


》>>6.6.1 标量 查询 


最 基本 的 SQL 查询 就 是 获得 一 个 标量 〈 数 值 ) 的 列表 。 例 如 如 下 的 SQL 语句 : 


// 下 面 两 条 SQL 语句 用 于 查询 标量 列表 
session.createSsQLQuery ("select * from student_inf").1list{); 
session.createsQLOuery ("select * from course_inf").list(); 
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在 默认 情况 下 ， 上 面 的 查询 语句 将 返回 由 Object 数组 (Object[]) 组 成 的 List， 数 组 每 个 元 素 都 
是 student 表 或 course 表 的 列 值 ，Hibernate 会 通过 ResultSetMetadata 来 判定 所 返回 数据 列 的 实际 顺 


序 和 类型 。 


生 - 流利 ， 间 一 
如 果 select 后 面具 有 一 个 字段， 那么 返回 的 List 集合 元 素 就 不 是 孝 组 ， 而 只 是 单个 eh 


的 变量 值 . 


但 我 们 知道 ， 在 JDBC 中 使 用 过 多 的 ResultSetMetadata 会 降低 程序 性 能 ， 所 以 我 们 可 以 为 这 些 数 
据 列 指 定 更 明确 的 返回 值 类 型 。 明 确 指定 返回 值 类 型 通过 addScalar() 方 法 来 指定 。 例 如 如 下 语句 ， 


session.createsQLQuery("select * from student_inf") 
.addSscalar ("name" ，StandardBasicTypes.STRING) 
-list(); 


上 面 查询 指定 了 SQL 查询 的 如 下 三 个 信息 : 

> SQL 字符 串 。 

> ”查询 返回 的 字段 列表 

> ”查询 返回 的 各 字段 类 型 。 

此 时 Hibernate 不 再 需要 使 用 ResultSetMetadata 来 获取 列 信息 , 而 是 直接 从 ResultSet 中 取出 name 
列 的 值 , 并 把 name 列 的 数据 类 型 当成 字符 串 处 理 。 因 此 即使 使 用 了 “*” 作 为 查询 的 字段 列表 (ResultSet 
返回 多 个 字段 )， 但 Hibernate 查询 的 结果 也 只 是 name 字段 所 组 成 的 列表 。 

如 果 和 希望 仅仅 让 Hibernate 选 出 某 个 字段 的 值 , 但 又 不 想 明确 地 指出 该 字段 的 数据 类 型 ， 则 可 使 用 
columnAlias) 方 法 , 这 个 方法 只 指定 查询 需要 返回 该 字段 , 并 不 指定 该 字段 的 数据 类 型 。 


条 注 刘 : 放 
通常 我 们 还 是 应 该 同时 指出 查询 返回 的 所 有 字段 列表 和 字段 类 型 ， 这 样 可 保证 系统 | 

有 最 好 的 性 能 。 除非 在 一 些 不 得 已 的 情况 下 ， 例 如 程序 无 法 知道 所 查询 数据 列 的 数据 类 | 

型 ， 此 时 才 要 考虑 使 用 addScalar(String columnAlias) 方 法 ， 否 则 都 应 该 使 用 addScalar 

(String columnAlias, Type type) 方 法 . 订 


程序 清单 : codes\06\6.6\native_sql\src\lee\NativeSQLTest.java 


// 执 行 标量 查询 
public void scalarQuery() 


{ 
// 打 开 Session 和 事务 
Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction(); 
String sqlString = "select stu.* from student_inf as stu"; 
List 1 = session,createsQLQuery (sqlstring) 
// 指 定 查 询 name 和 student_id 两 个 数据 列 
pe a ER 


for (Iterator it = 1,.iterator(); it.hasNext() ; ) 


{ 
// 每 个 集合 元 素 都 是 一 个 数组 ， 数 组 元 素 是 name、student_id 两 列 值 
Object{] row = (Object[])it.next(); 
System.out.println(row{0] + "\t" + row[1]); 

} 

tx.commit (); 

HibernateUtil.closeSession(); 
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以 上 程序 的 粗 体 字 代码 给 出 了 SQL 查询 的 关键 代码 , 程序 执行 的 结果 是 选 出 了 所 有 符合 要 求 的 记 
录 行 ， be name、student_id 两 个 数据 列 的 值 。 


本 -注重 ， * 
在 原生 SQL 查询 里 ， 程 序 指定 的 原生 SQL 语句 是 标准 的 SQL 语 自 ， 因 此 SQL 语 
各 中 使 用 的 就 是 数据 才 、 孝 据 列 竺 对象， 而 不 是 持久 化 类 、 必 性 等 


从 上 面 执行 标量 查询 的 结果 来 看 ， 标量 查询 中 addScalar0 方 法 有 两 个 作用 
> ”指定 查询 结果 包含 哪些 数据 列 一 一 没有 被 addScalar 选 出 的 列 将 不 会 包含 在 查询 结果 中 。 
> ”指定 查询 结果 中 数据 列 的 数据 类 型 。 


>》>6.6.2 实体 查询 


前 面 的 标量 值 查 询 只 是 返回 一 些 标量 的 结果 集 , 这 种 查询 方式 与 使 用 JDBC 查询 的 效果 基本 类 似 。 
查询 返回 多 个 记录 行 ， 每 行 记录 对 应 一 个 列表 元 素 ， 每 个 列表 元 素 是 一 个 数组 ， 每 个 数组 元 素 对 应 当 
前 行 、 当 前 列 的 值 。 

如 果 查 询 返 回 了 某 个 数据 表 的 全 部 数据 列 ( 记 住 : 是 选 出 全 部 数据 列 )， 且 该 数据 表 有 对 应 的 持久 
化 类 映射 ， 我 们 就 可 把 查询 结果 转换 成 实体 查询 。 将 查询 结果 转换 成 实体 ， 可 以 使 用 SQLQuery 提供 
的 多 个 重 载 的 addEntity() 方 法 。 看 下 面 的 SQL 查询 示例 。 

程序 清单 :codes\06\6.6\native_sql\src\lee\NativeSQLTest.java 

// 执 行 实体 SQL 查询 

public void entityQuery() 


{ 
/1/ 打 开 Session 和 事务 
Session session = HibernateUtil.currentSession(); 


Transaction tx = session.beginTransaction(); 
String sqlString = "select * from enrolment_inf where year=:year";” 
List 1 = session.createSsQLQuery (sqlstring) 
7/ 指定 将 查询 的 记录 行 转换 成 Student 实体 
-addEntity (Enrolment .class) 
// 为 SQL 字符 串 的 参数 设置 值 
-setInteger ("year" , 2005) 
“1ist(); 
for (Iterator it = 1.iterator(); it.hasNext() ; ) 


{ 
// 每 个 集合 元 素 都 是 一 个 Enrolment 对 象 
Enrolment e = (Enrolment)it.next(); 
System.out .println(e.getStudent () .getName() + "\t” + e.getCourse() .getName()); 
} 》 
tx commit() 
HibernateUtil.closeSession(); 
} 


因为 上 面 的 程序 中 的 SQL 语句 选 出 了 enrolment_inf 表 中 的 全 部 数据 列 ， 且 enrolment_inf 表 被 映 
射 到 了 Enrolment 持久 化 类 ， 所 以 可 以 将 查询 结果 转换 成 Enrolment 实体 组 成 的 列表 。 

使 用 原生 SQL 查询 必须 注意 的 是 , 程序 必须 选 出 所 有 数据 列 才 可 被 转换 成 持久 化 实体 。 假 设 实体 
在 映射 时 有 一 个 <many-to-one. 户 的 关联 指向 另外 一 个 实体 ， 则 SQL 查询 中 必须 返回 该 
<many-to-one.… 信 映射 的 外 键 列 ， 否 则 将 导致 抽出 “column not found” 异 常 。 最 简单 的 做 法 是 ,在 SQL 
字符 串 中 使 用 星 号 (*) 来 表示 返回 所 有 列 。 

从 上 面 的 程序 中 可 以 看 出 ， 在 原生 SQL 语句 中 一 样 支持 使 用 参数 ， 这 些 参数 既 可 使 用 问号 参数 
(?)， 也 可 使 用 名 字 参 数 ， 如 上 面 程序 中 的 SQL 语句 所 示 。 

不 仅 如 此 ， 如 果 我 们 在 SQL 语句 中 显 式 使 用 了 多 表 连 接 ， 则 SQL 语句 可 以 选 出 多 个 数据 表 的 数 
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据 。Hibernate 还 支持 将 查询 结果 转换 成 多 个 实体 。 如 果 要 将 查询 结果 转换 成 多 个 实体 ， 则 SQL 字符 
串 中 应 为 不 同 数据 表 指定 不 同 别名 ， 并 调用 addEntity(String alias, Class entityClass) 方 法 将 不 同 数据 表 
转换 成 不 同 实体 。 看 如 下 程序 片段 。 

程序 清单 : codes\06\6.6\native_sql\src\lee\NativeSQLTestjava 


// 执 行 返回 多 个 实体 的 SQL 查询 ， 
public void multiEntityQuery() 
{ 
// 打 开 Session 和 事务 
Session session = HibernateUtil.currentSession()7 
Transaction tx = session.beginTransaction(); 
String sqlString = "select s.*,@.*,c.* " 
+ "from student_inf s,enrolment_inf @,course_inf c " 
+ where s.student_id = @.student_id " 
+ "and e.course_code = c.course_code"; 
List 1 = session.createSQLQuery(sqlString) 
// 指 定 将 查询 的 记录 行 转换 成 Student 实体 
-addEntity("s", Student.class) 
.addEntity("e", Enrolment.class) 
.addEntity("c", Course.class) 
‘list(); 
// 提 交 事务 ， 关 闭 Session 
tx.commit (); - 
HibernateUtil.closesession(); 
// 因 为 数据 已 经 全 部 被 选 出 ， 故 程序 可 以 人 遍历 列表 中 的 数据 
for (Iterator it = 1.iterator(); it.hasNext() ; ) 
{ 
// 每 个 集合 元 素 都 是 Scudent、Enrolment 
// 和 Course 所 组 成 的 数组 
object[] objs = (Object[])it.next(); 
Student s = (Student)objs{0]; 
Enrolment e = (Enrolment)objs[1]7 
Course c = (Course)objs[2]; 
System.out.printin(s.getName () + "\t" 
+ e.getYear() + "\t" + e.getSemester() 
+ "\t" + c.getName()); 
) 
} 


上 面 程序 的 SQL 语句 一 次 返回 了 student_inf、course_inf、enrolment_inf 表 中 的 全 部 数据 ， 所 以 程 
序 可 以 将 查询 的 结果 转换 成 三 个 实体 , 执行 上 面 的 SQL 查询 后 列表 里 的 元 素 就 是 由 Student、 Enrolment 
和 Course 实体 组 成 的 数组 。 
不 仅 如 此 ,， Hibernate 还 可 将 查询 的 结果 转换 成 非 持久 化 实体 ( 即 普通 JavaBean), 只 要 该 JavaBean 
为 这 些 数据 列 提供 了 对 应 的 setter 和 getter 方法 即 可 。 
Query 接口 提供 了 一 个 setResultTransformer() 方 法 ， 该 方法 可 接受 一 个 Transformers 对 象 ， 通 过 使 
用 该 对 象 即 可 把 查询 到 的 结果 集 转换 成 JavaBean 集 。 如 下 的 程序 片段 示范 了 这 种 用 法 。 
程序 清单 :codes\06\6.6mative_sqlvsrc\lee\NativeSQLTestjava 
// 执 行 返 回 普通 JavaBean 的 SQL 查询 
public void beanQuery() 


{ 

// 打 开 Session 和 事务 

Session session = HibernateUtil.currentSession(); 

Transaction tx = session.beginTransaction(); 

String sqlString = "select s.name stuName, c.name courseName " 
+ "from student_inf s,enrolment inf @,course inf o " 
+ "where s.student_ id = @.student_ id " 
+ "and @.course_code = c.course_code "; 

List 1 = session.createsQLOuery (sqlString) 
// 指 定 将 查询 的 记录 行 转换 成 StudentCourse 对 象 
.setResultTransformer (Transformers 

-aliasToBean (StudentCourse.class)) 
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:aist()7 
// 提 交 事 务 ， 关 闭 Session 
tx.commit (); 
HibernateUtil.closeSession(); 
// 因 为 数据 已 经 全 部 被 选 出 ， 故 程序 可 以 遍历 列表 中 的 数据 
for (Iterator it = 1.iterator(); it.hasNext() ; ) 
{ 


// 每 个 集合 元 素 都 是 StudentCourse 对 象 
StudentCourse sc = (StudentCourse)it.next();} 
System.out.println(sc.getStuName() + "\t" 
+ sc.getCourseName () ) 
} 
于 
上 面 的 程序 选择 了 student_inf 表 的 name 列 ，course_inf 表 的 name 列 ， 并 为 它们 分 别 指定 别名 为 
stuName 和 courseName 一 一 这 要 求 JavaBean 类 (StudentCourse) 也 提供 这 两 个 属性 ， 即 为 这 两 个 属性 
提供 对 应 的 setter 和 getter 方法 。 下 面 是 StudentCourse 类 的 代码 片段 。 
程序 清单 :06\6.6\native_sql\src\org\crazyit\app\vo\StudentCourse.java 
public class StudentCourse 
{ 
Private String stuName; 
Private String courseName; 
7 开机 者 呈 于 站 个 括 伯 的 setter 和 getter 方法 
} 


执行 面 的 程序 ， 查 询 结果 将 是 StudentCourse 对 象 组 成 的 集合 


rm 往生 ， 
通过 使 用 Hibernate 的 该 功能 


| 以 非常 方便 地 将 SQL 查询 的 结果 转换 成 VO 对 象 ， 
| 而 且 不 需要 任何 持久 化 类 、 任 何 映射 文件 。 还 有 一 点 需要 指出 : 上 面 的 程序 如 果 使 用 
| MySQLJDBC 驱动 5.1.7 版 、5.1.13 版 都 会 引发 一 个 很 奇怪 的 异常 一 一 这 个 异常 并 不 是 要 


Hibernate 本 身 导 致 的 。 如 果 我 们 换 为 使 用 MySQL JDBC 驱动 3.1.10 版 一 切 正 常 。 


>》6.6.3 ”处理 关联 和 继承 


只 要 原生 SQL 选 出 了 足够 的 数据 列 ， 则 程序 除了 可 以 将 指定 数据 列 转换 成 持久 化 实体 之 外 , 还 可 
以 将 实体 的 关联 实体 (通常 以 属性 的 形式 存在 ) 转换 成 查询 结果 。 将 关联 实体 转换 成 查询 结果 的 方法 
是 SQLQuery addJoin(String alias, String path)， 该 方法 第 一 个 参数 是 转换 后 的 实体 名 ， 第 二 个 参数 是 待 
转换 的 实体 属性 。 
下 面 的 程序 示范 了 原生 SQL 查询 是 如 何 处 理 这 种 转换 的 。 
程序 清单 :codes\06\6.6\native_sql\src\lee\NativeSQLTestjava 


// 使 用 关联 的 原生 SQL 查询 
public void joinQuery() 
{ 


// 打 开 session 和 事务 
Session session = HibernateUtil.currentSession(); 
Transaction tx = session.beginTransaction(); 
String sqlString = "select s.* , @.* from student_inf s , " 
+ "enrolment_inf © where s.student_id=e.student_id"; 
List 1 = session.createsQLOuery(sqlstring) 
-addEntity("s", Student.class) 
-addJjoin("e" , "s.enrolments") 
-1ist(); 
// 提 交 事务 ， 关 闭 Session 
tx.commit (); 
HibernateUtil.closeSession(); 
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// 因 为 数据 已 经 全 部 被 选 出 ， 故 程序 可 以 追 历 列表 中 的 数据 
for (Iterator it = 1.iterator(); it.hasNext{() ; ) 


{ 
7/ 每 个 集合 元 素 都 是 Student 、Enrolment 组 成 的 数组 
Object[] objs = (Object[])it.next(); 
Student s = (student)objs[0]; 
Enrolment e = (Enrolment)objs[1]; 
System.out.println(s.getName() + "\t" + e.getYear()); 
} 


} 
正如 上 面 的 程序 中 可 看 到 的 ， 程 序 将 s.enrolments 属性 转换 成 别名 为 e 的 实体 ， 也 就 是 说 ， 程 序 
执行 的 结果 是 Student、Enrolment 对 象 数组 的 列表 。 


如 果 使 用 原生 SQL 查询 的 结果 实体 是 继承 树 中 的 一 部 分 ， 则 查询 的 SQL 字符 事 
须 包含 基 类 和 所 有 于 类 的 全 部 属性 . 可 


> 6.6.4 命名 SQL 查询 


可 以 将 SQL 语句 不 放 在 程序 中 ， 而 是 放 在 配置 文件 中 ， 这 种 方式 以 松 耦 合 的 方式 来 配置 SQL 语 
句 ， 从 而 可 以 更 好 地 提高 程序 解 看 。 
Hibernate 使 用 <sql-query.. 人 > 元 素来 配置 命名 SQL 查询 ,配置 <sql-query.…/> 元 素 有 一 个 必 填 的 name 
属性 ， 该 属性 用 于 指定 该 命名 SQL 查询 的 名 称 。 
使 用 <sql-query../> 元 素 定义 命名 查询 时 ， 通 常 可 以 包含 一 个 或 多 个 的 如 下 子 元 素 ; 
> <return.…/>: 将 查询 结果 转换 成 持久 化 实体 。 
> ”<return-join.,./>: 预 加 载 持久 化 实体 的 关联 实体 。 
> ”<return-scalar..…/>: 将 查询 的 数据 列 转换 成 标量 值 。 
在 使 用 命名 SQL 查询 时 ， 不 需要 调用 addEntity0、addScalar0) 等 方法 ， 因 为 在 配置 命名 SQL 查询 
时 ， 已 经 指定 了 查询 返回 的 结果 信息 。 
如 下 代码 配置 了 一 个 SQL 查询 片段 。 
程序 清单 :codes\06\6.6\named_sql\src\org\crazyit\app\domain\Student.hbm.xml 
<!-- 指定 SQL 查询 的 名 称 为 queryTest --> 
<sql-query name="queryTest"> 
<!1-- 将 s 别名 转换 成 Student 实体 --> 
<return alias="s" class="Student"/> 


<!-- 将 e 别名 转换 成 Enrolment 实体 --> 

<return alias="e" class="Enrolment"/> 

<!-- 预 初始 化 e 的 course 属性 (关联 实体 ) 一 -> 
<return-join alias="c" property="e.course"/> 
<!-- 指定 将 student 表 的 name 列 作为 标量 值 返回 --> 
<return-scalar column="s.name" type="string"/> 
Select Ss.*,e@.*,c.* 

from student_inf s,enrolment_inf e,course inf ¢ 
where s.student_id = e.student_id 

and e.course_code = c.course_code 

and 


使 用 Session 的 getNamedQuery 即 可 获取 指定 命名 SQL 查询 , 下 面 是 使 用 该 命名 SQL 查询 的 示例 
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代码 。 
程序 清单 : codes\06\6.6\named_sql\src\lee\NamedSQLTest.Javaorg\crazyitapp\domain\Student.hbm.xml 


// 执 行 命名 SQL 查询 
private void query() 


{ 
// 打 开 Session 和 事务 
Session session = HibernateUtil.currentSession()7 
Transaction tx = session.beginTransaction(); 
// 调 用 命名 查询 ， 直 接 返 回 结果 
List 1 = session.getNamedQuery("queryTest") 
setInteger ("targetYear" , 2005) 
,list(); 
tx. commit (); 
HibernateUtil.closesession(); 
// 遍 历 结 果 集 
for(Iterator it = 1.iterator(); ic.hasNext() ;) 
{ 
// 每 个 集合 元 素 是 Student、Enrolment 
// 和 stuName 三 个 元 素 的 数组 
Object[] objs = (Object[])it.next()7 
Student s = (Student)objs[0]; 
Enrolment e = (Enrolment)objs[1]; 
String stuName = (String)objs[2]; 
System.out.println(s.getName{() + "\t" 
+ e.getYear() + "\t" + e.getSemester() 
+ "\t=" + evgetCourse() .getName() + "=\t" + stuName); 
} 
} 


通过 使 用 命名 SQL 查询 ， 则 可 以 将 SQL 语句 从 Java 程序 中 解 耦 出 来 ， 从 而 提供 更 灵活 的 功能 。 

除 此 之 外 ，Hibernate 允许 把 结果 集 的 映射 信息 放 在 <resultset../> 元 素 定 义 ， 这 样 就 可 让 多 个 命名 
查询 共用 该 结果 集 映射 。 通 过 为 <sql-query.…/> 元 素 指定 resultset-ref 属性 ， 就 可 让 命名 SQL 查询 使 用 
-个 已 有 的 结果 集 映 射 了 。 例 如 ， 如 下 代码 定义 了 一 个 独立 的 结果 集 映射 。 


<resultset name="studentGroup"> 
<return alias="s" class="lee.Student"/> 
<return-scalar column="s.name" type="string"/> 
</resultset> 


下 面 的 命名 SQL 查询 就 可 使 用 上 面 的 结果 集 映射 信息 了 : 


<sql-query name="test" resultset-ref="studentGroup"> 
select s.* from student s 
</sql-query> 


》>>6.6.5 调用 存储 过 程 


从 Hibemate 3 开始 ，Hibemnate 可 以 通过 命名 SQL 查询 来 调用 存储 过 程 或 函数 。 对 于 函数 ， 该 函数 必 
须 返 回 一 个 结果 集 ， 对 于 存储 过 程 ， 该 存储 过 程 的 第 一 个 参数 必须 是 传 出 参数 ， 且 其 数据 类 型 是 结果 集 。 
下 面 是 MySQL 中 创建 存储 过 程 的 简单 代码 。 
-创建 一 个 简单 的 存储 过 程 


create procedure select_all_student () 
select * 
from student_inf; 


和 如果 需要 使 用 该 存储 过 程 ， 可 以 先 将 其 定义 成 命名 SQL 查询 ， 当 使 用 原生 SQL 来 调用 存储 过 程 
或 触发 器 时 ， 应 为 <sql-query... 亿 元 素 指定 callable="true"。 

例如 如 下 映射 片段 。 

程序 清单 :codes\06\6.6named_sql\src\org\erazyitapp\domain\Studenthbm-xml 

<!-~ 定义 一 个 调用 存储 过 程 的 命名 SQL 查询 --> 
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<sql-query name="callProcedure" callable="true"> 
<!-- 将 查询 结果 转换 成 Student 实体 --> 
<return class="Student"> 
<!-- 将 查询 的 数据 列 转换 成 实体 的 属性 --> 
<return-property name="studentNumber" 
name="name" column="name"/> 
{call select all student ()} 
</sql-query> 
正如 上 面 的 配置 文件 所 示 , 当 使 用 命名 SQL 查询 来 调用 存储 过 程 时 ,不 仅 需 要 增加 callable="true"， 
还 需要 使 用 <retum-property.… 人 > 子 元 素 将 指定 列 转换 成 实体 的 属性 。 
Java 程序 执行 该 命名 查询 依然 与 前 面 完 全 一 样 ， 程 序 如 下 。 
程序 清单 : codes\06\6.6named_sql\src\lee\NamedSQLTestjava 


// 调 用 存储 过 程 
private void callProcedure() 
{ 


// 打 开 Session 和 事务 

Session session = HibernateUtil.currentSession(); 

Transaction tx = session.beginTransaction()7 

// 调 用 命名 查询 ， 直 接 返 回 结果 

List 1 = session.getNamedQuery ("callProcedure") 
-list(); 

tx.commit (); 

HibernateUtil.closeSession(); 

// 志 历 结果 集 


区 
注意 :三 
Hibernate 当前 仅 支持 存储 过 程 返回 标量 和 实体 ， 
<load-collection..…/> 元 素来 预 初始 化 关联 实体 。 


调用 存储 过 程 还 有 如 下 需要 注意 的 地 方 : 

> ”建议 采用 的 调用 方式 是 标准 SQL92 语法 ,如 {? = callfunctionName(<parameters>)} 或 {call 
procedureName(<parameters>)}， 不 支持 原生 的 调用 语法 。 

> 因为 存储 过 程 本 身 完成 了 查询 的 全 部 操作 。 因 此 ， 调 用 存储 过 程 进行 的 查询 无 法 使 用 
setFirstResult()/setMaxResults() 进 行 分 页 。 

对 于 Oracle 有 如 下 规则 : 

> 函数 必须 返回 一 个 结果 集 ， 存 储 过 程 的 第 一 个 参数 必须 是 OUT,， 它 返回 一 个 结果 集 ， 这 个 结 
果 集 由 Oracle 9 或 10 的 SYS_REFCURSOR 类 型 来 完成 ， 也 就 是 在 Oracle 存储 过 程 中 需 
要 定义 一 个 REF CURSOR 类 型 ， 并 使 用 该 类 型 来 定义 函数 返回 值 或 者 存储 过 程 的 第 一 个 参 
数 。 

对 于 Sybase 或 者 MS SQL server 有 如 下 规则 : 

> ”存储 过 程 必须 返回 一 个 结果 集 ， 虽 然 这 些 数据 库 可 能 返回 多 个 结果 集 或 记录 的 更 新 条 数 。 但 
Hibernate 只 取出 第 一 条 结果 集 作为 它 的 返回 值 ， 其 他 将 被 丢弃 。 

> 如果 可 以 在 存储 过 程 里 设 定 SET NOCOUNT ON, 这 可 能 会 使 效率 更 高 。 不 过 这 不 是 必需 的 。 


>》6.6.6 使 用 定制 SQL 


很 多 时 候 ， 笔 者 会 见 到 一 些 有 经 验 的 程序 员 试图 扩展 Hibemate， 希 望 改变 Hibernate 底层 的 持久 
化 机 制 〈 通 常 可 以 通过 Hibernate 的 事件 框架 和 拦截 器 机 制 来 实现 )。 如 果 确实 有 一 些 非常 特别 的 需要 ， 
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那 可 能 必须 通过 扩展 Hibernate 来 实现 。 

但 Hibernate 3 本 身 提供 了 极 好 的 可 扩展 性 ， 通 过 使 用 定制 SQL 可 以 完全 控制 Hibernate 底层 持久 
化 所 用 的 SQL 语句 。 

当 Hibernate 需要 保存 、 更 新 、 删 除 持久 化 实体 时 ， 默 认 通 过 一 套 固定 的 SQL 语句 来 完成 这 些 功 
能 ， 如 果 程序 需要 改变 这 套 默 认 的 SQL 语句 ， 就 可 以 使 用 Hibernate 3 所 提供 的 定制 SQL 功能 。 

Hibernate 允许 在 <class.… 户 元 素 以 及 系列 映射 集合 的 元 素 里 使 用 <sql-insert..…/>、<sql-delete.…./> 和 
<sql-update.…/> 等 元 素来 指定 定制 SQL 语句 。 

我 们 下 面 需要 在 持久 化 News 实体 时 使 用 定制 SQL。 例如， 将 所 有 的 title 列 的 字符 串 全 部 大 写 ， 
则 可 以 采用 如 下 映射 文件 来 映射 News 持久 化 类 。 

程序 清单 : codes\06\6.6\org\crazyitapp\domain\News.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate3 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://wuw.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- 上 面 四 行 对 所 有 的 hibernate 映射 文件 都 相同 --> 
<!-- hibernate-mapping 是 映射 文件 的 根 元 素 一 -> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-~ 每 个 class 元 素 对 应 一 个 持久 化 对 象 -一 > 
<class name="News" table="news_inf"> 
<!~~ id 元素 定义 持久 化 类 的 标识 属性 --> 
<id name="id"> 
<generator class="identity"/> 
</id> 
<!-- property 元 素 定义 常规 属性 --> 
<property name="title"/> 
<property name="content"/> 
<loader query-ref="new_loader"/> 
<sql-insert>insert into news_inf 
(title, content) values (upper(?), ?)</sql-insert> 
<sql-update>update news_inf 
aet title=upper(?) ,content=? where id=?</sql-update> 
<sql-delete>delete from news_table where id=?</sql-delete> 
</el > 
tod 
在 上 面 的 映射 文件 中 我 们 指定 了 持久 化 News 对 象 时 所 用 的 insert、update 和 delete 语句 ， 当 程序 
保存 一 个 News 实体 时 ， 将 看 到 Hibernate 生成 了 如 下 的 SQL 语句 。 
insert 
into 
news_table 
(title，content) 
values 
(upper (?) ,?) 
从 上 面 的 SQL 语句 可 以 看 出 , Hibemate 已 经 不 再 采用 默认 的 insert 语句 了 ,而 是 采用 <sql-insert..…./> 
元 素 所 指定 的 insert 语句 了 。 
这 些 SQL 语句 直接 在 底层 数据 库 里 执行 , 所 以 程序 可 以 充分 利用 底层 数据 库 的 优势 。 但 如 果 程序 
过 多 地 使 用 数据 库 特定 的 语法 ， 自 然 就 会 降低 应 用 的 可 移植 性 了 。 
如 果 我 们 希望 使 用 存储 过 程 来 执行 插入 、 更 新 \ 修 改 等 操作 , 则 只 需 为 <sql-insert.…/>、<sql-delete..…/> 
和 <sql-update.…/> 指 定 callable="true" 即 可 。 例 如 如 下 配置 片段 : 
<class name="Person"> 
<id name="id"> 
<generator class="increment"/> 
</id> 
<property name="name" not-null="true"/> 
<sql-insert callable="true">{call createPerson (?, ?)}</sql-insert> 
<sql-delete callable="true">{? = call deletePerson (?)}</sql-delete> 
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<sql-update callable="true">{? = call updatePerson (?, ?)}</sql-update> 
</class> 


使 用 这 种 用 法 时 参数 的 顺序 很 重要 ， 调 用 存储 过 程 的 顺序 必须 和 Hibernate 所 期 待 的 顺序 相同 。 
程序 可 以 将 日 志 调试 级 别 设 为 org.hibernate.persister.entity, 从 而 允许 查看 Hibemate 所 期 待 的 顺序 。 


Fn SQL 的 预计 顺序 时 , 先 不 要 使 用 定制 SQL 功能 .等 记录 了 Hibemate 静态 SQL : 
所 期 竺 的 顺序 后 ， 再 到 映射 文件 中 配置 定制 SQL。 


该 让 存储 过 程 能 返回 该 存储 过 程 所 影响 的 记录 行 数 。Hibemate 通常 把 CUD 
操作 语句 的 第 一 个 参数 注册 为 数值 型 输出 参数 ， 所 以 我 们 应 让 存储 过 程 的 第 一 个 传 出 参数 记录 该 存储 
过 程 所 影响 的 记录 条 数 。 

不 仅 如 此 ， 因 为 命名 的 SQL 查询 可 以 返回 一 个 指定 实体 ， 所 以 我 们 可 以 使 用 命名 SQL 查询 来 实 
现 定制 装载 。 例 如 ， 下 面 程序 希望 在 装载 News 实体 时 为 其 itle 属性 的 前 后 增加 3 个 等 号 (=)， 那 么 
我 们 就 可 以 通过 定制 装载 来 实现 。 

首先 ， 在 映射 文件 中 增加 如 下 命名 SQL 配置 : 

<!-- 定义 一 个 命名 soL 查询 --> 


<sql-query name="new_loader"> 
<!-- 指定 将 n 别名 转换 成 News 实体 --> 


<return alias="n" class="News"/> 


id aa {n.id}, 
Concat('===' , concat(title , '===')) as {n.title}), 
content as {n.content} 
from news_table 
</sql-query> 
从 上 面 的 粗 体 字 代码 可 以 看 出 ， 上 面 的 SQL 语句 实现 了 将 title 属性 前 后 增加 等 号 的 功能 , 而 且 该 
命名 SQL 正好 装载 了 一 个 News 对 象 ， 所 以 我 们 可 以 将 该 命名 SQL 指定 为 News 实体 的 定制 加 载 器 。 
映射 定制 加 载 器 使 用 < loader.. 人 元素， 该 元 素 通过 query-ref 属性 值 为 某 个 已 有 的 命名 SQL 查询 , 指定 
该 SQL 查询 将 作为 News 的 定制 装载 器 。 
上 面 的 SQL 语句 中 使 用 了 {ntidle}、fn.content} 等 别名 形式 ， 这 种 别名 不 是 标准 SQL 所 支持 的 语 
法 ， 而 是 Hibernate 才 支 持 的 ， 这 种 别名 的 作用 是 将 指定 数据 列 映射 到 某 实体 的 指定 属性 。 
在 News.hbm.xml 文件 中 增加 如 下 配置 片段 : 
<loader query-ref="new_loader"/> 
至 此 ， 当 程序 装载 一 个 News 对 象 时 将 看 到 如 下 SQL 语句 : 


Select 
id as id0 0 ， 
concat ('===" , 
concat (title ， '==')) as title0_0_， 
content as content0_0_ 

from 
news_table 

where 
id=? 


6.7 数据 过 滤 


数据 过 滤 并 不 是 一 种 常规 的 数据 查询 方法 ， 而 是 一 种 整体 的 筛选 方法 。 数 据 过 滤 也 可 对 数据 进行 
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筛选 ， 因 此 通常 也 把 数据 过 滤 当 成 Hiberate 查询 框架 的 一 部 分 。 

如 果 一 旦 启用 了 数据 过 滤器 ， 则 不 管 数据 查询 , 还 是 数据 加 载 ， 该 过 滤器 将 自动 作用 于 所 有 数据 。 
只 有 满足 过 滤 条 件 的 记录 才 会 被 选 出 来 。 

过 滤器 与 定义 在 类 和 集合 映射 文件 上 的 “where” 属性 非常 相似 。 它们 的 区 别 是 过 滤器 可 以 带 参数 ， 
应 用 程序 可 以 在 运行 时 决定 是 否 启用 指定 的 过 滤器 ， 使 用 怎样 的 参数 值 。 而 映射 文件 上 的 “where” 属 
性 将 一 直 生 效 ， 且 无 法 动态 传 入 参数 。 

过 滤器 的 用 法 很 像 数 据 库 视 图 ， 区 别 是 视图 在 数据 库 中 已 经 定义 完成 ， 而 过 滤器 则 还 需 在 应 用 程 
序 中 确定 参数 值 。 

过 滤器 的 使 用 分 成 三 步 : 

(1) 定义 过 滤器 。 使 用 <filter-def .. 亿 元 素 定义 过 滤器 。 

(2) 使 用 过 滤器 。 使 用 <filter.. 亿 元 素 应 用 过 滤器 。 

(3) 代码 中 通过 Session 启用 过 滤器 。 

前 两 个 步骤 都 是 在 Hibernate 的 映射 文件 中 完成 的 ， 其 中 <filter-def..…> 是 <hibernate-mapping.…/> 元 
素 的 子 元 素 ， 而 <filter.….> 元 素 是 <class..…/>、 集 合 等 元 素 的 子 元 素 。 

<filter-def... 人 元 素 用 于 定义 一 个 过 滤器 ，<filter.. 人 > 则 将 指定 的 过 滤器 应 用 到 指定 的 持久 化 类 。 

-个 持久 化 类 或 集合 可 以 使 用 多 个 过 滤器 ， 而 一 个 过 滤器 也 可 以 作用 于 多 个 持久 化 类 或 集合 。 
看 下 面 的 映射 文件 示例 。 
程序 清单 :codes\06\6.7\filten\src\org\crazyit\app\domain\Product.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate. sourceforge.net/hibernate-mapping-3.0.dtd"> 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 映射 Course 实体 --> 
<class name="Product" table="product_inf"> 
<!-- 映射 标识 属性 -> 
<id name="id" column="product_id"> 
<!-- 指定 identity 的 主键 生成 器 策略 --> 
<generator class="identity"/> 
</id> 
<!-- property 映射 普通 属性 一 > 
<property name="name" column="product_name" 
type="string"/> 
<property name="stockNumber" column="stock_number" 
type="int"/> 
<property name="effectivestartDate" 
column="eff_start_date" type="java.util.Date"/> 
<property name="effectiveEndDate" 
column="eff_end_date" type="java.util.Date"/> 
<!-- 映射 Product 和 Category 的 关联 关系 --> 
<set name="categories" fetch="join" table="product_category" > 
<key column="product_id"/> 
<many-to-many column="category_id" 
class="Category" fetch="join"> 
<!-- 对 该 关联 实体 的 抓 取 使 用 数据 过 滤 --> 
<filter name="effectiveDate" 
condition=":asOfDate BETWEEN 
eff_start_date and eff_ end date"/> 
<filter name="category" 
condition="category_id = :catId"/> 
</many-to-many> 
</set> 
<!-- 对 Product 实体 使 用 数据 过 滤 --> 
<filter name="effectiveDate" 
condition=" :asOfDate BETNEEN eff_start date AND eff _ end _ date"/> 


</class> 
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<!-- 下 面 定义 2 个 Filter --> 
<filter-def name="effectiveDate"> 
<filter-param name="asOfDate" type="date"/> 
</filter-def> 
<filter-def name="category"> 
<filter-param name="catId" type="long"/> 
</filter-def> 
</hibernate-mapping> 
在 上 面 的 配置 文件 中 最 后 的 粗 体 字 代码 定义 了 两 个 过 滤器 ， 过 滤器 的 定义 通过 <filter-def.. 人 > 元 素 
完成 。 定 义 过 滤器 时 ， 只 需要 指定 过 滤器 的 名 字 ， 以 及 过 滤器 的 参数 即 可 。 就 如 Java 里 的 一 个 方法 声 
明 ， 只 有 方法 名 和 参数 列表 ， 具 体 的 方法 实现 是 没有 的 。 
过 滤器 的 过 滤 条 件 要 等 到 使 用 过 滤器 时 才 确 定 ， 使 用 过 滤器 通过 <filter.. 人 元 素 确定 ，<filter.. 人 > 的 
condition 属性 用 于 指定 过 滤 条 件 ， 只 有 满足 该 条 件 的 记录 才 会 被 抓 取 。 
<filter.… 户 元素 既 可 作为 <class.…/> 元 素 的 子 元 素 使 用 ， 该 过 滤器 将 会 对 整个 持久 化 类 的 所 有 实例 进 
行 过 滤 ; <filter..… 户 元素 也 可 以 作为 <list.…>、<set..….> 和 <map.… 户 等 集合 元 素 的 子 元 素 使 用 ， 该 过 滤器 


对 : 集合 属性 进行 过 滤 。 


condition 属性 值 是 一 个 SQL 风格 的 ， where 子 句 ， 因 此 condition 属性 所 指定 的 过 滤 
条 件 应 该 根据 表 名 、 列 名 进行 


系统 默认 不 启用 过 滤器 ， Session 的 enableFilter(String filterName) 才 可 以 启用 过 滤器 ,该 
方法 返回 一 个 Filter 实例 ，Filter 包含 setParameter 方法 用 于 为 过 滤器 参数 赋值 。 
- 旦 启用 了 过 滤器 ， 过 滤器 在 整个 Session 内 有 效 ， 所 有 的 数据 加 载 将 自动 应 用 该 过 滤 条 件 ， 直 
到 调用 disableFilter 方法 。 
看 下 面 使 用 过 滤器 的 示例 代码 片段 。 
程序 清单 :codes\06\6.7\filter\src\lee\ProductManager.java 


public class ProductManager 


{ 
SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd"); 


public static void main(String[] args) 
throws Exception 
{ 
ProductManager mgr = new ProductManager(); 
mgr.test (); 
HibernateUtil.sessionFactory.close(); 
上 Private void test() throws Exception A 


Session session = HibernateUtil.currentSession(); 

Transaction tx = session.beginTransaction(); 

// 启 动 effectiveDate 过 滤器 ， 并 设置 参数 

session.enableFilter ("effectiveDate") 
.setParaneter ("asOfDate", new Date()); 

// 启 动 category 过 滤器 ， 并 设置 参数 

session.enableFilter ("category") 
.setParaneter ("catId", new Long(2)); 

// 查 询 所 有 Product 实体 ， 不 加 任何 筛选 条 件 

Iterator results = Session.createQuery("fram Product as Pp") 
.iterate(); 

while (results.hasNext()) 

{ 
Product p = (Product)results.next(); 
System.out.println(p.getName ()); 
Iterator it = p.getCategories() .iterator(); 
System.out.println (p.getCategories() .size()); 
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while (it.hasNext()) 
{ 
Category c = (Category)it.next (); 
System.out.println (c.getName()); 
} 
} 
tx.commit (); 
HibernateUtil.closesession(); 
} 
} 


上 面 的 程序 中 两 行 粗 体 字 代码 启用 了 过 滤器 ， 并 为 过 滤器 设置 了 合适 的 参数 。 通 常 来 说 ， 如 果 某 
个 筛选 条 件 使 用 得 非常 频繁 ， 那 么 我 们 可 以 将 该 筛选 条 件 设置 为 过 滤器 ;如 果 是 临时 的 数据 筛选 ， 还 
是 使 用 常规 查询 比较 好 。 对 于 在 SQL 语句 中 使 用 行内 表达 式 、 视 图 的 地 方 ， 现 在 可 考虑 使 用 过 滤器 。 


| 在 一 个 映射 文件 中 定义 的 过 泪 器 ， 完 全 可 以 在 其 他 不 同 的 映射 文件 中 使 用 。 前 提 是 
| 这 些 映射 文件 由 一 个 SessionFactory 负责 加 载 并 管理 。 可 


6.8 ”事务 控制 


每 个 业务 逻辑 方法 都 是 由 一 系列 的 数据 库 访问 完成 的 ， 这 一 系列 的 数据 访问 可 能 会 修改 多 条 数据 
记录 ， 这 一 系列 的 修改 应 该 是 一 个 整体 ， 绝 不 能 仅 修改 其 中 的 几 条 。 也 就 是 说 ， 多 个 数据 库 原 子 访问 
应 该 绑 定 成 一 个 整体 一 一 这 就 是 事务 。 事 务 是 一 个 最 小 的 逻辑 执行 单元 ， 整 个 事务 的 执行 不 能 分 开 执 
行 ， 要 么 同时 执行 ， 要 么 同时 放弃 执行 。 


》>>6.8.1 事务 的 概念 


事务 是 一 步 或 几 步 基本 操作 组 成 的 逻辑 执行 单元 ， 这 些 基本 操作 作为 一 个 整体 执行 单元 ， 它 们 要 
么 全 部 执行 ， 要 么 全 部 取消 ， 绝 不 能 仅仅 执行 部 分 。 一 般 而 言 ， 每 次 用 户 请 求 ， 对 应 一 个 业务 逻辑 方 
法 ， 一 个 业务 逻辑 方法 往往 具有 逻辑 上 的 原子 性 ， 应 该 使 用 事务 。 例 如 一 个 转账 操作 ， 对 应 修改 两 个 
账户 的 余额 ， 这 两 个 账户 的 修改 要 么 同时 生效 ， 要 么 同时 取消 一 一 同时 生效 是 转账 成 功 ， 同 时 取消 是 
转账 失败 ;但 不 可 只 修改 其 中 一 个 账户 ， 那 将 破坏 数据 库 的 完整 性 。 
通常 来 讲 ， 事 务 具 备 4 个 特性 : 原子 性 Atomicity)、 一 致 性 (Consistency)、 隔 离 性 (Isolation) 
和 持续 性 〈Durability)。 这 4 个 特性 也 简称 为 ACID 性 。 
> 原子 性 (Atomicity) :事务 是 应 用 中 最 小 执行 单位 ， 就 如 原子 是 自然 界 最 小 颗粒 ， 具 有 不 可 
再 分 的 特征 一 样 。 事 务 是 应 用 中 不 可 再 分 的 最 小 逻辑 执行 体 。 
> ”一致 性 (Consistency) : 事务 执行 的 结果 ， 必 须 使 数据 库 从 一 个 一 致 性 状态 ， 变 到 另 一 个 一 
致 性 状态 。 当 数据 库 只 包含 事务 成 功 提 交 的 结果 时 ， 数 据 库 处 于 一 致 性 状态 。 如 果 系 统 运行 
发 生 中 断 ， 某 个 事务 尚未 完成 而 被 迫 中 断 ， 而 该 未 完成 的 事务 对 数据 库 所 做 的 修改 已 被 写 入 
数据 库 ， 此 时 ,数据库 就 处 于 一 种 不 正确 的 状态 。 比 如 银行 在 两 个 账户 之 间 转 账 ， 从 A 账户 
向 B 账户 转 入 1000 元 。 系 统 先 减少 A 账户 的 1000 元 ， 然 后 再 为 B 账户 增加 1000 元 。 如 
果 全 部 执行 成 功 ， 数 据 库 处 于 一 致 性 状态 。 如 果 仅 执 行 完 A 账户 金额 的 修改 ， 而 没有 增加 B 
账户 的 金额 ， 则 数据 库 就 处 于 不 一 致 性 状态 。 因 此 ， 一 致 性 是 通过 原子 性 来 保证 的 。 
> ”隔离 性 〈lsolation) : 各 个 事务 的 执行 互 不 干扰 ， 任 意 一 个 事务 的 内 部 操作 对 其 他 并 发 的 事 
务 ， 都 是 隔离 性 。 即 : 并 发 执行 的 事务 之 间 不 能 互相 影响 。 
> ”持续 性 (Durability) : 持续 性 也 称 为 持久 性 〈Persistence) ， 指 事务 一 旦 提交 ， 对 数据 所 做 
的 任何 改变 ， 都 要 记录 到 永久 存储 器 中 ， 通 常 就 是 保存 进 物理 数据 库 。 
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>>6.8.2 Session 与 事务 


Hibernate 的 事务 《Transaction 对 象 ) 通过 Session 的 beginTransaction0 方 法 显 式 打开 ，Hibernate 
自身 并 不 提供 事务 控制 行为 (没有 添加 任何 附加 锁定 行为 )) Hibernate 底层 直接 使 用 JDBC 连接 、JTA 
资源 或 其 他 资源 的 事务 。 

Hibernate 只 是 对 底层 事务 进行 了 抽象 ， 让 应 用 程序 可 以 直接 面向 Hibernate 事务 编程 ， 从 而 将 应 
用 程序 和 JDBC 连接 、JTA 资源 或 其 他 事务 资源 隔离 开 了 .从 编程 角度 来 看 , Hibernate 的 事务 由 Session 
对 象 开 启 ; 从 底层 实现 来 看 ，Hibernate 事务 由 TransactionFactory 的 实例 来 产生 。 

TransactionFactory 是 一 个 事务 工厂 的 接口 ，Hibemate 为 不 同 的 事务 环境 提供 了 不 同 的 实现 类 ， 如 
CMTTransactionFactory (针对 容器 管理 事务 环境 的 实现 类 )、JDBCTransactionFactory (针对 JDBC 局 
部 事务 环境 的 实现 类 )、JTATransactionFactory (针对 JTA 全 局 事务 环境 的 实现 类 )。 

应 用 程序 编程 候 无 须 手动 操作 TransactionFactory 产生 事务 ， 这 是 因为 SessionFactory 底层 已 经 封 
装 了 TransactionFactory。SessionFactory 对 象 的 创建 代价 很 高 ， 它 是 线程 安全 的 对 象 ， 被 设计 成 可 以 被 
所 有 线程 所 共享 。 通 常 ，SessionFactory 会 在 应 用 程序 启动 时 创建 ， 一 旦 创建 了 SessionFactory 将 不 会 
轻易 关闭 ， 只 有 当 应 用 退出 时 才 关 闭 SessionFactory。 

Session 对 象 是 轻 量 级 的 , 它 也 是 线程 不 安全 的 。 对 于 单个 业务 进程 、 单个 的 工作 单元 而 言 , Session 
只 被 使 用 一 次 。 创 建 Session 时 ， 并 不 会 立即 打开 与 数据 库 之 间 的 连接 ， 只 有 需要 进行 数据 库 操作 时 ， 
Session 才 会 获取 JDBC 连接 。 因 此 ， 打 开 和 关闭 Session， 并 不 会 对 性 能 造成 很 大 的 影响 。 甚 至 即使 
无 法 确定 一 个 请 求 是 否 需 要 数据 访问 , 也 可 以 打开 Session 对 象 , 因为 如 果 不 进行 数据 库 访问 ，Session 
不 会 获取 JDBC 连接 。 

由 此 可 见 ， 长 Session 应 用 性 能 影响 并 不 大 一 一 只 要 它 没 有 长 时 间 打 开 数 据 库 连 接 。 

相反 ， 数 据 库 事务 应 该 尽 可 能 地 短 ， 从 而 降低 数据 库 锁定 造成 的 资源 争 用 。 数 据 库 长 事务 会 导致 
应 用 程序 无 法 承载 高 并 发 的 负荷 。 

Hibernate 的 所 有 持久 化 访问 都 必须 在 Session 管理 下 进行 ， 但 并 不 推荐 因为 一 次 简单 的 数据 库 原 
子 调用 ， 就 打开 和 关闭 一 次 Session， 数 据 库 事务 也 是 如 此 。 因 为 对 于 一 次 原子 操作 打开 的 事务 没有 任 
何 意义 一 一 事务 应 该 是 将 多 个 操作 步骤 组 合成 一 个 逻辑 整体 。 

季 . 注意 : 

启动 事务 后 ， 单 个 的 SQL 语句 发 送 之 后 ， 自 动 事务 提交 模式 将 会 失效 .自动 提交 模 
式 仅 为 SQL 控制 台 设计 ， 在 实际 项 目 中 没有 太 大 的 实用 价值 。Hibernate 禁止 使 用 自动 


i 


本 


一 个 完 


Hibernate 建议 采用 每 个 请 求 对 应 常 表示 需要 执 : 
整 的 业务 功能 ， 这 个 功能 由 系列 的 数据 库 原子 操作 组 成 ， 而 且 它们 应 该 是 一 个 逻辑 上 的 整体 。 

每 个 请 求 对 应 一 个 Session 的 模式 不 仅 可 以 用 于 设计 操作 单元 ， 甚 至 ， 很 多 业务 处 理 流程 都 需要 
组 合 一 系列 的 用 户 操作 ， 即 用 户 对 数据 库 的 交叉 访问 。 

需要 指出 的 是 : 对 于 企业 级 应 用 ， 跨 用 户 交互 的 数据 库 事务 是 无 法 接受 的 。 例 如 : 在 第 一 个 页 面 ， 
用 户 打开 对 话 框 ， 用 户 打 开 一 个 特定 Session 装 入 的 数据 ， 用 户 可 以 随意 修改 对 话 框 中 的 数据 ， 修 改 
完成 后 ， 用 户 将 修改 结果 存 入 数据 库 。 

从 用 户 的 角度 来 看 ， 这 个 操作 单元 被 称 为 应 用 程序 长 事务 。 在 一 个 Java EE 应 用 实现 中 ， 可 以 有 
很 多 方法 来 实现 这 种 应 用 程序 长 事务 。 

一 个 比较 差 的 做 法 就 是 在 用 户 与 服务 器 会 话 (session， 通 常 就 是 一 次 HTTP Session) 期 间 ， 应 用 
程序 一 直 保持 Session 与 数据 库 事务 打开 : 当 用 户 思考 时 ， 应 用 程序 保持 Session 和 数据 库 事务 是 打开 
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的 ， 并 保持 数据 库 锁定 ， 以 阻止 并 发 修改 ， 从 而 保证 数据 库 事务 隔离 级 别 和 原子 操作 。 这 种 数据 库 锁 
定 会 导致 应 用 程序 无 法 扩展 并 发 用 户 的 数量 。 

每 次 HTTP Session 对 应 一 次 Hibernate Session 的 模式 会 导致 应 用 程序 无 法 扩展 并 发 用 户 的 数量 ， 
因此 不 推荐 使 用 四 


几乎 在 所 有 情况 下 ， 都 不 要 使 用 每 个 应 用 对 应 一 次 Hibernate Session 的 模式 也 
量 不 要 使 用 每 次 HTTP Session 对 应 一 次 Hibernate Session 的 模式 


但 实际 应 用 中 经 常 需 要 面 对 这 种 应 用 程序 长 事务 ， 对 于 这 种 情况 ，Hibernate 主要 有 如 下 三 种 模式 
来 解决 这 个 问题 。 
> ”自动 版 本 化 ，Hibernate 能 够 自动 进行 乐观 并 发 控制 ， 如 果 在 用 户 思考 的 过 程 中 持久 化 实体 
发 生 并 发 修改 ，Hibernate 能 够 自动 检测 到 。 

> ” 脱 管 对 象 :， 如 果 采 用 每 次 用 户 请 求 对 应 一 次 Session 的 模式 ， 那 么 ， 前 面 载 入 的 实例 在 用 户 
思考 的 过 程 中 ， 始 终 与 Session 脱离 ， 处 于 脱 管状 态 。Hibernate 允许 把 脱 管 对 象 重新 关联 
到 Session 上 ， 并 且 对 修改 进行 持久 化 。 在 这 种 模式 下 ， 自 动 版 本 化 被 用 来 隔离 并 发 修改 。 
这 种 模式 也 被 称 为 使 用 脱 管 对 象 的 每 次 请 求 对 应 一 个 Hibernate Session 

> 长 生命 周期 Session: Session 可 以 在 数据 库 事 务 提交 之 后 ， 断 开 和 底层 的 JDBC 连接 。 当 
新 的 客户 端 请 求 到 来 时 , 它 又 重新 连接 上 底层 的 JDBC 连接 。 这 种 模式 被 称 为 每 个 应 用 程序 
事务 对 应 一 个 Session。 因 为 应 用 程序 事务 是 相当 长 (跨越 多 个 用 户 请 求 ) 的 ， 所 以 也 被 称 
为 长 生命 周期 Session。 

Session 缓存 了 处 于 持久 化 状态 的 每 个 对 象 〈Hibernate 会 监视 和 检查 脏 数据 )， 也 就 是 说 ， 如 果 程 
序 让 Session 打开 很 长 一 段 时 间 ， 或 者 载 入 了 过 多 的 数据 ， Session 占用 的 内 存 会 一 直 增长 ， 直 到 抛 出 
OutOfMemoryException 异常 。 为 了 解决 这 个 问题 ， 程 序 定期 调用 Session 的 clear0 和 evict() 方 法 来 管 
理 Session 的 缓存 。 对 于 一 些 大 批量 的 数据 处 理 ， 推 荐 使 用 DML 风格 的 HQL 语句 完成 。 

如 果 在 Session 范围 之 外 访问 未 初始 化 的 集合 或 代理 (由 Hibemate 的 延迟 加 载 特性 所 引起 )， 
Hibernate 将 会 抛 出 LazyInitializationException 异常 。 也 就 是 说 ， 在 脱 管状 态 下 ， 访 问 一 个 实体 所 拥有 
的 集合 ， 或 者 访问 其 指向 代理 的 属性 时 ， 都 将 引发 此 异常 。 

为 了 保证 在 Session 关闭 之 前 初始 化 代理 属性 或 集合 属性 ,程序 可 以 强行 调用 teacher.getName0 或 
者 teacher.getStudents().size0) 之 类 的 方法 来 实现 ， 但 这 样 代码 具有 较 差 的 可 读 性 。 除 此 之 外 ， 也 可 使 用 
Hibernate 的 initialize(Object proxy) 静 态 方法 来 强制 初始 化 某 个 集合 或 代理 。 只 要 Session 处 于 open 状 
态 , Hibernate.initialize(teachen) 将 会 强制 初始 化 teacher 代理 , Hibernate.initialize(teacher.getStudents()) 对 
students 集合 具有 同样 的 功能 。 

还 有 另外 一 种 选择 ， 就 是 程序 让 Session 一 直 处 于 打开 状态 ， 直 到 装 入 所 有 需要 的 集合 或 代理 。 
在 某 些 应 用 架构 中 , 特别 是 对 于 那些 需要 使 用 Hibernate 进行 数据 访问 的 代码 , 以 及 那些 需要 在 不 同 应 
用 层 和 不 同 进程 中 使 用 Hibernate 的 应 用 ， 如 何 保证 Session 处 于 打开 状态 也 是 一 个 问题 。 通 常 有 两 种 
方法 可 以 解决 此 问题 : 

> 在 一 个 Web 应 用 中 ， 可 以 利用 过 滤器 (Fikter) ， 在 用 户 请 求 结束 、 页 面 生成 结束 时 关闭 

Session。 也 就 是 保证 在 视图 显示 层 一 直 打 开 Session， 这 就 是 所 谓 的 Open Session in View 
模式 。 当 然 采用 这 种 模式 时 必须 保证 所 有 异常 得 到 正确 处 理 ， 在 呈现 视图 界面 之 前 ， 或 在 生 
成 视图 界面 的 过 程 中 发 生 异 常 时 ， 必 须 保 证 可 以 正确 关闭 Session， 并 结束 事务 。 


名 “Spring 框架 提供 的 OpenSessionInViewFilter 就 可 以 满足 这 个 要 求 。 i 
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> ”使 用 业务 逻辑 层 来 负责 准备 数据 ， 在 业务 逻辑 层 返回 数据 之 前 ， 业 务 逻 辑 层 对 每 个 所 需 集合 
调用 Hibernate.initialize() 方 法 ， 或 者 使 用 带 fetch 子 句 或 FetchMode.JOIN 的 查询 ， 事 先 取 
得 所 有 数据 ， 并 将 这 些 数据 封装 成 VO〔 值 对 象 ) 集合 ， 然 后 程序 可 以 关闭 Session 了 。 业 
务 迎 辑 层 将 VO 集 传 入 视图 层 , 让 视图 层 只 负责 简单 的 显示 逻辑 。 这 是 笔者 比较 喜欢 的 模式 ， 
在 这 种 模式 下 ， 可 以 让 视图 层 和 Hibernate API 彻底 分 离 ， 保 证 视图 层 不 会 出 现 持久 层 API， 
从 而 提供 更 好 的 解 耦 。 


和 6.8.3 上 下 文 相关 的 Session 


前 面 所 有 的 Hibernate 应 用 使 用 Session 时 都 用 到 了 HibernateUtil 工具 类 ， 因 为 该 工具 类 可 以 保证 
将 线程 不 安全 的 Session 绑 定 限制 在 当前 线程 内 一 一 也 就 是 实现 一 种 “上 下 文 相关 的 ”Session。 

从 Hibernate 3 开始 ，Hibernate 增加 了 SessionFactory.getCurrentSession() 方 法 ， 该 方法 可 直接 获取 
“上 下 文 相关 ” 的 Session。 上 下 文 相 关 Session 的 早期 实现 必须 依赖 于 JTA 事务 , 因此 比较 适合 于 在 容 
器 中 使 用 Hibernate 的 情形 。 

从 Hibernate 3.1 开始 ，SessionFactory.getCurrentSession() 的 底层 实现 是 可 插 拔 的 , Hibernate 引入 了 
CurrentSessionContext 接口 ， 并 通过 hibernate.current_session_context_class 参数 来 管理 上 下 文 相关 
Session 的 底层 实现 。 

Fa Hibemate 此 处 管理 上 下 文 相 关 Session 的 方式 就 是 典型 的 策略 模式 。 | 
CurrentSessionContext 接口 有 如 下 三 个 实现 类 。 
> org.hibernate.context.JTASessionContext: 根据 JTA 来 跟踪 和 界定 上 下 文 相 关 Session， 
这 和 最 早 的 仅 支持 JTA 的 方法 是 完全 一 样 的 。 

> org.hibernate.contextThreadLocalSessionContext: 通过 当前 正在 执行 的 线程 来 跟踪 和 界定 
上 下 文 相 关 Session， 也 就 是 和 前 面 的 HibernateUtil 的 Session 维护 模式 相似 。 

> org.hibernate.context.ManagedSessionContext: 通过 当前 执行 的 线程 来 跟踪 和 界定 上 下 文 
相关 Session。 但 是 程序 需要 使 用 这 个 类 的 静态 方法 将 Session 实例 绑 定 、 取 消 绑 定 ， 它 并 
不 会 自动 打开 、flush 或 者 关闭 任何 Session。 

如 果 使 用 ThreadLocalSessionContext 策略 ，Hibernate 的 Session 会 随 着 getCurrentSession() 方 法 自 
动 打开 ， 并 随 着 事务 提交 自动 关闭 ， 非 常 方便 。 对 于 在 容器 中 使 用 Hibernate 的 场景 而 言 ， 通 常会 采用 
第 一 种 方式 ， 对 于 独立 的 Hibernate 应 用 而 言 ， 通 常会 采用 第 二 种 方式 。 

为 了 指定 Hibernate 使 用 哪 种 Session 管理 方式 ， 可 以 在 hibemate.cfg.xml 文件 中 增加 如 下 片段 : 

<!-- 指定 根据 当前 线程 来 界定 上 下 文 相关 Session --> 


<property name="hibernate.current_session_context_class">thread</property> 


如 果 在 JTA 事务 环境 中 ， 则 应 增加 如 下 配置 片段 : 


<!-- 指定 根据 JTA 事务 来 界定 上 下 文 相关 Session -~-> 
<property name="hibernate.current_session_context_class">jta</property> 


对 于 第 三 种 不 太 常用 的 Session 管理 机 制 ， 则 可 在 配置 文件 中 简写 成 : managed。 

关于 使 用 当前 线程 来 界定 上 下 文 相关 Session 的 示例 程序 ， 读 者 可 以 参考 光盘 中 codes\06\6.8 路 径 
下 的 currentSession 应 用 。 实际 上 ， 关 于 Hibernate 的 Session 和 事务 的 管理 ，Spring 框架 提供 了 非常 完 
美的 解决 方案 ， 本 书 将 在 后 面 有 更 详细 的 介绍 。 


6.9 二 级 缓存 和 查询 缓存 


前 面部 分 已 经 提 到 ，Hibemate 包括 两 个 级 别 的 缓存 : 
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> ”默认 总 是 启用 的 Session 级 别 的 一 级 缓存 。 

> ”可 选 的 SessionFactory 级 别 的 二 级 缓存 。 

其 中 Session 级 别 的 一 级 缓存 不 需要 开发 者 关心 ， 默 认 总 是 有 效 的 ， 当 应 用 保存 持久 化 实体 、 修 
改 持久 化 实体 时 ，Session 并 不 会 立即 把 这 种 改变 flush 到 数据 库 , 而 是 缓存 在 当前 Session 的 一 级 缓存 
中 ， 除 非 程序 显 式 调用 Session 的 flush0 方 法 ， 或 程序 关闭 Session 时 才 会 把 这 些 改变 一 次 性 地 flush 
到 底层 数据 库 一 一 通过 这 种 缓存 ， 可 以 减少 与 数据 库 的 交互 ， 从 而 提高 数据 库 访问 性 能 。 

SessionFactory 级 别 的 二 级 缓存 是 全 局 性 的 ,应 用 的 所 有 Session 都 共享 这 个 二 级 缓存 不 过 Session 
级 别 的 缓存 默认 是 关闭 的 ， 必 须 由 程序 显 式 开启 。 一 旦 在 应 用 中 开启 了 二 级 缓存 ， 当 Session 需要 抓 


es Session 将 会 优先 从 二 级 缓存 抓 取 。 


>》>>6.9.1 开启 二 级 缓存 


为 了 开启 Hibernate 的 二 级 缓存 ， 需 要 在 hibernate.cfg.xml 文件 中 设置 如 下 属性 : 
<!-- 开启 二 级 缓存 --> 


<property name="hibernate.cache.use_second_level_cache">true</property> 
- 旦 开启 了 二 级 缓存 ,并 且 设置 了 对 某 个 持久 化 实体 类 启用 缓存 ，SessionFactory 就 会 缓存 应 用 访 
问 过 的 该 实体 类 的 每 个 对 象 ， 除 非 缓存 的 数据 超出 缓存 空间 。 


六 … :可 能 有 读者 对 缓存 这 个 概念 感到 “深奥 "， 其 实 绥 存 的 理论 十 分 简单 ， 自 己 开发 一 个 绥 | 
有 实现 也 不 难 ， 以 现实 例子 来 说 ， 你 第 一 次 需要 使 用 电脑 ， 去 电脑 城 夹 了 一 台 (类似 于 
| 。 Hibemate 第 一 次 访问 某 个 实体 ， 从 数据 库 读 取 对 应 记录 ,填充 该 实体 对 象 ) 一 一 用 完 之 后 ，| 
:如果 你 立即 丢弃 该 电脑 ， 那 就 是 没有 缓存 ;如果 用 完 之 后 ， 你 把 这 台电 脑 放置 起 来 ， 那 就 
| 。 是 进行 了 缓存 .对 于 Hibemate 的 缓存 来 说 ， 你 可 以 简单 地 把 它 理解 为 一 个 Map， 应 用 程 | 
: 。 序 访 问 过 的 每 个 实体 ( 如 果 对 该 实体 类 启用 了 缓存 ), SessionFactory 都 会 将 它 放 入 这 个 Map : 
| 。 申 ， 以 该 实体 的 标识 属性 值 作为 key， 以 该 实体 作为 value。 当 Session 试图 访问 某 个 实 休 | 
1。 时， 就 可 以 直接 从 该 Nap 中 根据 key 末 读 取 实 体 了 ， 这 样 就 可 以 显 基地 提高 性 能 。 当 然 ， | 
， 。 使 用 缓存 也 有 个 坏处 : 就 像 电脑 放 在 家 里 要 占 地 方 一 样 ， 缓 存 里 的 数据 也 有 内 存 开销 ， 以 
[有 | 
实际 应 用 中 一 般 不 需要 开发 者 自己 实现 缓存 ， 直 接 使 用 第 三 方 提供 的 开源 缓存 实现 即 可 。 因 此 在 
hibematec 人 xml 文件 中 设置 开启 缓存 之 后 , 还 需要 设置 使 用 哪 种 二 级 缓存 实现 类 .例如 如 下 代码 片段， 
<!-- 设置 二 级 缓存 的 实现 类 一 > 
<property name="hibernate cache .Provider_class"> 
org.hibernate.cache .EhCacheProvider</property> 
上 面 的 EhCacheProvider 就 是 Hibernate 常用 的 缓存 实现 ， 除 此 之 外 ，Hibernate 3.6 支持 如 表 6.1 
所 示 的 缓存 实现 。 
表 6.1 Hibernate 3.6 支持 的 缓存 实现 


[ 组 存 实现 提供 类 类 型 集群 安全 查询 缓存 支持 
Hashtable org.hibemate.cache. HashtableCacheProvider 内 存 支持 
EHCache org-hibemate.cache.EhCacheProvider 内 存 ， 磁 盘 支持 
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缓存 实现 提供 类 类 型 集群 安全 查询 缓存 支持 
DSCacheProvider 内 存 ， 磁 盘 支持 


OSCache 


SwarmCache 集群 (IP 广播) 安全 (集群 无 效 ) 
JBons Cache 1.x | org hibemate.cache TrecCacheProvider 集群 (IP 广播) ， 事务 性 的 | 安全 (复制 ”| 支持 | 
JBoss Cache 2 。 | org.hibemate.cache jbcJBossCacheRegionFactory | 集群 (IP 广播 ， 事 务 性 的 “| 安全 (复制 ) 支持 | 


下 面 我 们 以 常见 的 EHCache 为 例 来 介绍 Hibernate 二 级 缓存 的 用 法 。 

(1) 在 hibernate.cfg.xml 文件 中 开启 二 级 缓存 。 需 要 做 两 件 事情 : @ 设置 启用 二 级 缓存 ，@ 设 
置 二 级 缓存 的 实现 类 。 

(2) 复制 二 级 缓存 的 JAR 包 。 将 Hibernate 项 目 路 径 下 的 libvoptional\ 下 的 对 应 缓存 的 JAR 包 复制 
到 应 用 的 类 加 载 路 径 中 。 例 如 对 于 EHCache， 则 应 该 复制 ehcache 子 目录 的 的 JAR 包 。 


六 
“ 带 - 注 意 :和 
实际 上 要 在 项 目 中 使 用 EHCache 缓存 实现 ,仅仅 复制 iib\optional\ 下 对 应 缓存 的 JAR 

包 还 不 够 。 因 为 EHCache 还 需要 依赖 于 commons-logging、backport-util-concurrent 两 个 
工具 ， 因 此 读者 需要 登录 http://commons.apache.org/logging/download_logging.cgi 下 载 | 
commons-logging 工具 包 ， 登 录 http://backport-jsr166.sourceforge.net/ 下 载 backport-util- 要 


(3) 将 缓存 实现 所 需要 的 配置 文件 添加 到 系统 的 类 加 载 路 径 中 。 对 于 EHCache 缓存 ， 它 需要 一 个 
ehcache.xml 配置 文件 (读者 可 以 在 Hibernate 发 行 包 的 projectvetc 路 径 下 找到 该 文件 的 示例 )， 读 者 将 
该 文件 复制 到 类 加 载 路 径 下 稍 作 修改 即 可 。 

本 应 用 所 使 用 的 ehcache.xml 文件 代码 如 下 。 

程序 清单 :codes\06\6.9\SecondCache\srcvehcache .xml 


<?xml version="1.0" encoding="GBK"?> 
<ehcache> 
<diskstore path="java.io.tmpdir"/> 
<defaultCache 
maxElementsIinMemory="10000" 
eternal="false" 
overflowToDisk="true" 
timeToIdleSeconds="120" 
timeToLiveSeconds="120" 
diskPersistent="false"/> 
</ehcache> 


上 面 的 配置 文件 中 各 属性 的 说 明 如 下 。 

> maxElementsiInMemory: 设置 缓存 中 最 多 可 放 多 少 个 对 象 。 

> ”eternal: 设置 缓存 是 否 永久 有 效 。 

> timeToldleSeconds: 设置 缓存 的 对 象 多 少 秒 没有 被 使 用 就 会 清理 掉 。 

> timeToLiveSeconds: 设置 缓存 的 对 象 在 过 期 之 前 可 以 缓存 多 少 秒 。 

> diskPersistent， 设置 缓存 是 否 被 持久 化 到 硬盘 中 ， 保 存 路 径 由 <diskStore.…/> 元 素 指定 。 

(4) 设置 对 哪些 实体 类 、 实 体 的 哪些 集合 属性 启用 二 级 缓存 。 这 一 步 有 两 种 方式 : 

> ”修改 要 使 用 缓存 的 实体 的 映射 文件 。 在 持久 化 映射 文件 的 <class.…/> 元 素 、 或 <set.../>、 
<list../> 等 集合 元 素 内 使 用 <cache.…/> 元 素 指定 缓存 策略 。 

> 在 hibernate.cfg.xml 文 件 中 使 用 <class-cache.../> 或 <collection-cache.../> 元 素 对 指定 持久 化 
类 、 集 合 属性 启用 二 级 缓存 。 

上 面 两 种 设置 方式 只 是 存在 形式 不 同 ， 本 质 是 完全 相同 的 。 
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习惯 上 ， 笔 者 更 喜欢 第 一 种 方式 。 在 这 种 方式 下 ， 不 同 实体 的 缓存 策略 放 在 不 同 的 映射 文件 中 管 
理 ， 更 符合 软件 工程 中 分 而 治之 的 策略 。 

本 应 用 所 使 用 的 News.hbm.xml 映射 文件 代码 如 下 。 

程序 清单 : codes\06\6.9\SecondCache\src\org\crazyit\app\domain\News.hbm.xml 


<?xml version="1.0" encoding="gb2312"?> 
<!-- 指定 Hiberante3 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate. sourceforge.net/hibernate-mapping-3.0.dtd"> 
<!-- hibernate-mapping 是 映射 文件 的 根 元 素 一 > 
<hibernate-mapping package="org.crazyit.app.domain"> 
<!-- 每 个 class 元 素 对 应 一 个 持久 化 对 象 --> 
<class name="News" table="news_inf"> 
<cache usage="read-only"/> 
<!-- id 元素 定义 持久 化 类 的 标识 属性 --> 
<id name="id" column="news_id"> 
<generator class="identity"/> 
</id> 
<!-~ property 元 素 定 义 常规 属性 --> 
<property name="title"/> 
<property name="content"/> 
</class> 
</hibernate-mapping> 


上 面 的 映射 文件 中 使 用 <cache... 人 > 元 素 指定 对 News 实体 启用 缓存 ， 而 且 设置 了 缓存 策略 是 
“read-only”。Hibernate 支持 的 缓存 策略 介绍 如 下 。 

> ”只 读 策 略 (read-only) : ”如 果 应 用 程序 只 需 读 取 持久 化 实体 的 对 象 ， 无 须 对 其 进行 修改 ， 

那么 就 可 以 对 其 设置 “只 读 ” 缓 存 策略 。 这 是 最 简单 、 也 最 实用 的 缓存 策略 。 

> 读 / 写 缓存 (read/write) : 如 果 应 用 程序 需要 更 新 数据 ， 那 就 需要 使 用 “ 读 / 写 ”缓存 策略 了 。 

如 果 应 用 程序 要 求 使 用 “序列 化 事务 (serializable transaction) ”的 隔离 级 别 ， 那 就 绝 不 能 
使 用 这 种 缓存 策略 。 
如 果 在 JTA 环境 中 使 用 缓存 ， 必 须 指定 hibernate.transaction.manager_lookup_class 属性 的 值 ， 
Hibernate 必须 通过 该 属性 才能 知道 该 应 用 程序 中 JTA 的 TransactionManager 策略 。 在 其 他 环境 中 ， 程 
序 必须 在 Session.close0、 或 Session.disconnect0 之 前 ， 结 束 整个 事务 。 
如 果 想 在 集群 环境 中 使 用 该 策略 ， 必 须 保证 底层 的 缓存 实现 支持 锁定 〈locking)。Hibernate 内 置 
的 缓存 策略 并 不 支持 锁定 功能 。 
> 非 严 格 读 / 写 (nonstrict read/write) : 如 果 应 用 程序 只 需要 偶尔 更 新 数据 (也 就 是 说 ， 两 个 
事务 同时 更 新 同一 记录 的 情况 很 少见 ) ， 也 不 需要 十 分 严格 的 事务 隔离 ， 那 么 比较 适合 使 用 
非 严格 读 / 写 缓存 策略 。 

> ”如 果 在 JTA 环境 中 使 用 该 策略 ， 必 须 指 定 hibernate transaction.manager_lookup_class 属 
性 的 值 ， 在 其 他 环境 中 ， 程 序 必须 在 Session.close() 或 Session.disconnect() 之 前 ， 结 束 整 
个 事务 。 

> 事务 缓存 (transactional) : Hibernate 的 事务 缓存 策略 提供 了 全 事务 的 缓存 支持 ， 例 如 对 
JBoss TreeCache 的 支持 。 这 样 的 缓存 只 能 在 JTA 环境 中 起 作用 ， 必 须 指定 
hibernate.transaction.manager_lookup_class 属性 的 值 。 

经 过 上 面 4 个 步骤 ， 接 下 来 就 可 以 在 应 用 程序 中 看 到 二 级 缓存 生效 了 ， 测 试 二 级 缓存 的 程序 片段 
如 下 。 

程序 清单 : codes\06\6.9\SecondCache\src\lee\NewsManagerjava 


// 测 试 二 级 缓存 
private void secondcacheTest() 
{ 
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Session session = sf.getCurrentSession()7 

session.beginTransaction()7 

List names = session.createQuery("from News newsn) 
list(); 

session.getTransaction() .commit (); 

System: out Println (or 仆人 pd 

// 打 开 第 二 个 Session 

Session sess2 = sf.getCurrentSsession(); 

sess2.beginTransaction ()7 

// 根 据 主键 加 载 实体 ， 系 统 将 直接 从 二 级 缓存 读 取 

// 因 此 不 会 发 出 查询 的 SQL 语句 

News news = (News) sess2.1oad (Mews.class , 1); 

System.out .println (news.getTitle()); 

sess2.getTransaction() .commit ();» 


i 

正如 以 上 程序 的 粗 体 字 代 码 所 示 ， 当 程序 执行 查询 获取 所 有 News 实体 之 后 ，SessionFactory 会 将 
这 些 实体 缓存 在 二 级 缓存 内 。 当 程序 的 粗 体 字 代码 根据 主键 加 载 特定 实体 时 〈 即 使 在 不 同 的 Session 
中 )，Hibernate 不 需要 去 查询 数据 库 ， 它 可 以 直接 使 用 缓存 中 已 有 的 实体 ， 因 此 粗 体 字 代码 不 会 发 出 
查询 用 的 SQL 语句 。 


> 6.9.2 管理 缓存 和 统计 缓存 


Session 级 别 的 一 级 缓存 是 局 部 缓存 ， 它 只 对 当前 Session 有 效 ; SessionFactory 级 别 的 二 级 缓存 是 
全 局 缓存 ， 它 对 所 有 的 Session 都 有 效 。 

对 于 Session 级 别 的 一 级 缓存 而 言 , 所 有 经 它 操作 的 实体 ,不 管 使 用 saveO .update0 或 saveOrUpdateO) 

保存 一 个 对 象 ， 还 是 使 用 load0、getO、list0、iterate0 或 scroll0 方 法 获得 一 个 对 象 时 ， 该 对 象 都 将 被 
放 入 Session 级 别 的 一 级 缓存 中 一 一 在 Session 调用 flush0 方 法 (该 方法 把 所 有 缓存 数据 一 次 性 fush 
到 数据 库 ) 或 close( 方 法 之 前 ， 这 些 对 象 将 一 直 缓存 在 一 级 缓存 中 。 
某 些 特殊 的 情况 下 ,例如 正在 处 理 一 个 大 对 象 ( 它 占用 的 内 存 开销 非常 大 )， 可 能 需要 从 一 级 组 
存 这 个 大 对 象 或 集合 属性 ， 可 以 调用 Session 的 evict(Object object) 方 法 ， 将 该 对 象 或 集合 从 一 
级 缓存 中 剔除 出 去 。 

例如 如 下 代码 片段 : 

ScrollableResult newsList = sess.createQuery("from News as news") 

Scroll (); 


while (newsList.next() ) { 
News news = (News) newsList.get (0); 


7/ 将 news 实体 从 Session 中 剔除 
sess.evict (news); 


} 


为 了 判断 某 个 对 象 是 否 处 于 Session 缓存 中 ， 可 以 借助 于 Session 提供 的 contains(Object object) 方 
法 ， 该 方法 返回 一 个 boolean 值 ， 用 于 标识 某 个 实例 是 否 处 于 当前 Session 的 缓存 中 。 
如 果 想 把 所 有 的 对 象 都 从 Session 缓存 中 彻底 清除 ， 调 用 Session 的 clear0 方 法 即 可 。 
类 似 地 ，Hibemate 同样 提供 了 方法 来 操作 SessionFactory 的 二 级 缓存 所 缓存 的 实体 。 
SessionFactory 提供 了 一 个 getCache0 方 法 ， 该 方法 的 返回 值 是 Cache 对 象 ， 通 过 该 对 象 即 可 操作 
二 级 缓存 中 的 实体 、 集 合 等 。 例 如 如 下 代码 片段 : 
Cache cache = sf.getCache(); 
// 清 除 指定 的 News 对 象 。 
cache.evict (News.class, id); //evict a particular Cat 
// 清 除 所 有 News 对 象 


cache.evict (News. class); 


// 清 除 指定 id 的 News 所 关联 的 参与 者 集合 属性 。 
cache.evictCollection ("News.actors", id); 


// 清 除 所 有 News 所 关联 的 参与 者 集合 属性 。 
S515 


://52pdf.taob: 
区 量 银 Java EE 企业 应 用 实战 (第 3 臧 ) 


cache.evictCollection("Cat.kittens"); 


为 了 更 好 地 统计 二 级 缓存 〈 包 括 后 面 介 绍 的 查询 缓存 ) 中 的 内 容 ， 可 以 借助 于 Hibernate 的 统计 
(Statistics) API。 
为 了 开启 二 级 缓存 的 统计 功能 ， 也 需要 在 hibemate.cfg.xml 文件 中 进行 配置 。 例 如 在 
hibernate.cfg.xml 文件 中 增加 如 下 配置 片段 : 
<!-- 开启 二 级 缓存 的 统计 功能 --> 


<property name="hibernate.generate_statistics">true</Property> 
<!-- 设置 使 用 结构 化 方式 来 维护 缓存 项 一 > 


<property name="hibernate.cache.use_structured_ entries">true</property> 
接 下 来 即 可 通过 如 下 方式 来 查看 二 级 缓存 的 内 容 。 

程序 清单 : codes\06\6.9\SecondCache\src\lee\NewsManagerjava 

private void stat() 


ge 
缓存 的 名 字 默 认 与 持久 化 类 的 类 名 相同 
.getSecondLevelCacheStatistics ("org. crazyit.app. domain.News") 
.getEntries(); 
System.out.println (cacheEntries); 


} 


例如 同时 运行 上 面 的 secondCacheTest()、stat0 两 个 方法 ， 将 可 以 看 到 如 图 6.13 所 示 效 果 。 


Hibernate. 
select 
news0_. news_id as newsl_0_, J 
news0_. title as title0_, 
new30_, content as content0_ 
from 
news_inf news0, 
一 这 忆 寻 从 二 加入 吕 ,无 时 5QL 汪 名 


颌 狂 Java 联 盟 成 立 了 ， 网 址 是 www. crazyit. org， 


version=null 
，_lazyPropertiesUnfetched=true，_subclass=org. crazyit, app. d 

等 到 堵 一 天 ， 四 间 一 下 光亮 了 ， 空 气 中 配 酸 着 自 由 、 民 主 的 芬芳 
，-version=null，title= 天 快 充 了 , lazyPropertiestnfetched=true, 


subclass=org. 
razyit. app. domain News)} 


4 
图 6.13 ”统计 二 级 缓存 
上 面 的 程序 只 是 打印 了 二 级 缓存 中 的 内 容 ， 实 际 上 ，sfgetStatistics().getSecondLevelCacheStatistics 


(实体 类 ) 方 法 返回 一 个 SecondLevelCacheStatistics 对 象 , 该 对 象 提供 了 一 些 工 具 方法 来 分 析 二 级 缓存 的 
缓存 效果 ， 具 体 方法 请 参考 Hibernate API。 


>》>6.9.3 使 用 查询 缓存 


-级 、 二 级 缓存 都 是 对 整个 实体 进行 缓存 ， 它 不 会 缓存 普通 属性 ， 如 果 想 对 普通 属性 进行 缓存 ， 
则 可 以 考虑 使 用 查询 缓存 。 


-三 -注意 : 


需要 指出 的 是 ， 大 部 分 情况 下 查询 缓存 并 不 能 提高 应 用 性 能 ， 甚 至 反而 会 降低 应 用 
性 能 ， 因 此 实际 项 目 中 请 愤 重 使 用 查询 缓存 . 


对 于 查询 缓存 来 说 ， 它 缓存 的 key 就 是 查询 所 用 的 HQL 或 SQL 语句 ， 需 要 指出 的 是 : 查询 缓存 


不 仅 要 求 所 使 用 的 HQL 语句 、SQL 语句 相同 ， 甚 至 要 求 所 传 入 的 参数 也 相同 ，Hibernate 才能 直接 从 
查询 缓存 中 取得 数据 。 
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rh 


-三 - 注意 :一 
只 有 经 常 使 用 相同 的 查询 语句 、 并 且 使 用 相同 查询 参数 才能 通过 查询 缓存 获得 好 处 ， 
查询 缓存 的 生命 周期 直到 属性 被 修改 了 为 止 


查询 缓存 默认 也 是 关闭 的 ， 为 了 开启 查询 缓存 ， 必 须 在 hibernate.cfeg.xml 文件 中 增加 如 下 配置 : 
启用 查询 缓存 --> 

<property name="hibernate.cache.use_query_cache">true</property> 

除 此 之 外 ,还 必须 在 调用 Query 对 象 的 setCacheable(true) 才 会 对 查询 结果 进行 缓存 。 看 如 下 程序 。 
程序 清单 : codes\06\6.9\QueryCache'\src\lee\NewsManagerjava 


public class NewsManager 
{ 


static Configuration conf = new Configuration() 
configure(); 

// 以 Configuration 创建 SessionFactory 

static SessionFactory conf.buildsessionFactory(); 

public static void main(String[] args) throws Exception 

‘ 


NewsManager mgr = new NewsManager(); 
mgr.noCacheQuery (); 
1/ mgr.cacheQuery (); 
mgr.stat()} 
} 
private void noCacheQuery() 
{ 


Session session = sf.getCurrentSession(); 

session.beginTransaction(); 

List titles = session.createQuery("select news.title from News news") 
// 其 实 无 须 设置 ， 默 认 就 是 关闭 缓存 的 

tCacheable (false) 


"list()} 
for (Object title : titles) 
{ 


System.out.println (title)7 
} 
System,out .println("----—-- 
// 第 二 次 查询 ， 因 为 没有 使 用 查询 缓存 ， 因 此 会 重新 发 出 SQL 语句 进行 查询 
titles = session.createQuery("select news.title from News news") 
// 其 实 无 须 设置 ， 默 认 就 是 关闭 缓存 的 
-setCacheable (false) 
"list();» 
for (Object title : titles) 
Y 


System.out.printin(title); 
} 
session.getTransaction() .commit (); 
} 
private void cacheQuery() 
{ 
Session session = sf.getCurrentSession(); 
session.beginTransaction(); 
List titles = session.createQuery("select néws.title from News news") 


7/ 开启 查询 缓存 
setCacheable 


-list()» 
for(Object title : titles) 
{ 


(true) 


System.out.println (title); 

】 

Session.getTransaction() .commit (); 
System.out .printin( 
Session sess2 = sf.getCurrentSession(); 
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sess2.beginTransaction (); 

// 第 二 次 查询 ， 使 用 查询 缓存 ， 因 此 不 会 重新 发 出 SQL 语句 进行 查询 

titles = sess2.createQuery("select news.title from News news") 
// 开 启 查 询 缓存 
.setCacheable (true) 
list(); 

forlObject title : titles) 

{ 


System.out.println (title); 
1 
sess2.getTransaction() .commit (); 


} 
// 开 启 查询 缓存 ， 但 使 用 iterate() 方 法 查询 
public static void cacheQueryIterator () 
Session session = sf.getCurrentSsession(); 
session.beginTransaction()7 
Tterator it = session.createQuery("select news.title from News news") 
// 开 启 查询 缓存 
.setCacheable (true) 
.iterate(); 
while (it.hasNext ()) 
{ 


System.out .println (it.next ()); 
} 
session.getTransaction () .commit 
System.out .println("-—--—------ 
Session sess2 ~ sf,getCurrentsession(); 
sess2.beginTransaction ()7 
// 第 二 次 查询 ， 使 用 查询 缓存 ， 因 此 不 会 重新 发 出 SQL 语句 进行 查询 
it = sess2.createQuery("select news.title from News news") 
// 开 启 查 询 缓存 
.setCacheable (true) 
.iterate(); 
while (it.hasNext ()) 
{ 


System.out.println(it.next ()); 
} 
sess2.getTransaction() .commit (); 

} 

private void stat() 


long hitCount = sf.getStatistics() 
// 查 询 缓存 的 名 字 与 HQL 语句 或 SQL 语句 相同 
.getQueryStatistics ("select news.title from News news") 
.getCacheHitCount (); 
System.out .println ("查询 缓存 命中 的 次 数 : "+ hitCount); 
1 
1 


上 面 的 程序 进行 了 三 次 查询 。 
> 第 一 次 : 没有 对 查询 结果 进行 缓存 ， 查 询 缓存 不 会 起 作用 。 
> 第 二 次 : 设置 对 查询 结果 进行 缓存 ， 在 第 二 个 Session 中 进行 的 查询 将 不 会 发 出 SQL 语句 。 
直接 从 查询 缓存 中 读 取 数 据 。 
> ”第 三 次 : 用 于 查询 使 用 了 iterator() 方 法 获取 结果 。 因 此 查询 缓存 也 不 会 起 作用 。 
上 面 的 程序 也 对 查询 缓存 进行 了 统计 ， 统 计 了 查询 缓存 命中 〈 无 须 读 取 数据 库 ， 直 接 从 缓存 中 读 
取 数 据 ) 的 次 数 。 如 果 程 序 对 第 二 次 查询 进行 统计 ， 将 发 现 命中 次 数 为 1， 这 也 说 明 查 询 缓存 生效 了 。 


6.10 ”事件 机 制 


通常 ，Hibemate 执行 持久 化 过 程 中 ， 应 用 程序 无 法 参与 其 中 。 所 有 的 数据 持久 化 操作 ， 对 用 户 都 
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是 透明 的 ， 用 户 无 法 插入 自己 的 动作 。 

通过 事件 框架 ，Hibernate 允许 应 用 程序 能 响应 特定 的 内 部 事件 ， 从 而 允许 实现 某 些 通 用 的 功能 ， 
或 者 对 Hibernate 功能 进行 扩展 。 

Hibernate 的 事件 框架 由 两 个 部 分 组 成 。 

> ”拦截 器 机 制 ， 对 于 特定 动作 拦截 ， 回 调 应 用 中 的 特定 动作 。 

> 事件 系统 重 写 Hibernate 的 事件 监听 器 。 


>>6.10.1 拦截 器 


通过 Interceptor 接口 , 可 以 从 Session 中 回调 应 用 程序 的 特定 方法 , 这 种 回调 机 制 可 让 应 用 程序 在 
持久 化 对 象 被 保存 、 更 新 、 删 除 或 加 载 之 前 ， 检 查 并 修改 其 属性 。 
通过 Interceptor 接口 ， 可 以 在 数据 进入 数据 库 之 前 ， 对 数据 进行 最 后 的 检查 ， 如 果 数据 不 符合 要 
求 ， 可 以 修改 数据 ， 从 而 避免 非法 数据 进 和 数据库。 当然， 通常 无 须 这 样 做， 只 是 在 某 些 特殊 的 场合 
下 ， 才 考虑 使 用 拦截 器 完成 检查 功能 。 
使 用 拦截 器 按 如 下 步骤 进行 : 
人 定义 实现 Interceptor 接口 的 拦截 器 类 。 
@ 通过 Session 启用 拦截 器 ， 或 者 通过 Configuration 启用 全 局 拦截 器 。 
程序 可 以 通过 实现 Interceptor 接口 来 创建 拦截 器 , 也 可 以 (最 好 ) 继承 EmptyInterceptor 来 实现 拦 
截 器 。EmptyInterceptor 和 Interceptor 的 关系 就 像 事件 监听 器 和 事件 适配器 的 关系 。 
下 面 是 一 个 拦截 器 的 示例 代码 ， 该 拦截 器 没有 进行 任何 实际 的 操作 ， 仅 仅 打印 出 标志 代码 。 
程序 清单 :codes\06\6.10\Interceptor\src\org\crazyit\common\hibernate3\interceptor\MyInterceptor.java 
// 通 常 采用 采用 继承 EmptyInterceptor 来 实现 拦截 器 
public class MyInterceptor extends EmptyInterceptor 


{ 
// 记 录 修 改 次 数 
private int updates; 
// 记 录 创建 次 数 


private int creates; 


// 当 删除 实体 时 ，onDelete 方法 将 被 调用 

public void onDelete (Object entity , Serializable id , 
Object[] state , String[] propertyNames , Typel[] types) 
// do nothing 


} 

// 当 把 持久 化 实体 的 状态 同步 到 数据 库 时 ，onFlushDirty 方法 被 调用 

public boolean onFlushDirty (Object entity , Serializable id, 
Object[] currentstate, Object[] previousState, 
String[] propertyNames, Typel[l] types) 


7/ 每 同步 一 次 ， 修 改 的 累加 器 加 1 

updatest+; 

for ( int i = 0; i < propertyNames.length; i++ ) 
{ 


{ 


if ( "lastUpdateTimestamp".equals( propertyNames[i] ) ) 
{ 
CurrentState[i] = new Date(); 
return true; 
} 
return false; 


} 

// 当 加 载 持久 化 实体 时 ，onLoad 方法 被 调用 

Ppublic boolean onLoad(Object entity , Serializable id ， 
Object[] state,String[] propertyNames,Type[] types) 

{ 
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for ( int i1 = 0; i < propertyNames.length ; i++ } 
{ 
if ( "name".equals( propertyNames[i] ) ) 


{ 
// 输 出 被 装载 实体 的 name 属性 值 
System-out-Println( statefi] ); 
return true; 
1 
} 


return false; 


让 
// 保 存 持久 化 实例 的 时 候 ， 调 用 该 方法 
public boolean onSave(Object entity , Serializable id ， 
Object[] state, String[] propertyNames,Type[] types) 
{ 
createst+; 
for ( int i = 0; i < propertyNames.length; i++ ) 
{ 
if ("createTimestamp".equals( propertyNames{i])) 
{ 
state[i] = new Date(); 
return true; 
} 
} 


return false; 


} 
// 持 久 化 所 做 修改 同步 完成 后 ， 调 用 postFlush 方法 
public void postFlush(Iterator entities) 


{ 
System.out .PrintIn(" 创 建 的 次 数 ， " 
+ creates +“"， 更 新 的 次 数 : ”+ updates); 


} 
// 在 同步 持久 化 所 做 修改 之 前 ， 调 用 preFlush 方法 
public void preFlush(Iterator entities) 
{ 

// do nothing 


} 
// 事 务 提交 之 前 触发 该 方法 
public void beforeTransactionCompletion (Transaction tx) 


{ 
System.out.println ("事务 即将 结束 "); 


) 
// 事 务 提交 之 后 触发 该 方法 
Public void afterTransactionCompletion (Transaction tx) 


{ 
System.out .println ("事务 已经 结束 ") ; 
) 


:上面 的 拦截 器 实现 类 中 ,实现 了 很 多 方法 ， 这 些 方法 都 将 在 Hibernate 执行 特定 动作 时 自动 被 调用 。 
完成 了 拦截 器 的 定义 ， 下 面 是 关于 拦截 器 的 使 用 。 拦 截 器 的 使 用 有 两 种 方法 : 
> 通过 SessionFactory 的 openSession(Interceptor in) 方 法 打开 一 个 带 局 部 拦截 器 的 Session。 
> ”通过 Configuration 的 setinterceptor(Interceptor in) 方 法 设置 全 局 拦截 器 。 
下 面 是 使 用 全 局 拦截 器 的 示例 代码 。 
程序 清单 : codes\06\6.10\Interceptor\src\lee\UserManagerjava 
public class UserManager 
static Configuration cfg = new Configuration() 
// 加 载 hibernate.cfg.xml 配置 文件 
.configure() 
// 设 置 启用 全 局 拦 蕉 器 
.setInterceptor (new MyInterceptor ()); 
static SessionFactory sf = cfg.buildsessionFactory(); 
Public static void main(String[] args) 
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下 
UserManager mgr = new UserManager()7 
mgr .testUser{) 7 
sf.close(); 

} 

private void testUser() 


Session session = sf.getCurrentSession(); 
Transaction tx = session.beginTransaction(); 
// 创 建 一 个 User 对 象 
User ul = new User(); 
bu1.setName ("Yeeku.Lee"); 
u1,setAge(30); 
ul.setNationality ("china"); 
session.save (ul); 
User u = (User)session.load(User.class , 1); 
u.setName ("李刚 "); 
tx.commit () 
} 
} 


上 面 的 程序 通过 Configuration 创建 了 一 个 SessionFactory 对 象 ,程序 的 粗 体 字 代码 为 Configuration 
对 象 设置 启用 全 局 拦截 器 ， 这 样 由 该 SessionFactory 所 创建 的 所 有 Session 都 会 启用 该 拦截 器 。 
当主 程序 按 普通 方法 保存 持久 化 对 象 、 修 改 持久 化 对 象 时 ， 将 可 以 看 到 拦截 器 会 发 生 作用 。 


>>6.10.2 事件 系统 


Hibemnate 3 的 事件 系统 是 功能 更 强大 的 事件 框架 ， 事 件 系统 可 以 替代 拦截 器 ， 也 可 以 作为 拦截 器 
的 补充 来 使 用 。 

基本 上 ，Session 接口 的 每 个 方法 都 有 对 应 的 事件 ， 比 如 LoadEvent、FlushEvent 等 。 当 Session 
调用 某 个 方法 时 ，Hibernate Session 会 生成 对 应 的 事件 ， 并 激活 对 应 的 事件 监听 器 。 

系统 默认 监听 器 实现 的 处 理 过 程 ， 完 成 了 所 有 的 数据 持久 化 操作 ， 包 括 插入 、 修 改 等 操作 。 如 果 
用 户 自己 定义 了 自己 的 监听 器 ， 则 意味 着 用 户 必须 完成 对 象 的 持久 化 操作 。 

例如 : 可 以 在 系统 中 实现 并 注册 LoadEventListener 监听 器 , 该 监听 器 负责 处 理 所 有 的 调用 Session 
的 load() 方 法 的 请 求 。 

监听 器 是 单 例 模式 对 象 ， 即 所 有 同类 型 的 事件 处 理 共享 同一 个 监听 器 实例 ， 因 此 监听 器 不 应 该 保 
存 任何 状态 ， 即 不 应 该 使 用 成 员 变量 。 

使 用 事件 系统 按 如 下 步骤 进行 : 

人 G 实现 自己 的 事件 监听 器 类 。 

人 @ 注册 自 定义 事件 监听 器 ， 代 赫 系统 默认 的 事件 监听 器 。 

实现 用 户 的 自 定义 监听 器 有 如 下 三 种 方法 。 

> ”实现 对 应 的 监听 器 接口 ， 实 现 接口 必须 实现 接口 内 的 所 有 方法 ， 关 键 是 必须 实现 Hibernate 

对 应 的 持久 化 操作 ， 即 数据 库 访问 ， 这 意味 着 程序 员 完 全 取代 了 Hibernate 的 底层 操作 。 
> ”继承 事件 适配器 : 可 以 选择 性 地 实现 需要 关注 的 方法 ， 但 依然 试图 取代 Hibernate 完成 数据 
库 的 访问 。 

> ”继承 系统 默认 的 事件 监听 器 : 扩展 特定 方法 。 

实际 上 , 第 一 种 方法 很 少 使 用 。 Hibernate 的 持久 化 操作 也 是 通过 这 些 监 听 器 实现 的 ， 如 果 用 
户 取代 了 这 些 监 听 器 ， 则 应 该 自己 实现 所 有 的 持久 化 操作 ， 这 意味 着 : 用 户 放弃 了 Hibernate 的 持久 化 
操作 ， 而 改 为 自己 完成 Hibernate 的 核心 操作 。 

通常 推荐 采用 第 三 种 方法 实现 自己 的 事件 监听 器 。Hibemnate 默认 的 事件 监听 器 都 被 声明 成 
non-final， 从 而 方便 用 户 继承 。 
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下 面 是 用 户 自 定义 监听 器 的 示例 。 
程序 清单 : codes\06\6.10\EventFrame\src\org\crazyit\common\hibernate3\MyLoadListenerjava 


public class MyLoadListener extends DefaultLoadEventListener 
{ 
// 在 LoadEventListener 接口 仅仅 定义 了 这 个 方法 
public void onLoad (LoadEvent event, 
LoadEventListener.LoadType loadType) 
throws HibernateException 
{ 
System.out .println(" 自 定义 的 load 事件 ") ; 
System.out.println (event .getEntityClassName () 
+ "==========" + event.getEntityId()); 
super.onLoad (event, loadType); 
} 
) 


下 面 还 有 一 个 MySaveListener， 用 于 监听 SaveEvent 事件 。 
程序 清单 :codes\06\6.10\EventFrame\src\org\crazyit\common\hibernate3\MySaveListener.java 


public class MySaveListener extends DefaultSaveEventListener 

{ 
Protected Serializable performSaveOrUpdate (SaveOrUpdateEvent event) 
{ 


System.out .println(" 自 定义 的 save 事件 ") ; 
System.out .println(event.getObject ()); 
return super.performSaveorUpdate (event); 
} 
' 


he 
闪 . 注 意 : … 
扩展 用 户 自 定义 监听 器 时 ， 别 忘 了 在 方法 中 调用 父 类 的 对 应 方法 ， 否 则 Hibernate 3 要 


默认 的 持久 化 行为 都 会 失效 。 因 为 这 些 持久 化 行为 本 身 就 是 通过 拦截 器 来 完成 


注册 用 户 自 定义 监听 器 也 有 两 种 方法 。 

> ”编程 式 ， 通 过 使 用 Configuration 对 象 来 编程 注册 。 

> ”声明 式 : 在 Hibernate 的 XML 格式 的 配置 文件 中 进行 声明 , 使 用 Properties 格式 的 配置 文件 
将 无 法 配置 自 定义 监听 器 。 

下 面 的 代码 片段 示范 了 通过 编程 的 方式 使 用 自 定义 监听 器 。 


// 采 用 默认 的 hibernate .cfg.xml 来 启动 一 个 Configuration 的 实例 
Configuration conf = new Configuration() 
"configure(); 
// 为 10ad 事件 设置 监听 器 
conf .setLiatener ("load" , "org.crazyit.common.hibernate3.MyLoadListener") ; 
// 为 save 事件 设置 监听 器 
conf.setListener ("save" , "org.crazyit.common.hibernate3.MySaveListener") ; 
// 由 conf 实例 来 创建 一 个 SessionFactory 实例 
sessionFactory = conf.buildSessionFactory(); 


Configuration 对 象 提供 了 setListener(String type, Object listener)、setListener(String type, String 
listener) 两 个 方法 为 指定 事件 设置 单个 监听 器 ， 也 提供 了 setListeners(String type，Object[] listeners) 和 
setListeners(String type, String[] listenerClasses) 两 个 方法 为 指定 事件 设置 多 个 监听 器 (多 个 监听 器 组 成 
监听 器 栈 )。 

那么 Hibemate 到 底 支持 哪些 事件 呢 ? 打开 Hibemate 源 代码 srcvorg\hibernatevevent 路 径 下 的 
EventListeners.java 文件 ， 在 该 文件 中 看 到 如 下 代码 片段: 


static { 
eventInterfaceFromType = new HashMap(); 
eventInterfaceFromType.put ("auto-flush" 
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, AutoFlushEventListener.class); 
eventInterfaceFromType.put ("merge™ 

, MergeEventListener.class); 
eventInterfaceFromType.put ("create" 

, PersistEventListener.class); 
eventInterfaceFromType.put ("create-onflush" 

, PersistEventListener.class); 
eventInterfaceFromType.put ("delete" 

， DeleteEventListener.class); 
eventInterfaceFromType,put ("dirty-check" 

, DirtyCheckEventListener.class) 
eventInterfaceFromType.put ("evict™ 

, EvictEventListener.class); 
eventInterfaceFromType.put ("flush" 

, FlushEventListener.class); 
eventInterfaceFromType.put ("flush-entity" 

， FlushEntityEventListener.class); 
eventInterfaceFromType.put ("load" 

, LoadEventListener.class) 
eventInterfaceFromType.put ("load-collection™" 

, InitializeCollectionEventListener.class); 
eventInterfaceFromType.put ("lock" 

, LockEventListener.class 
eventInterfaceFromType.put ("refresh" 

, RefreshEventListener.class); 
eventInterfaceFromType.put ("replicate" 

,1 ReplicateEventListener.class) 
eventInterfaceFromType.put ("save-update" 

, SaveOrUpdateEventListener.class); 
eventInterfaceFromType.put ("save" 

, SaveOrUpdateEventListener.class); 
eventInterfaceFromType.put ("update”" 

， SaveOrUpdateEventListener.class); 
eventInterfaceFromType.put ("pre-load' 

, PreLoadEventListener.cl. 
eventInterfaceFromType.put ("pre-update" 

， PreUpdateEventListener.class); 
eventInterfaceFromType.put ("pre-delete" 

, PreDeleteEventListener.class); 
eventInterfaceFromType.put ("pre-insert” 

, PreInsertEventListener.class); 
eventInterfaceFromType.put ("pre-collection-recreate" 

, PreCollectionRecreateEventListener,class); 
eventInterfaceFromType.put ("pre-collection-remove" 

,1 PreCollectionRemoveEventListener.class); 
eventInterfaceFromType.put ("pre-collection-update" 

, PreCollectionUpdateEventListener.class); 
eventInterfaceFromType.put ("post-load" 

, PostLoadEventListener.class); 
eventInterfaceFromType.put ("post-update" 

, PostUpdateEventListener.class); 
eventInterfaceFromType.put ("post-delete" 

, PostDeletepventListener.class); 
eventInterfaceFromType.put ("post-insert" 

, PostInsertEventListener.class); 
eventInterfaceFromType.put ("post-commit-update" 

, PostUpdateEventListener.class); 
eventInterfaceFromType. put ("post-commit-delete™ 

， PostDeleteEventListener.class); 
eventInterfaceFromType.put ("post-commit-insert" 

， PostInsertEventListener.class); 
eventInterfaceFromType.put ("post-collection-recreate" 

， PostCollectionRecreateEventListener.class); 
eventInterfaceFromType.put ("post-collection-remove" 

， PostCollectionRemoveEventListener.class); 
eventInterfaceFromType.put ("post-collection-update" 

, PostCollectionUpdateEventListener.class); 
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eventInterfaceFromType = Collections.unmodifiableMap{ eventInterfaceFromType ); 
} 
上 面 的 程序 中 HashMap 的 key 全 部 都 是 Hibemate 所 支持 的 事件 类 型 。 
如 果 不 想 记 住 Hibernate 所 支持 的 这 些 事件 类 型 ， 也 可 以 调用 如 下 代码 片段 来 设置 事件 监听 器 。 


Configuration cfg = new Configuration(); 


// 创 建 一 个 事件 监听 器 栈 


// 调 用 EventListeners 的 setLoadEventListensue 设置 多 个 事件 监听 器 
cfg.getEventListeners () .setLoadEventListeners (stack) ; 


在 上 面 的 程序 中 先 使 用 了 Configuration 的 getEventListeners0 方 法 返回 其 关联 的 EventListeners 对 
象 ， 该 对 象 提供 了 多 个 setXxxEventListeners0 方 法 为 不 同事 件 指定 多 个 事件 监听 器 。 
如 果 不 想 修 改 代 码 ， 也 可 以 在 配置 文件 中 使 用 事件 监听 器 。 注 册 事 件 监 听 器 使 用 <listener..…/> 元 素 


即 可 ， 该 元 素 可 以 接受 两 个 参数 : 

> ”type: 指定 该 事件 监听 器 所 监听 的 事件 类 型 。 

> class: 指定 事件 监听 器 的 实现 类 。 

注册 事件 监听 器 的 Hibernate 配置 文件 代码 如 下 。 

程序 清单 :codes\06\6.10\EventFrame\src\hibernate.cfg.xml 

<?xml version="1.0" encoding="GBK"?> 

<!-- 指定 Hibernate 配置 文件 的 DTD 信息 --> 

<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://wuw.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> 

<!-- hibernate- configuration 是 连接 配置 文件 的 根 元 素 --> 

<hibernate-configuration> 
<session-factory> 


<!-~ 省 略 其 他 常用 属性 设置 --> 


<!-- 根据 需要 自动 创建 数据 库 --> 

"hbm2ddl .auto">update</property> 
<!-- 显示 Hibernate 持久 化 操作 所 生成 的 SQL --> 
<property name="show_sql">true</property> 


<!-- 将 SQL 脚本 进行 格式 化 后 再 输出 一 > 
<property name="hibernate.format_sql">true</property> 


<!-- 指定 根据 当前 线程 来 界定 上 下 文 相关 Session ~-> 
<property name="hibernate.current_session_context_class">thread</property> 


<!-- 罗列 所 有 的 映射 文件 --> 
<mapping resource="User.hbm.xml"/> 


<!-- 注册 事件 监听 器 --> 
<listener type="load" class="org.crazyit.common.hibernate3.MyLoadListener"/> 
<listener type-"save" class="org,crazyit.common.hibernate3,MySaveListener"/> 


</session-factory> 
</hibernate-configuration> 


使 用 配置 文件 注册 事件 监听 器 虽然 方便 ， 但 也 有 不 利之 处 : 通过 配置 文件 注册 的 监听 器 不 能 共 训 
实例 。 如 果 多 个 <listener… 信 元 素 中 使 用 了 相同 的 类 ， 则 每 一 个 引用 都 将 产生 一 个 新 拦截 器 实例 。 如 果 
需要 在 多 个 事件 之 间 共享 监听 器 的 实例 ， 则 推荐 使 用 编程 式 方式 注册 事件 监听 器 。 

如 果 需 要 为 指定 事件 配置 多 个 事件 监听 器 ， 则 不 能 直接 使 用 <listener.. 人 > 元素 配 置 事件 监听 器 ， 而 
应 该 改 为 使 用 <event.… 人 元素， 该 元 素 能 接受 一 个 type 属性 ， 用 于 指定 多 个 事件 监听 器 所 监听 的 事件 
类 型 。 在 <event..… 记 元素 里 使 用 多 个 <listener.…./> 子 元 素来 指定 多 个 事件 监听 器 。 配 置 片段 如 下 : 


<!-- 为 oad 事件 配置 多 个 事件 监听 器 一 > 


<event type="load"> 
<listener class="org.crazyit.common.hibernate3.MyLoadListener"/> 
<listener class="org.crazyit.common.hibernate3.DefaultLoadEventListener"/> 


</event> 
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虽然 监听 器 类 实现 了 特定 监听 器 的 接口 ， 在 注册 的 时 候 还 要 明确 指出 注册 的 事件 。 
这 是 因为 一 个 类 可 能 实现 多 个 监听 器 的 接口 ， 注 册 时 明确 指定 要 监听 的 事件 ， 可 以 使 得 
启用 或 者 禁用 某 个 事件 的 监听 的 配置 工作 更 简单 


6.11 本 章 小 结 


本 章 继续 介绍 了 Hibernate 的 高 级 应 用 部 分 ， 包 括 Hibernate 所 支持 的 关联 映射 策略 、 继 承 映射 策 
略 ， 以 及 批量 操作 的 处 理 策略 。 本 章 详 细 介绍 了 Hibernate 强大 的 查询 体系 ， 包 括 HQL 查询 、SQL 查 
询 、 条 件 查询 和 数据 过 滤 等 。 重 点 介绍 了 Hibernate 所 提供 的 HQL 查询 ， 包 括 HQL 查询 的 各 种 常规 
知识 点 ， 还 有 Hibermate 3.2.3 对 隐 式 关联 的 改变 。 本 章 也 通过 示例 讲解 了 Hibernate 的 条 件 查询 ， 包 括 
离线 查询 和 子 查询 等 深入 内 容 ， 介 绍 原生 SQL 查询 时 也 包括 了 使 用 命名 SQL 查询 调用 存储 过 程 的 用 
法 ， 知 识 点 非常 全 面 。 

本 章 还 详细 介绍 了 事务 和 Session, 并 讲解 了 Hibernate 的 上 下 文 相关 Session 支持 、Hibernate 的 事 
务 策略 等 。 为 了 在 实际 应 用 中 提高 Hibernate 持久 化 访问 的 性 能 ， 本 章 也 详细 讲解 了 Hibernate 二 级 组 
存 、 查 询 缓存 的 配置 和 使 用 。 最 后 介绍 了 Hibernate 的 事件 框架 和 拦截 器 ， 这 些 是 Hibernate 重要 的 扩 
展 机 制 。 
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第 7 章 
Spring 的 基本 用 法 


本 章 要 点 


3aSpring 的 起 源 和 背景 
节 如 何在 项 目 中 使 用 Spring 框架 


入 理解 Spring 容器 中 的 Bean 

芭 管 理 容器 中 的 Bean 及 其 依赖 注入 
节 自 动 装配 

节 使 用 Java 类 进行 配置 管理 

切 使 用 静态 工厂 、 实 例 工厂 创建 Bean 实例 
芝 抽 象 Bean 与 子 Bean 

妆容 器 中 的 工厂 Bean 

节 管 理 Bean 的 生命 周期 

基 几 种 特殊 的 依赖 注入 

和 Spring 的 简化 配置 

节 SpEL 的 功能 和 用 法 
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经 常 与 一 些 项 目 经 理 、 技 术 总 监 谈 起 项 目 中 是 否 使 用 了 Spring， 可 能 有 一 些 人 会 说 ， 他 们 不 太 喜 
欢 “ 赶 时 浇 ”， 虽 然 Spring 很 流行 ， 但 他 们 的 项 目 中 依然 没有 使 用 Spring。 他 们 都 有 多 年 项 目 经 验 ， 
也 确实 主持 开发 过 一 些 大 型 项 目 ， 所 以 我 问 他 们 ， 应 用 中 各 组 件 以 怎样 的 方式 耦合 ? 他 们 的 答案 很 统 
一 : 通常 都 是 工厂 模式 、 服 务 定位 器 模式 等 。 我 就 会 说 , 你 们 没有 使 用 Spring, 但 你 们 自己 实现 了 Spring 
的 部 分 功能 一 一 也 就 是 说 ， 他 们 使 用 “Spring"， 只 是 这 个 “Spring” 是 他 们 自己 实现 的 ， 当 然 只 是 
Spring 的 部 分 功能 。 

Spring 就 是 这 样 一 个 框架 ;你 可 以 选择 不 使 用 这 个 框架 ， 但 你 的 开发 架构 一 定 会 暗合 它 的 思想 。 
对 于 一 个 多 年 开发 经 验 的 人 而 言 ， 可 能 非常 熟悉 Spring 的 很 多 思想 、 模 式 一 一 甚至 会 想 ; 我 就 是 这 么 
做 的 ! 没 错 ，Spring 是 一 个 很 普通 但 很 实用 的 框架 。 它 提取 了 大 量 实际 开发 中 需要 重复 解决 的 步骤 ， 
将 这 些 步骤 抽象 成 一 个 框架 。 


7.1 Spring 简介 和 Spring 3.0 的 变化 


Spring 框架 由 Rod Johnson 开发 ，2003 年 发 布 了 Spring 框架 的 第 一 个 版 本 。 经 过 长 达 7 年 多 的 发 
展 ，Spring 已 经 发 展 成 Java EE 开发 中 最 重要 的 框架 之 一 。 对 于 一 个 Java 开发 者 来 说 ，Spring 已 经 成 
为 必须 掌握 的 技能 。 就 如 笔者 在 教学 过 程 中 所 说 的 ，Spring 其 实 是 “大 路 货 ” 了 ， 现 在 每 个 搞 Java 开 
发 的 都 会 。 

不 仅 如 此 , 围绕 Spring、 以 Spring 为 核心 还 衍生 出 了 系列 框架 ,如 Spring Web Flow Spring Security、 
Spring Android…… 等 〈 具 体 请 登录 Spring 官方 网 站 : www.springsource.org)，Spring 越 来 越 强大 ， 带 
给 开发 者 越 来 越 多 的 便捷 。 本 书 所 介绍 的 是 Spring 框架 本 身 。 


>>7.1.1 Spring 简介 


Spring 是 一 个 从 实际 开发 中 抽取 出 来 的 框架 ， 因 此 它 完成 了 大 量 开发 中 通用 步骤 ， 留 给 开发 者 的 
仅仅 是 与 特定 应 用 相关 的 部 分 ， 从 而 大 大 提高 企业 应 用 的 开发 效率 。Spring 提供 了 一 种 Template 的 设 
计 哲 学 ， 这 些 Template 完成 了 大 量 的 通用 步骤 ， 如 果 开 发 者 使 用 这 些 Template， 则 无 须 自己 实现 那些 
通用 步 又 。 
Spring 为 企业 应 用 的 开发 提供 一 个 轻 量 级 的 解决 方案 。 该 解决 方案 包括 : 基于 依赖 注入 的 核心 机 
制 , 基于 AOP 的 声明 式 事务 管理 , 与 多 种 持久 层 技术 的 整合 ,以 及 优秀 的 的 Web MVC 框架 等 。 Spring 
致力 于 Java EE 应 用 各 层 的 解决 方案 ， 而 不 是 仅仅 专注 于 某 一 层 的 方案 。 可 以 说 : Spring 是 企业 应 用 
开发 的 “一 站 式 ” 选 择 ，Spring 贯穿 表现 层 、 业 务 层 、 持 久 层 。 然 而 ，Spring 并 不 想 取代 那些 已 有 的 
框架 ， 而 是 以 高 度 的 开放 性 与 它们 无 颖 整合。 
总 结 起 来 ，Spring 具有 如 下 优点 : 
> 低 侵 入 式 设 计 ， 代 码 的 污染 极 低 。 
> ”独立 于 各 种 应 用 服务 器 , 基于 Spring 框架 的 应 用 , 可 以 真正 实现 Write Once、 Run Anywhere 
的 承诺 。 

> ”Spring 的 DI 容器 降低 了 业务 对 象 替 换 的 复杂 性 ， 提 高 了 组 件 之 间 的 解 耦 。 

> ”Spring 的 AOP 支持 允许 将 一 些 通用 任务 如 安全 、 事 务 、 日 志 等 进行 集中 式 处 理 ， 从 而 提供 
了 更 好 的 复 用 。 

> ”Spring 的 ORM 和 DAO 提供 了 与 第 三 方 持久 层 框架 的 良好 整合 ， 并 简化 了 底层 的 数据 库 访 
问 。 

> ”Spring 的 高 度 开放 性 ， 并 不 强制 应 用 完全 依赖 于 Spring， 开 发 者 可 自由 选用 Spring 框架 的 
部 分 或 全 部 。 


527 


http://52pdf.taobao.com 
狗 旺 旬 Java EE 企业 应 用 实战 (第 3 版 ) 一 


图 7.1 显示 了 Spring 框架 的 组 成 结构 图 。 


图 7.1 Spring 框架 的 组 成 结构 图 


正如 图 7.1 所 见 到 的 , 当 我 们 使 用 Spring 框架 时 , 必须 使 用 Spring Core Container ( 即 Spring 容器 )， 
它 代 表 了 Spring 框架 的 核心 机 制 ，Spring Core Container 主要 由 org.springframework.core 、 
org.springframework.beans 和 org.springframework.context、org.springframework.expression 四 个 包 及 其 子 包 
组 成 ， 主 要 提供 Spring loC 容器 支持 。 其 中 org.springframework.expression 及 其 子 包 是 Spring 3.0 新 增 
的 ， 它 提供 了 Spring Expression Language 支持 。 


>>7.1.2 Spring 3.0 的 变化 


与 Spring 2.5 相 比 ，Spring 3.0 发 生 了 一 些 较 大 的 改变 ， 包 括 : 

> Spring 3.0 不 再 采用 以 前 统一 的 构建 方式 ， 而 是 改 为 使 用 多 项 目 结构 的 组 织 方式 。Spring 的 
发 布 版 不 再 提供 一 个 完整 打包 文件 : springjar， 而 是 由 20 个 JAR 包 组 成 。 

> Spring 不 再 提供 with-dependencies 的 下 载 项 ， 开 发 者 必须 自行 下 载 Spring 核心 项 目 和 
Spring dependencies (Spring 编译 和 运行 所 依赖 的 第 三 方 类 库 ) 。 

> Spring 3.0 已 经 完全 采用 Java 5 进行 开发 和 编译 ， 不 再 支持 Java 1.4 或 更 早 的 版 本 。 

> Spring 3.0 引入 了 一 个 全 新 的 功能 : 表达 式 语 言 (EL) 支持 ,简称 SpPEL。SpEL 用 起 来 十 分 
简单 (与 JSP 2 的 EL、OGNL EL 功能 类 似 ) ， 但 能 给 实际 开发 带 来 巨大 的 方便 。 

> Spring 3.0 还 增加 了 一 个 新 特性 :使 用 Java 类 配置 来 代替 XML 配置 ， 这 为 讨厌 XML 配置 
的 开发 者 提供 了 一 个 额外 的 选择 。 

本 书 所 介绍 的 Spring 正 是 Spring 的 最 新 发 布 版 : Spring 3.0.5， 接 下 来 会 看 到 上 面 这 些 改变 的 详细 

介绍 。 


7.2 Spring 的 下 载 和 安装 


笔者 成 书 之 时 ，Spring 的 最 新 稳定 版 本 是 3.0.5 版 ， 本 书 的 代码 都 基于 该 版 本 的 Spring 测试 通过 ， 
建议 读者 也 下 载 该 版 本 的 Spring。 


>》>7.2.1 在 JavaSE 应 用 中 使 用 Spring 


Spring 并 不 是 只 能 在 Web 应 用 中 使 用 ， 它 可 以 在 任何 的 Java 应 用 中 使 用 。 为 普通 Java 应 用 增加 
Spring 支持 请 按 如 下 步骤 进行 。 
人 @ 登录 http://wwwspringsource.org/download 站 点 ， 下 载 Spring 的 最 新 稳定 版 。 前 面 已 经 提 到 : 
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法 


Spring 不 再 提供 with-dependencies 的 下 载 项 ， 因 此 读者 需要 下 载 两 个 压缩 包 
spring-framework-3.0.5.RELEASE-with-docs.zip ( Spring 框架 及 文档 ) 和 spring-framework-3.0.5. 
RELEASE-dependencies.zip (Spring 框架 的 依赖 JAR 包 )。 
解压 缩 spring-framework-3.0.5.RELEASE-with-docs.zip， 解 压缩 后 得 到 一 个 名 为 spring-framework- 
3.0.5.RELEASE-with-docs.zip 的 文件 夹 ， 该 文件 夹 下 有 如 下 几 个 子 文件 夹 。 
> dist: 该 文件 夹 下 包含 Spring 的 JAR 包 ，Spring 不 再 提供 完整 的 spring.jar, 而 是 由 20 个 分 
模块 的 JAR 包 组 成 ， 不 同 的 JAR 包 提供 不 同 的 功能 ， 这 样 允 许 开发 者 根据 不 同 需要 选择 不 
同 的 JAR 包 。 一 般 来 说 ， 图 7.1 中 Core Container 对 应 的 JAR 包 是 使 用 Spring 必需 的 。 
> ”docs: 该 文件 夹 下 存放 Spring 的 相关 文档 ， 包 含 开发 指南 、API 参考 文档 。 
> ”projects: 该 文件 夹 下 存放 了 Spring 分 模块 的 项 目 结构 ， 包 括 项 目 源 代 码 、Maven 的 生成 文 
件 、Ant+rlvy 的 生成 文件 。 


不 : 有 
Fes Spring 3.0 虽然 依然 提供 了 Maven 生成 文件 ， 但 不 再 使 用 Maven 作为 项 目的 生成 、 管 ， 
由 理工 具 ， 而 是 采用 Anttlvy 作为 主要 的 项 目 生成 、 管 理工 具 。 | 


> ”src: 该 文件 夹 下 包含 Spring 分 模块 的 项 目 源 代码 ， 每 个 JAR 包 包 含 一 个 分 模块 的 项 目的 源 

代码 。 

> 在 解压 缩 后 的 文件 夹 下， 还 包含 一 些 关 于 Spring 的 license 和 项 目 相关 文件 。 

人 将 dist 目录 下 所 需要 模块 的 JAR 包 复 制 到 项 目的 CLASSPATH 路 径 下 。 如 果 需 要 发 布 该 应 用 ， 
则 将 这 些 JAR 包 一 同 发 布 即 可 。 如 果 没 有 太 多 的 约束 ， 建 议 复制 dist 目录 下 的 全 部 JAR 包 。 

企 解压 缩 spring-framework-3.0.5.RELEASE-dependencies.zip, 该 目录 下 包含 了 Spring 框架 编译 和 
运行 所 依赖 的 第 三 方 类 库 ， 具 体 需 要 哪些 JAR 文件 ， 取 决 于 应 用 所 用 到 的 项 目 。 通 常 需要 增加 
common-logging 等 文件 夹 下 的 JAR 文件 。 因 此 ， 这 些 JAR 文件 也 是 应 用 所 必需 的 ， 通 常 也 需要 随 应 
用 一 同 发 布 。 


本 
三 - 注意 :站 
该 解压 缩 路 径 下 的 的 每 个 项 目 文件 夹 下 都 包含 至 少 两 个 JAR 包 : 一 个 是 包含 二 进 制 有 


-Sources 子囊 ， 项 目 需 要 用 的 是 第 一 个 JAR 包 


£ 
| *elass 文件 的 JAR 包 ; 一 个 是 包含 Java 源 文件 的 JAR 包 ， 该 JAR 包 文 件 名 中 通常 包含 可 
| 


人 @ 为 了 编译 Java 文件 时 可 以 找到 Spring 的 基础 类 ， 应 将 Spring 项 目下 dist 目录 下 相关 JAR 包 
添加 到 CLASSPATH 环境 变量 。 当 然 ， 也 可 使 用 Ant 工具 或 其 他 IDE 工具 ， 则 无 须 添加 环境 变量 。 
经 过 上 面 4 个 步骤 ， 我 们 就 可 以 在 Java 应 用 中 使 用 Spring 框架 了 。 


>》7.2.2 在 Web 应 用 中 使 用 Spring 


正如 前 面 介 绍 的 ， 为 Java SE 应 用 中 增加 Spring 支持 非常 简单 ， 只 需 在 应 用 的 CLASSPATH 中 增 
加 Spring 编译 和 运行 所 需 的 JAR 文件 即 可 。 

为 了 让 Web 应 用 可 以 使 用 Spring 支持 ， 只 需要 如 下 两 个 步骤 。 

G 将 Spring 项 目的 dist 路 径 下 的 全 部 JAR 包 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 。 

人 将 Spring 的 spring-framework-3.0.5.RELEASE-dependencies.zip 解压 缩 路 径 下 所 需 的 第 三 方 类 
库 文件 复制 到 Web 应 用 的 WEB-INF/lib 路 径 下 。 
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到 应 用 中 ， 而 是 推荐 采用 “需要 哪些 项 目 ， 就 增加 对 应 JAR 包 ” 


提示 : 
六 与 前 面 介绍 Hibernate 框架 时 相似 的 是 ， 笔 者 不 推荐 一 次 性 将 


经 过 上 面 两 个 步 又 ，Web 应 用 中 已 经 获得 了 Spring 的 支持 。 
>>7.2.3 在 Eclipse 中 开发 Spring 应 用 


下 面 以 开发 一 个 简单 的 Java 应 用 为 例 ， 介 绍 在 Eclipse 工具 中 开发 Spring 应 用 。 
人 启动 Eclipse 工具 ， 通 过 单 击 Eclipse 工具 栏 上 的 新 建 图 标 ， 选 择 新 建 一 个 Spring 项 目 ， 为 该 
项 目 命名 为 myspring。 新 建 myspring 项 目的 界面 如 图 7.2 所 示 。 
人 单 击 如 图 7.2 所 示 对 话 框 中 的 “Next” 按 钮 ， 再 单 击 随后 出 现 的 对 话 框 中 的 “Finish ”按钮 ， 
建立 项 目 成 功 。 
- 量 新 建 项 目 成 功 ， 即 可 在 Eclipse 的 左边 见 到 项 目的 结构 树 。Eclipse 左边 的 导航 结构 树 如 图 7.3 
所 示 。 


图 7.2 新 建 myspring Java 项 目 图 7.3 成 功 新 建 myspring 项 目 

全 与 使 用 Eclipse 开发 Hibemate 相似 ， 接 下 来 应 该 为 该 项 目 增加 Spring 支持 。 右 键 单 击 如 图 7.3 

所 示 的 “myspring” 节 点 ， 在 出 现 的 快捷 菜单 中 单 击 “Build Path” 一 “Add Libraries” 菜 单项 。 操 作 
过 程 如 图 7.4 所 示 。 
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村 7 


@ 单 击 如 图 7.4 所 示 的 Add Libraries 项 后 ， 出 现 如 图 7.5 所 示 的 增加 用 户 库 对 话 框 。 
人 选中 如 图 7.5 所 示 的 “User Library ”项 ， 然 后 单 击 “Next” 按 钮 ， 进 入 选择 并 添加 用 户 库 
对 话 框 ， 如 图 7.6 所 示 。 


® | 


图 7.6 选择 并 添加 用 户 库 
揭示 1 一 二 一 

[笔者 的 Eclipse 中 已 经 包含 了 大 量 的 用 户 库 ,例如 Hibernate3.6 用 户 库 . 关于 如 何 添加 、: 

总 编辑 User Library， 读 者 可 参考 5.2.2 节 所 介绍 的 操作 步骤 来 完成 ， 读 者 可 增加 Spring3.0.5 | 

| ”的 用 户 库 ，Spring 3.0.5 用 户 库 包括 dist 路 径 下 的 全 部 文件 . j 

人 @ 在 如 图 76 所 示 的 对 话 框 中 勾 选 spring3.0.5 、 
common-logging 之 前 的 复 选 框 , 然后 单 击 如 图 7.6 所 示 对 话 框 下 的 
“Finish” 按 钮 。 为 项 目的 编译 和 运行 增加 用 户 库 成 功 ，Eclipse 的 
左边 出 现 如 图 7.7 所 示 的 导航 树 。 

我 们 此 处 并 未 使 用 MyEclipse 等 工具 的 支持 ,在 Eclipse 等 IDE 
工具 中 使 用 Spring 非常 简单 ， 只 要 让 IDE 工具 去 管理 项 目 编译 、 
运行 所 依赖 的 类 库 〈 通 过 配置 Build Path) 即 可 。 相 反 ，IDE 工具 
反而 不 可 能 支持 所 有 技术 、 框 架 的 最 新 版 本 一 一 因为 框架 、 技 术 总 
是 先 出 来 ， 而 IDE 工具 的 开发 则 滞后 于 最 新 的 技术 、 框 架 。 

人 @ 编写 主 程序 ， 该 主 程序 仅仅 初始 化 Spring 容器 ，Spring 容 
器 是 Spring 应 用 的 核心 ， 该 容器 负责 管理 容器 中 的 Java 组 件 。 该 


主 程序 的 代码 如 下 。 
二 


* 奢 .注意 :* 
刚才 所 添加 的 Eclipse 用 户 库 只 能 保证 在 Eclipse 下 编译 、 运 行 该 程序 可 找到 相应 的 | 
类 库 ; 如果 需要 发 布 该 应 用 ， 则 还 要 将 刚刚 所 添加 的 用 户 库 所 引用 的 JAR 文件 随 应 用 一 | 
起 发 布 . 对 一 个 Web 应 用 ， 由 于 Eclipse 部 署 Web 应 用 时 不 会 将 用 户 库 的 JAR 文件 复制 。 | 
到 Web 应 用 的 WEB-INF/lib 路 径 下 ， 所 以 我 们 需要 主动 将 用 户 库 所 引用 的 JAR 文件 复 


制 到 Web 应 用 的 WE TNF/lib 路 径 下 


程序 清单 : codes\07\7.2\myspring\src\lee\SpringTest.java 
public class SpringTest 
{ 


Public static void main(String[] args) 
{ 


// 创 建 Spring 的 ApplicationContext 
ApplicationContext ctx = new ClassPathxmlApplicationContext 
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("bean.xml"); 
// 输 出 Spring 容器 
System.out .println(ctx)7 
} 
于 
上 面 的 代码 仅仅 创建 了 AppliactionContext 实例 ， 而 ApplicationContext 实例 正 是 Spring 容器 。 

旦 获得 了 Spring 容器 ， 就 可 通过 该 容器 访问 Spring 容器 中 的 Bean。 运 行 该 程序 ， 将 可 看 到 程序 可 以 
正常 输出 Sp 的 ApplicationContext 实例 。 


节 未 .流明 ， * 
ApplicationContext 实例 是 Spring 的 核心 ， 它 既是 一 个 巨大 的 工厂 ， 也 是 一 个 功能 超 强 要 


的 工厂 。 还 包括 许多 其 他 功能 ，Spring 框架 的 绝 大 部 分 功能 都 是 通过 该 容器 实现 的 。 


人 @ 为 了 让 Spring 管理 容器 中 的 Bean， 下 面 增加 一 个 简单 的 Java 类 文件 。 该 文件 的 代码 如 下 。 
程序 清单 : codes\07\7.2\myspring\src\org\crazyit\app\service\PersonService.java 


public class PersonService 
{ 
Private String name; 
//name 属性 的 setter 方法 
public void setName (String name) 
{ 
this.name = name; 


} 

// 测 试 Person 类 的 info 方法 
public void info() 

和 


System,out .println(" 此 人 名 为 : " 
+ name); 


} 


} 
上 面 定义 了 一 个 PersonService 类 ， 这 个 PersonService 类 甚至 不 是 一 个 标准 的 JavaBean。 这 没有 
问题 ， Spring 可 以 管理 任意 的 POJO， 并 不 要 求 Java 类 是 一 个 标准 的 JavaBean。 


3 


[gl DT Nr 类 部 署 在 Spring ne 配置 文件 中 在 Spring 配置 文件 中 增加 如 下 片段 。 


<!-- 将 FersonService 类 部 署 成 Spring 容器 中 的 Bean --> 
<bean id="personService" class="org.crazyit.app. service.PersonService"> 
<property name="name" value="wawa"/> 


</bean> 
人 @ 修改 主 程序 ， 在 主 程序 的 main 方法 体内 增加 如 下 两 行 代码 : 


PersonService p = ctx.getBean("personService" , PersonService.class); 
p.info(); 


上 面 两 行 代码 并 不 是 直接 创建 Person 实例 , 而 是 通过 Spring 容器 获取 Person 实例 , 这 正 是 Spring 
容器 的 作用 。 当 执行 p.info0 方 法 时 ， 看 到 如 下 执行 结果 : 
此 人 名 为 :wawa 
看 起 来 相当 神奇 ，Spring 容器 不 仅 可 以 创建 Person 实例 ， 而 且 该 Person 实例 的 name 属性 有 了 属 
性 值 。 这 一 切 ， 都 得 益 于 Spring 容器 的 作用 ，Spring 容器 根据 配置 文件 信息 ， 人 负责 创建 Person 实例 ， 
并 为 Person 实例 设置 属性 值 一 一 这 种 由 Spring 容器 为 对 象 设置 属性 的 方式 被 称 为 控制 反 转 (Inversion 
of Control，IoC )。 
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#7 


7.3 Spring 的 核心 机 制 : 依赖 注入 


正如 在 前 面 代码 中 所 看 到 的 ， 程 序 代码 并 没有 主动 设置 Person 实例 的 name 属性 值 ， 但 执行 info 
方法 时 , Person 实例 的 name 属性 值 为 wawa, 而 wawa 是 通过 Spring 配置 文件 配置 的 ,这 就 是 说 , Person 
实例 的 属性 值 并 不 是 程序 主动 设置 的 ， 而 是 由 Spring 容器 来 负责 注入 的 。 
和 Java 应 用 (从 基于 Applet 的 小 应 用 到 多 层 结构 的 企业 级 应 用 )， 它 们 都 是 一 
黄种 典型 的 依赖 型 应 用 ， 也 就 是 由 一 些 互相 协作 的 对 象 构成 的 。Spring 把 这 种 互相 协作 的 关 | 
| 。 系 称 为 依赖 关系 。 假如 A 组 件 调用 了 B 组 件 的 方法 ， 我 们 可 称 A 组 件 依赖 于 B 组 件 。 J 


使 用 依赖 注入 ， 不 仅 可 以 为 Bean 注入 普通 的 属性 值 ， 还 可 以 注入 其 他 Bean 的 引用 。 通 过 这 种 依 
赖 注入 ，Java EE 应 用 中 的 各 种 组 件 不 需要 以 硬 编码 方式 耦合 在 一 起 ， 甚 至 无 须 使 用 工厂 模式 。 依 赖 注 
入 达到 的 效果 ， 非 常 类 似 于 传说 中 的 “共产 主义 ”"， 当 某 个 Java 实例 需要 其 他 Java 实例 时 ， 系 统 自动 
提供 所 需要 的 实例 ， 无 须 程序 显 式 获取 。 

可 见 ， 依 赖 注 入 是 目前 最 优秀 的 解 耦 方式 。 依 赖 注入 让 Spring 的 Bean 以 配置 文件 组 织 在 一 起 ， 
而 不 是 以 硬 编码 的 方式 耦合 在 一 起 。 

人 


入 容器 的 唯一 选择 。 例 如 HiveMind， 它 也 是 一 个 开源 的 依赖 注入 容器 。 


i Spring 极 好 地 利用 了 依赖 注入 ， 但 Spring 既 不 是 依赖 注入 的 首创 者 ， 也 不 是 依 玉 要 


> 7.3.1 理解 依赖 注入 


虽然 Spring 并 不 是 依赖 注入 的 首创 者 , 但 Johnson 是 第 一 个 高 度 重视 以 配置 文件 来 管理 Java 实例 
的 协作 关系 的 人 ， 他 给 这 种 方式 起 了 一 个 名 字 : 控制 反 转 〈Inversion of Control，loC)。 但 这 个 名 称 极 
其 星 汲 ， 在 后 来 的 日 子 里 ，Martine Fowler 为 这 种 方式 起 了 另 一 个 相对 简单 的 称呼 ， 依 赖 注入 
(Dependency Injection )。 

因此 ， 不 管 是 依赖 注入 ， 还 是 控制 反 转 ， 其 含义 完全 相同 ; 当 某 个 Java 实例 〈 调 用 者 ) 需要 另 一 
个 Java 实例 〈 被 调用 者 ) 时 ， 在 传统 的 程序 设计 过 程 中 ， 通 常 由 调用 者 来 创建 被 调用 者 的 实例 。 

在 依赖 注入 的 模式 下 ， 创 建 被 调用 者 的 工作 不 再 由 调用 者 来 完成 ， 因 此 称 为 控制 反 转 ， 创 建 被 调 
用 者 实例 的 工作 通常 由 Spring 容器 来 完成 ， 然 后 注入 调用 者 ， 因 此 也 称 为 依赖 注入 。 

不 管 是 依赖 注入 ， 还 是 控制 反 转 ， 都 说 明 Spring 采用 动态 、 灵 活 的 方式 来 管理 各 种 对 象 。 对 象 与 
对 象 之 间 的 具体 实现 互相 透明 。 

为 了 更 好 地 理解 依赖 注入 ， 笔 者 建议 参考 人 类 社会 的 发 展 ， 看 如 下 问题 在 各 种 社会 形态 里 如 何 解 
决 : 一 个 人 〈Java 实例 ， 调 用 者 ) 需要 一 把 作 子 〈Java 实例 ， 被 调用 者 )。 

在 原始 社会 里 , 几乎 没有 社会 分 工 。 需 要 产子 的 人 (调用 者 ) 只 能 自己 去 磨 一 把 戎 子 (被 调用 者 )。 
对 应 的 情形 为 : Java 程序 里 的 调用 者 自己 创建 被 调用 者 ,通常 采用 new 关键 字 调 用 构造 器 创建 一 个 被 
调用 者 ， 这 是 Java 初学 者 经 常 干 的 事情 。 

进入 工业 社会 ， 工 厂 出 现 了 ， 丛 子 不 再 由 普通 人 完成 ， 而 在 工厂 里 被 生产 出 来 ， 此 时 需要 斧子 的 
人 调用 者 》 找 到 工厂 ， 购 买 伏 子 ， 无 须 关 心 伏 子 的 制造 过 程 。 对 应 简单 工厂 设计 模式 ， 调 用 者 只 需 
要 定位 工厂 ， 无 须 管理 被 调用 者 具体 的 实现 。 

进入 “共产 主义 ”社会 ， 需 要 产子 的 人 甚至 无 须 定位 工厂 ,“ 坐 等 ”社会 提供 即 可 。 调 用 者 无 须 关 
心 被 调用 者 的 实现 ， 无 须 理会 工厂 ， 等 待 Spring 依赖 注入 。 

第 一 种 情况 下 , Java 实例 的 调用 者 创建 被 调用 的 Java 实例 , 调用 者 直接 使 用 new 关键 字 创建 被 调 
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用 者 实例 ， 程 序 高 度 耦 合 ， 效 率 低下 。 真实 的 应 用 极 少 使 用 这 种 方式 。 
在 这 种 情况 下 ， 有 如 图 7.8 所 示 的 示意 图 。 
这 种 模式 是 Java 初学 者 最 喜欢 使 用 的 方式 ， 这 种 模式 有 如 下 两 个 坏处 : 
> 可 扩展 性 差 。 由 于 “人 ”组 件 与 “ 稼 头 ” 组 件 的 实现 类 高 度 看 合 ， 当 程序 试图 扩展 佐 头 组 件 
时 ，“ 人 ”组 件 的 代码 也 要 随 之 改变 。 

> ”各 组 件 职责 不 清 。 对 于 “人 ”组 件 而 言 ， 它 只 需要 调用 “和 仁 头 ”组 件 的 方法 即 可 ， 并 不 关心 
“拳头 ”组 件 的 创建 过 程 。 但 在 这 种 模式 下 ，“ 人 ”组 件 却 需 要 主动 创建 “和 斧头” 组件 ， 因 此 
职责 混乱 。 

如 果 读 者 发 现 自己 还 在 经 常 采用 这 种 方式 创建 Java 对 象 ， 那 表明 你 对 Java 掌握 得 相当 不 够 。 

第 二 种 情况 下 ， 调 用 者 无 须 关心 被 调用 者 的 具体 实现 过 程 ， 只 需要 找到 符合 某 种 标准 〈 接 口 ) 的 
实例 ， 即 可 使 用 。 此 时 调用 的 代码 面向 接口 编程 ， 可 以 让 调用 者 和 被 调用 者 解 耦 ， 这 也 是 工厂 模式 大 
量 使 用 的 原因 。 但 调用 者 依然 需要 主动 定位 工厂 ， 调 用 者 与 工厂 耦合 在 一 起 。 

第 三 种 情况 是 最 理想 的 情况 ， 程序 完全 无 须 理会 被 调用 者 的 实现 ， 也 无 须 主动 定位 工厂 ， 这 是 最 
好 的 解 耦 方式 。 实 例 之 间 的 依赖 关系 由 IoC 容器 负责 管理 。 


图 7.9 显示 了 依赖 注入 的 示意 图 。 
作 ET C7 
图 7.8 调用 者 创建 被 调用 者 的 示意 图 图 79 IoC 容器 管理 实例 的 依赖 关系 
所 谓 依赖 注入 ， 是 指 程序 运行 过 程 中 ,如 果 需 要 另 一 个 对 象 协作 〈 调 用 它 的 方法 、 访 问 它 的 属性 


时 ， 无 须 在 代码 中 创建 被 调用 者 ， 而 是 依赖 于 外 部 容器 的 注入 。Spring 的 依赖 注入 对 调用 者 和 被 调用 
者 几乎 没有 任何 要 求 ， 完 全 支持 对 POJO 之 间 依 赖 关系 的 管理 。 

依赖 注入 通常 有 如 下 两 种 。 

> 设 值 注 入 : loC 容器 使 用 属性 的 setter 方法 来 注入 被 依赖 的 实例 。 

> 构造 注入 : loC 容器 使 用 构造 器 来 注入 被 依赖 的 实例 。 


>》>》7.3.2 设 值 注入 


设 值 注入 是 指 IoC 容器 使 用 属性 的 setter 方法 来 注入 被 依赖 的 实例 。 这 种 注入 方式 简单 、 直 观 ， 
因而 在 Spring 的 依赖 注入 里 大 量 使 用 。 
看 下 面 的 代码 ， 是 Person 接口 的 代码 ， 该 接口 定义 了 一 个 Person 规范 。 
程序 清单 : codes\07\7.3\setter\src\org\crazyit\app\service\Person.java 
public interface Person 
// 定 义 一 个 使 用 关子 的 方法 


Public void useAxe(); 
} 


下 面 是 Axe 接口 的 代码 。 
程序 清单 : codes\07\7.3\setten\src\org\crazyit\app\service\Axe.java 


public interface Axe 
{ 
//Axe 接口 里 有 个 砍 的 方法 
Public String chop(); 
} 
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“pe 推荐 面向 接口 编程 ， 样 可 叉 更 好 好 让 规 范 和 实现 分 离 ， ， 从 而 提供 更 好 的 角 
耦 。 对 于 一 个 Java EE 应 用 ， 不 管 是 DAO 组 件 ， 还 是 业务 逻辑 组 件 ， 都 应 该 先 定义 一 个 3 


接口 ， 该 接口 定义 了 该 组 件 应 该 实现 的 功能 ， 但 功能 的 实 
i 是 Person 实现 类 的 代码 。 
程序 清单 : codes\07\7.3\setter\src\org\crazyit\app\service\impl\Chinese.java 


public class Chinese 
implements Person 

t 
private Axe axe; 
// 设 值 注入 所 需 的 setter 方法 
public void setAxe(Axe axe) 
{ 


this.axe = axe; 


} 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 


{ 
// 调 用 axe 的 chop () 方法 ， 
1/ 表明 Person 对 象 依赖 于 axe 对 象 
Syatem .out.PrintIn (axe. chop ()) ; 
) 
! 


上 面 程序 的 粗 体 字 代码 实现 了 Person 接口 的 useAxe0 方 法 ， 实 现 该 方法 时 调用 了 axe 的 chop0 方 
法 ， 这 就 是 典型 的 依赖 关系 一 一 回忆 一 下 ， 我 们 所 编写 的 Java 应 用 ， 除 了 最 简单 的 HelloWorld 之 外 ， 
哪个 应 用 不 是 A 调用 B、B 调用 C、C 调用 D…… 这 种 方式 ? 

那么 Spring 的 作用 呢 ? Spring 容器 的 最 大 作用 就 是 以 松 看 合 的 方式 来 管理 这 种 调用 关系 。 在 上 面 
的 Chinese 类 中 ，Chinese 类 并 不 知道 它 要 调用 的 axe 实例 在 哪里 ? 也 不 知道 axe 实例 是 如 何 实现 的 ? 
它 只 是 需要 调用 一 个 Axe 实例 ， 这 个 Axe 实例 将 由 Spring 容器 负责 注入 。 

下 面 提供 一 个 Axe 的 实现 类 : StoneAxe。 

程序 清单 :codes\07\7.3\setter\src\org\crazyit\app\service\impl\StoneAxe.java 


public class StoneAxe 
implements Axe 


{ 
Public string chop () 


return “ 石 荐 克 系 好 慑 "7 
} 


到 现在 为 止 ， 程 序 依然 不 知道 Chinese 类 和 哪个 Axe 实例 看 合 ，Spring 当然 也 不 知道 ! 实际 上 ， 
Spring 需要 使 用 XML 配置 文件 来 指定 实例 之 间 的 依赖 关系 。 

Spring 采用 了 XML 作为 配置 文件 ， 从 Spring 2.0 开始 ，Spring 既 可 采用 DTD 来 定义 配置 文件 的 
语义 约束 ， 也 可 采用 XML Schema 来 定义 配置 文件 的 语义 约束 。 当 采用 XML Schema 来 定义 配置 文件 
的 语义 约束 时 ， 还 可 利用 Spring 配置 文件 的 扩展 性 ， 进 一 步 简化 Spring 配置 。 

Spring 为 基于 XML Schema 的 XML 配置 文件 提供 了 一 些 新 的 标签 ， 这 些 新 标签 使 配置 更 简单 、 
使 用 更 方便 。 关 于 如 何 使 用 Spring 所 提供 的 新 标签 ， 后 面 会 有 更 进一步 的 介绍 。 

不 仅 如 此 ， 采 用 基于 XML Schema 的 XML 配置 文件 时 ，Spring 甚至 允许 程序 员 开 发 自 定义 的 配 
置 文件 标签 ， 让 其 他 开发 人 员 在 Spring 配置 文件 中 使 用 这 些 标签 ， 但 这 些 通常 应 由 第 三 方 供应 商 来 完 
成 。 对 普通 软件 开发 人 员 以 及 普通 系统 架构 师 而 言 ， 则 通常 无 须 开发 自 定义 的 Spring 配置 文件 标签 。 
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所 以 本 书 也 不 打算 介绍 相关 方面 的 内 容 。 
提示 :一 一 一 一 一 一 一 一 一 一 一 一 一 
天: 书 并 不 是 一 本 完整 的 Spring 学 习 玫 册 ， 所 以 本 书 只 会 介绍 Spring 的 核心 机 制 ， 包括 1 
JoC、SpEL、AOP 和 资源 访问 等 ，Spring 和 Hibernate 整合 ，Spring 的 DAO ha | 
| 。 理 ， 以 及 Spring 和 Struts 2 整合 等 内 容 ， 这 些 是 普通 Java EE 开发 所 需要 的 核心 知识 。 
Spring 框架 的 其 他 方面 ， 本 书 不 会 涉及 。 | 
由 于 Spring 现在 已 经 推荐 使 用 XML Schema 作为 配置 文件 的 语义 约束 , 因此 本 书 将 全 部 改 为 使 用 
XML Schema 作为 配置 文件 的 语义 约束 。 读 者 可 以 在 Spring 的 projects 目录 的 
org.springframework.beans、org.springframework.context 等 子 目 录 的 \src\main\resources 路 径 下 找到 各 种 
*.xsd 文件 ， 这 些 文件 就 是 Spring 配置 文件 的 XML Schema 语义 约束 文件 。 


提 
六 关于 XML Schema 语义 约束 的 知识 ,读者 可 以 参考 疯狂 Java 体系 的 《疯狂 XML 讲义 》。 j 


下 面 是 本 应 用 所 用 的 配置 文件 代码 。 
程序 清单 :codes\07\7.3\setter\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
"http://www. springframework.org/schema/beans" 
:hemaLocation="http://www. springframework.org/schema/beans 
/www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 chinese 实例 ， 其 实现 类 是 Chinese --> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 
<!-- 将 stoneAxe 注入 给 axe 属性 --> 
<property name="axe" ref="stoneAxe"/> 


</bean> 

<!-- 配置 stoneAxe 实例 ， 其 实现 类 是 StoneAxe --> 

<bean id="stoneAxe" class="org.crazyit.app.service.impl.StoneAxe"/> 
</beans> 


在 配置 文件 中 ，Spring 配置 Bean 实例 通常 会 指定 两 个 属性 : 

> id， 指定 该 Bean 的 唯一 标识 ， 程 序 通过 id 属性 值 来 访问 该 Bean 实例 。 

> class: 指定 该 Bean 的 实现 类 ， 此 处 不 可 再 用 接口 ， 必 须 使 用 实现 类 ，Spring 容器 会 使 用 

XML 解析 器 读 取 该 属性 值 ， 并 利用 反射 来 创建 该 实现 类 的 实例 。 

可 以 看 到 Spring 管理 Bean 的 灵巧 性 。Bean 与 Bean 之 间 的 依赖 关系 放 在 配置 文件 里 组 织 ， 而 不 
是 写 在 代码 里 。 通 过 配置 文件 的 指定 ，Spring 能 精确 地 为 每 个 Bean 注入 属性 。 因 此 ， 配 置 文件 里 的 
<bean... 人 > 元 素 的 class 属性 值 不 能 是 接口 ， 而 必须 是 真正 的 实现 类 。 

如 果 读 者 需要 了 解 Spring loC 容器 的 更 多 实现 原理 , 可 以 参考 本 书 关 于 简单 工厂 设计 模式 的 讲解 ， 
在 那里 笔者 实现 了 一 个 初步 的 IoC 容器 。 

Spring 会 自动 接管 每 个 <bean.…. 人 > 定义 里 的 <property.… 信 元 素 定义 , Spring 会 在 调用 无 参数 的 构造 器 
后 、 创 建 默 认 的 Bean 实例 后 ， 调 用 对 应 的 setter 方法 为 程序 注入 属性 值 。<property.…. 人 > 定义 的 属性 值 
将 不 再 由 该 Bean 来 主动 设置 、 管 理 ， 而 是 接收 Spring 的 注入 。 

每 个 Bean 的 id 属性 是 该 Bean 的 唯一 标识 ， 程 序 通过 id 属性 访问 Bean，Bean 与 Bean 的 依赖 关 
系 也 通过 id 属性 关联 。 

下 面 是 主 程序 的 代码 ， 该 主 程序 只 是 简单 地 获取 了 Person 实例 ， 并 调用 该 实例 的 useAxe 方法 。 

程序 清单 : codes\07\7.3\setter\src\lee\BeanTest.java 

RN class BeanTest 
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public static void main(String[] args)throws Exception 

{ 
// 创 建 Spring 容器 
ApplicationContext ctx = new 

ClasspathxmlApplicationContext ("bean. xml") ; 

// 获 取 chinese 实例 
Person P = ctx.getBean("chinese" , Person.class); 
// 调 用 useaxe() 方 法 
Pp-.useAxe(); 

) 

1 


上 面 程序 的 两 行 粗 体 字 代码 实现 了 创建 Spring 容器 ， 并 通过 Spring 容器 来 获取 chinese 实例 。 从 
上 面 程序 中 可 以 看 出 ，Spring 容器 就 是 一 个 巨大 的 工厂 ， 它 可 以 “生产 ”出 所 有 类 型 的 Bean 实例 。 程 
序 获取 Bean 实例 的 方法 是 getBean0， 如 上 面 程序 的 第 二 行 粗 体 字 代码 所 示 。 
- 旦 通过 Spring 容器 获得 了 Bean 实例 之 后 ， 使 用 这 个 Bean 实例 就 没有 什么 特别 之 处 了 。 执行 上 
面 程序 ， 看 到 如 下 执行 结果 : 
石 养 砍 柴 好 慢 
主 程序 调用 Person 的 useAxe0 方 法 时 ,该 方法 的 方法 体内 需要 使 用 Axe 实例 ,但 程序 没有 任何 地 
方 将 特定 的 Person 实例 和 Axe 实例 耦合 在 一 起 。 或 者 说 ， 程 序 没有 为 Person 实例 传 入 Axe 实例 ，Axe 
实例 由 Spring 在 运行 期 间 注入 。 
Person 实例 不 仅 不 需要 了 解 Axe 实例 的 具体 实现 ， 甚 至 无 须 了 解 Axe 的 创建 过 程 。Spring 容器 根 
据 配置 文件 的 指定 ， 创 建 Person 实例 时 ， 不仅 创建 了 Person 的 默认 实例 ， 并 为 该 实例 依赖 注入 其 所 依 
赖 的 Axe 实例 。 
假设 有 一 天 ， 系 统 需要 改变 Axe 的 实现 一 一 这 种 改变 ， 对 于 实际 开发 是 很 常见 的 情形 ， 也 许 是 因 
为 技术 的 改进 ， 也 许 是 因为 性 能 的 优化 ， 也 许 是 需求 的 变化 等 。 我 们 只 需要 给 出 Axe 的 另 一 个 实现 ， 
而 Person 接口 、Chinese 类 的 代码 无 须 任何 改变 。 
下 面 是 Axe 的 另 一 个 实现 类 : SteelAxe。 
程序 清单 :codes\07\7.3\setten\src\org\crazyit\app\service\impl\SteelAxe.java 


public class steelAxe 
implements Axe 

{ 
public string chop() 


{ 
return " 钢 莽 砍 柴 真 快 "; 
} 
} 


将 修改 后 的 SteelAxe 部 署 在 Spring 容器 中 ， 只 需 在 Spring 配置 文件 中 增加 如 下 一 行 : 


<!-~ 配置 steelAxe 实例 ， 其 实现 类 是 SteelAxe --> 
<bean id="stoneAxe" class="org.crazyit.app. service. impl.SteelAxe"/> 


该 行 重新 定义 了 一 个 Axe 实例 ， 它 的 id 是 steelAxe， 实 现 类 是 SteelAxe。 然 后 修改 chinese Bean 
的 配置 ， 将 原来 传 入 stoneAxe 的 地 方 改 为 传 入 steelAxe。 也 就 是 将 
<property name="axe" ref="stoneAxe"/> 
改 成 : 
<property name="axe" ref="steelAxe"/> 
此 时 再 次 执行 程序 ， 将 得 到 如 下 结果 : 
锅 乔 砍 柴 真 快 
从 上 面 这 种 切换 可 以 看 出 ， 因 为 chinese 实例 与 具体 的 Axe 实现 类 没有 任何 关系 ，chinese 实例 仅 
仅 与 Axe 接口 耦合 ， 这 就 保证 了 chinese 实例 与 Axe 实例 之 间 的 松 耦合 一 一 这 也 是 Spring 强调 面向 接 
口 编程 的 原因 。 
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Bean 与 Bean 之 间 的 依赖 关系 由 Spring 管理 ，Spring 采用 setter 方法 为 目标 Bean 注入 所 依赖 的 
Bean， 这 种 方式 被 称 为 设 值 注入 。 
从 上 面 示例 程序 中 应 该 可 以 看 出 ， 依 赖 注入 以 配置 文件 管理 Bean 实例 之 间 的 耦 台 ， 让 Bean 实例 
之 间 的 耦合 从 代码 层次 分 离 出 来 。 依 赖 注 入 是 一 种 优秀 的 解 耦 方式 。 
经 过 上 面 的 介绍 ， 不 难 发 现 使 用 Spring IoC 容器 的 3 个 基本 要 点 : 
> ”应 用 程序 的 各 组 件 面向 接口 编程 。 面 向 接口 编程 可 以 将 各 组 件 之 间 的 耦合 提升 到 接口 层次 ， 
从 而 有 利 项 目 后 期 的 扩展 。 
> ”应 用 程度 的 各 组 件 不 再 由 程序 主动 产生 ， 而 是 由 Spring 容器 来 负责 产生 、 并 初始 化 。 
> ”Spring 采用 配置 文件 、 或 Annotation 来 管理 Bean 的 实现 类 、 依 赖 关 系 ，Spring 容器 则 根据 
配置 文件 、 利 用 反射 来 创建 实例 ， 并 为 之 注入 依赖 关系 。 


7.3.3 构造 注入 


前 面 已 经 介绍 过 ， 通 过 setter 方法 为 目标 Bean 注入 依赖 关系 的 方式 被 称 为 设 值 注入 ; 另外 还 有 一 
种 注入 方式 ， 这 种 方式 在 构造 实例 时 ， 已 经 为 其 完成 了 依赖 关系 的 初始 化 。 这 种 利用 构造 器 来 设置 依 
赖 关 系 的 方式 ， 被 称 为 构造 注入 。 
对 前 面 代码 Chinese 类 做 简单 的 修改 ， 修 改 后 的 代码 如 下 : 
程序 清单 : codes\07\7.3\constructon\src\org\crazyit\app\service\impl\Chinese.java 
public class Chinese 
implements Person 
t private Axe axe; 
// 默 认 的 构造 器 
public Chinese() 
{ 
} 
UL/ 
public Chinese (Axe axe) 
this.axe = axe; 


} 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 


{ 
/7 调用 axe 的 chop() 方 法 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System .out .println(axe.chop())7 
) 
} 
上 面 的 Chinese 类 没有 提供 设置 axe 属性 的 setter 方法 ， 仅 仅 提供 了 一 个 带 Axe 属性 的 构造 器 ， 
Spring 将 通过 该 构造 器 为 chinese 注入 所 依赖 的 Bean 实例 。 
构造 注入 的 配置 文件 也 需 做 简单 的 修改 ， 为 了 使 用 构造 注入 ， 使 用 <constructorarg.… 人 > 元 素 指定 构 
造 器 的 参数 。 修 改 后 的 配置 文件 如 下 。 
程序 清单 : codes\W7\7.3Vconstructorsrc\bean .xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance™ 
xmlns="http://www.springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 chinese 实例 ， 其 实现 类 是 Chinese --> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 


<1-- 使 用 构造 注入 ， 为 chinese 实例 注入 steelAxe 实例 --> 
<constructor-arg ref="steelAxe"/> 
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</bean> 
<!-- 配置 stoneAxe 实例 ， 其 实现 类 是 StoneAxe --> 
<bean id="stoneAxe" class="org.crazyit.app.service.impl.stoneAxe"/> 
<!-- 配置 steelAxe 实例 ， 其 实现 类 是 SteelAxe --> 
<bean id="stoneAxe" class="org.crazyit.app.service,impl.SteelAxe"/> 
</beans> 


上 面 的 配置 文件 的 粗 体 字 代码 使 用 <constructor-arg.… 人 > 元 素 指定 了 一 个 构造 器 参数 ， 该 参数 类 型 是 
Axe， 这 指定 Spring 调用 Chinese 类 里 带 一 个 Axe 参数 的 构造 器 来 创建 chinese 实例 ， 因 为 使 用 了 有 参 
数 的 构造 器 创建 实例 ， 所 以 当 Bean 实例 被 创建 完成 后 ， 该 Bean 的 依赖 关系 已 经 设置 完成 。 

配置 <constructor-arg... 人 > 元 素 时 可 指定 一 个 index 属性 ， 用 于 指定 该 构造 参数 值 将 作为 第 几 个 构造 
参数 值 ， 例 如 ， 指 定 index="0" 表 明 该 构造 参数 值 将 作为 第 一 个 构造 参数 。 

执行 效果 与 使 用 steelAxe 设 值 注入 时 的 执行 效果 完全 一 样 。 区 别 在 于 ; 创建 Person 实例 中 Axe 
属性 的 时 机 不 同一 一 设 值 注入 是 先 通过 无 参数 的 构造 器 创建 一 个 Bean 实例 ,然后 调用 对 应 的 setter 方 
法 注入 依赖 关系 ;而 构造 注入 则 直接 调用 有 参数 的 构造 器 ， 当 Bean 实例 创建 完成 后 ， 已 经 完成 了 依 
赖 关 系 的 注入 。 


>》》7.3.4 两 种 注入 方式 的 对 比 


在 过 去 的 开发 过 程 中 ， 这 两 种 注入 方式 都 是 非常 常用 的 。Spring 也 同时 支持 两 种 依赖 注入 方式 : 
设 值 注入 和 构造 注入 。 这 两 种 依赖 注入 的 方式 ， 并 没有 绝对 的 好 坏 ， 只 是 适应 的 场景 有 所 不 同 。 
相 比 之 下 ， 设 值 注 入 具有 如 下 的 优点 : 
> 与 传统 的 JavaBean 的 写法 更 相似 ， 程 序 开发 人 员 更 容易 理解 、 接 受 。 通 过 setter 方法 设 定 
依赖 关系 显得 更 加 直观 、 自 然 。 
和 对 于 复杂 的 依赖 关系 ， 如 果 采 用 构造 注入 ， 会 导致 构造 器 过 于 腑 肿 ， 难 以 阅读 。Spring 在 创 
建 Bean 实例 时 ， 需 要 同时 实例 化 其 依赖 的 全 部 实例 ， 因 而 导致 性 能 下 降 。 而 使 用 设 值 注入 ， 
则 能 避免 这 些 问题 。 
> “尤其 是 在 某 些 属性 可 选 的 情况 下 ， 多 参数 的 构造 器 更 加 笨重 。 
构造 注入 也 不 是 绝对 不 如 设 值 注入 ， 在 某 些 特定 的 场景 下 ， 构 造 注入 比 设 值 注入 更 优秀 。 构 造 注 
入 也 有 如 下 优势 : 
> ”构造 注入 可 以 在 构造 器 中 决定 依赖 关系 的 注入 顺序 ， 优 先 依赖 的 优先 注入 。 例 如 ， 组 件 中 其 
他 依赖 关系 的 注入 ， 常 常 需要 依赖 于 Datasource 的 注入 。 采 用 构造 注入 ， 可 以 在 代码 中 清 
晰 地 决定 注入 顺序 。 
> ”对 于 依赖 关系 无 须 变化 的 Bean， 构 造 注入 更 有 用 处 。 因 为 没有 setter 方法 ， 所 有 的 依赖 关 
系 全 部 在 构造 器 内 设 定 。 因 此 ， 无 须 担心 后 续 的 代码 对 依赖 关系 产生 破坏 。 
> ”依赖 关系 只 能 在 构造 器 中 设 定 ， 则 只 有 组 件 的 创建 者 才能 改变 组 件 的 依赖 关系 。 对 组 件 的 调 
用 者 而 言 ， 组 件 内 部 的 依赖 关系 完全 透明 ， 更 符合 高 内 聚 的 原则 。 
建议 采用 以 设 值 注 入 为 主 ， 构 造 注 入 为 辅 的 注入 策略 。 对 于 依赖 关系 无 须 变化 的 的 注入 ， 尽 量 采 
用 构造 注入 ;而 其 他 的 依赖 关系 的 注入 ， 则 考虑 采用 设 值 注入 。 


7.4 使 用 Spring 容器 


Spring 有 两 个 核心 接口 :BeanFactory 和 ApplicationContext, 其 中 ApplicationContext 是 BeanFactory 
的 子 接口 。 它 们 都 可 代表 Spring 容器 ，Spring 容器 是 生成 Bean 实例 的 工厂 ， 并 管理 容器 中 的 Bean。 
Bean 是 Spring 管理 的 基本 单位 ， 在 基于 Spring 的 Java EE 应 用 中 ， 所 有 的 组 件 都 被 当成 Bean 处 理 ， 
包括 数据 源 、Hibernate 的 SessionFactory、 事 务 管理 器 等 。 
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应 用 中 的 所 有 组 件 ， 都 处 于 Spring 的 管理 下 ， 都 被 Spring 以 Bean 的 方式 管理 ，Spring 负责 创建 
Bean 实例 ， 并 管理 其 生命 周期 。Spring 里 的 Bean 是 非常 广义 的 概念 ， 任 何 的 Java 对 象 、Java 组 件 都 
被 当成 Bean 处 理 ， 甚 至 这 些 组 件 并 不 是 标准 的 JavaBean。 

Bean 在 Spring 容器 中 运行 ， 无 须 感受 Spring 容器 的 存在 ， 一 样 可 以 接受 Spring 的 依赖 注入 ， 包 
括 Bean 属性 的 注入 、 协 作者 的 注入 、 依 赖 关 系 的 注入 等 。 

Spring 容器 负责 创建 Bean 实例 ， 所 以 需要 知道 每 个 Bean 的 实现 类 ，Java 程序 面向 接口 编程 ， 无 
须 关 心 Bean 实例 的 实现 类 ; 但 Spring 容器 必须 能 精确 知道 每 个 Bean 实例 的 实现 类 , 因此 Spring 配置 
文件 必须 精确 配置 Bean 实例 的 实现 类 。 


》>》>》7.4.1 Spring 容器 


Spring 容器 最 基本 的 接口 就 是 BeanFactory。BeanFactory 负责 配置 、 创 建 、 管 理 Bean， 它 有 一 个 
子 接口 ，ApplictionContext， 因 此 也 被 称 为 Spring 上 下 文 。Spring 容器 还 负责 管理 Bean 与 Bean 之 间 
的 依赖 关系 。 

BeanFactory 接口 包含 如 下 几 个 基本 方法 。 

> boolean containsBean(String name): 判断 Spring 容器 是 否 包含 id 为 name 的 Bean 实例 。 

> <T> T getBean(Class<T> requiredType): 获取 Spring 容器 中 属于 requiredType 类 型 的 、 

唯一 的 Bean 实例 。 

> Object getBean(String name): 返回 容器 id 为 name 的 Bean 实例 。 

> <T> T getBean(String name，Class requiredType): 返回 容器 中 id 为 name， 并 且 类 型 为 

requiredType 的 Bean 

> Class<?> getType(String name): 返回 容器 中 指定 Bean 实例 的 类 型 。 

调用 者 只 需 使 用 getBean() 方 法 即 可 获得 指定 Bean 的 引用 , 无 须 关心 Bean 的 实例 化 过 程 。 即 : Bean 
实例 的 创建 过 程 完全 透明 。 

BeanFactory 有 一 个 常用 的 实现 类 : org.springframework.beans.factory.xml.XmlBeanFactory 类 。 

ApplicationContext 是 BeanFactory 的 子 接口 ， 对 于 大 部 分 Java EE 应 用 而 言 ， 使 用 它 作 为 Spring 
容器 更 方便 。 其 常用 实现 类 是 FileSystemXmlApplicationContext、ClassPathXmlApplicationContext 和 
AnnotationConfigApplicationContext 。 如 果 在 Web 应 用 中 使 用 Spring 容器 ， 通 常 有 
XmlWebApplicationContext、AnnotationConfigWebApplicationContext 两 个 实现 类 。 

创建 Spring 容器 的 实例 时 ， 必 须 提供 Spring 容器 管理 的 Bean 的 详细 配置 信息 。Spring 的 配置 信 
息 通常 采用 XML 配置 文件 来 设置 ， 因 此 ， 创 建 BeanFactory 实例 时 ， 应 该 提供 XML 配置 文件 作为 参 
数 。XML 配置 文件 通常 使 用 Resource 对 象 传 入 。 


提示 :… 一 … 一 … 一 … 一 … = - 
Resource 接口 是 Spring 提供 的 资源 访问 接口 ， 通 过 使 用 该 接口 ，Spring 能 以 简单 、 透 明 。 
的 方式 访问 磁盘 、 类 路 径 以 及 网 络 上 的 资源 .关于 Resource 接口 的 详细 介绍 请 看 后 面 内 容 .。 | 


大 部 分 Java EE 应 用 ， 可 在 启动 Web 应 用 时 自动 加 载 ApplicationContext 实例 ， 接 受 Spring 管理 
的 Bean 无 须知 道 ApplicationContext 的 存在 ,一 样 可 以 利用 ApplicationContext 的 管理 。 对 于 独立 的 应 
用 程序 ， 也 可 通过 如 下 方法 来 实例 化 BeanFactory 。 


// 搜 索 当前 文件 路 径 下 的 beans .xml 文件 创建 Resource 对 象 
InputstreamResource isr = new FileSystemResource ("bean.xml"); 
// 以 Resource 对 象 作为 参数 ， 创 建 BeanFactory 实例 

XmlBeanFactory factory = new XmlBeanFactory (isr); 


或 者 采用 如 下 方法 : 
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/1 搜索 类 加 载 路 径 ， 以 类 加 载 路 径 下 的 beans . xml 文件 创建 Resource 对 象 
ClassPathResource res = new ClassPathResource ("beans.xml"); 
// 以 Resource 对 和 象 为 参数 ， 创 建 BeanFactory 实例 

XmlBeanFactory factory = new XmlBeanFactory(res)7 


如 果 应 用 里 有 多 个 属性 配置 文件 ， 则 应 该 采用 BeanFactory 的 子 接口 ApplicationContext 来 创建 
BeanFactory 的 实例 。ApplicationContext 通常 使 用 如 下 两 个 实现 类 : 
> FileSystemXmlApplicationContext : 以 基于 文件 系统 的 XML 配置 文件 创建 
ApplicationContext 实例 。 
> ClassPathXmlApplicationContext: 以 类 加 载 路 径 下 的 XML 配置 文件 创建 ApplicationContext 
实例 。 
如 果 需 要 同时 加 载 多 个 XML 配置 文件 ， 则 可 以 采用 如 下 方式 ; 


// 搜 索 CLASSPATH 路 径 ， 以 CLASSPATH 路 径 下 的 applicationContext .xml、 

//bean,xml、service.xml 文件 创建 ApplicationContext 

ApplicationContext appContext = new ClassPathXmlApplicationContext( 
new String[] ("bean.xml", "service.xml"}); 


当然 也 可 支持 从 基于 文件 系统 的 路 径 来 搜索 配置 文件 , 只 要 使 用 FileSystemXmlApplicationContext 
即 可 ， 如 下 面 的 程序 片段 所 示 : 


// 以 指定 路 径 下 的 bean .xml、service.xml 文件 创建 ApplicationContext 
ApplicationContext appContext ~ new FileSystemxmlApplicationContext( 
new String[] ("bean.xml", "service.xml")); 


由 于 ApplicationContext 本 身 就 是 BeanFactory 的 子 接口 ， 因 此 ApplicationContext 完全 可 以 作为 
Spring 容器 来 使 用 ， 而 且 功能 更 强 。 当 然 ， 如 果 有 需要 ， 也 可 以 把 ApplicationContext 实例 赋 给 
BeanFactory 变量 。 

Spring 配置 文件 的 根 元 素 是 <beans.…/>， 该 元 素 可 以 接受 0 个 到 多 个 <bean.../> 子 元 素 ， 每 个 
<bean.../> 子 元 素 配置 一 个 Bean 实例 。 下 面 是 Spring 最 简单 的 配置 文件 。 

<?xml version="1.0" encoding="GBK"?> 

<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
www,springframework.org/schema/beansw 


tion="http://www.springframework.org/schema/beans 
/ /ww. springframework.org/schema/beans/spring-beans-3.0.xsd"> 


</beans> 
上 面 的 配置 文件 采用 了 XML Schema 来 定义 配置 文件 的 语义 约束 ， 实 际 上 也 可 采用 DTD 来 定义 

配置 文件 的 语义 约束 。 但 如 果 DTD 来 定义 XML 的 语义 约束 ， 则 不 能 使 用 Spring 2.X、Spring 3.0 所 新 
增 的 的 配置 标签 。 使 用 DTD 作为 语义 约束 的 Spring 配置 文件 如 下 : 

<?xml version="1.0" encoding="GBK"?> 

<!-- 指定 Spring 配置 文件 的 DTD 信息 --> 

<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN 2.0//EN" 

"http://www.springframework.org/dtd/spring-beans-2.0.dtd"> 

<!-~ Spring 配置 文件 的 根 元 素 --> 

<beans> 

</beans> 

不 管 是 XML Schema， 还 是 DTD， 它 们 都 详细 规定 了 Spring 配置 文件 里 的 合法 元 素 ， 各 元 素 出 现 
的 先后 顺序 ， 各 元 素 里 的 合法 子 元 素 、 合 法 属性 等 语义 约束 。 读 者 如 果 需 要 更 深入 地 了 解 Spring 配置 
文件 的 详细 信息 ， 应 参考 配置 文件 的 XMLSchema 或 DTD。 


>>7.4.2 使 用 ApplicationContext 


大 部 分 时 候 ， 我 们 都 不 会 使 用 BeanFactory 实例 作为 Spring 容器 ， 而 是 使 用 ApplicationContext 实 
总 了 了 


http://52pdf.taobao.com 
攻 县 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


例 作 为 容器 ， 因 此 我 们 也 把 Spring 容器 称 为 Spring 上 下 文 。ApplicationContext 是 BeanFactory 接口 的 
子 接口 ， 它 增强 了 BeanFactory 的 功能 。 

ApplicationContext 允许 以 声明 式 方式 操作 容器 ， 无 须 手 动 创建 它 。 可 利用 如 ContextLoader 的 支 
持 类 ， 在 Web 应 用 启动 时 自动 创建 ApplicationContext 。 当 然 ， 也 可 以 采用 编程 方式 创建 
ApplicationContext。 

除了 提供 BeanFactory 所 支持 的 全 部 功能 外 ，ApplicationContext 还 有 如 下 额外 的 功能 : 

> ”ApplicationContext 继承 MessageSource 接口 ， 因 此 提供 国际 化 支持 。 
资源 访问 ， 比 如 URL 和 文件 。 
事件 机 制 。 

载 入 多 个 配置 文件 。 
以 声明 式 的 方式 启动 、 并 创建 Spring 容器 。 

ApplicationContext 包括 BeanFactory 的 全 部 功能 ， 因 此 建议 优先 使 用 ApplicationContext。 除 非 对 
于 某 些 内 存 非常 关键 的 应 用 ， 才 考虑 使 用 BeanFactory 。 

当 系 统 创建 ApplicationContext 容器 时 ， 默 认 会 预 初始 化 所 有 的 singleton Bean。 也 就 是 说 ， 当 
ApplicationContext 容器 初始 化 完成 后 ， 容 器 中 所 有 singleton Bean 也 实例 化 完成 。 这 意味 着 : 系统 前 
期 创建 ApplicationContext 时 将 有 较 大 的 系统 开销 ， 但 一 旦 ApplicationContext 初始 化 完成 ， 程 序 后 面 
获取 singleton Bean 实例 时 将 拥有 较 好 的 性 能 。 


> 7.4.3 ApplicationContext 的 国际 化 支持 


入 入 入 


ApplicationContext 接口 继承 MessageSource 接口 ， 因 此 具备 国际 化 功能 。 下 面 是 MessageSource 
接口 中 定义 的 三 个 用 于 国际 化 的 方法 。 

> String getMessage (String code, Object[] args, Locale loc) 

> StringgetMessage (String code, Object[ args, String default, Locale loc) 

> StringgetMessage(MessageSourceResolvable resolvable, Locale locale) 

ApplicationContext 正 是 通过 这 三 个 方法 来 完成 国际 化 的 ， 当 程序 创建 ApplicationContext 容器 时 ， 
Spring 自动 查找 在 配置 文件 中 名 为 messageSource 的 Bean 实例 ， 一 旦 找到 这 个 Bean 实例 ， 上 述 3 个 
方法 的 调用 被 委托 给 该 messageSource Bean。 如 果 没 有 该 Bean，ApplicationContex 会 查找 其 父 定义 中 
的 messageSource Bean; 如 果 找 到 ， 它 被 作为 messageSource Bean 使 用 。 

如 果 无 法 找到 messageSource Bean， 系统 将 会 创建 一 个 空 的 StaticMessageSource Bean, 该 Bean 能 


置 文件 。 
程序 清单 :codes\07V7.418N\src\bean .xml 


<?xml version="1.0" encoding="GBK"?> 

<!-- Spring - 件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语 义 约束 --> 

<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://wuw. springframework.org/schema/beans 
http://waw springfranework.org/schema/beans/spring-beans-3.0.xsd"> 


<list> 
<value>message</value> 
<!-- 如 果 有 多 个 资源 文件 ， 全 部 列 在 此 处 --> 
</list> 
‘</property> 
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</bean> 

</beans> 

上 面 文件 的 粗 体 字 代码 定义 了 一 个 messageSource Bean, 该 Bean 实例 只 指定 了 一 份 国际 化 资源 文 

件 ， 其 baseName 是 message。 

然后 给 出 如 下 两 份 资源 文件 : 

第 一 份 为 美式 英语 的 资源 文件 ， 文 件 名 : message_en_US.properties 

hello=welcome, {0} 

now=now is :{0} 

第 二 份 为 简体 中 文 的 资源 文件 ， 文 件 名 : message.properties。 

hello= 欢 迎 你 , {0} 

now= 现 在 时 间 是 : {0} 

因为 该 资源 文件 中 包含 了 非 西欧 文字 ， 因 此 ， 应 使 用 native2ascii 工具 将 这 份 资源 文件 国际 化 ， 命 


令 如 下 : 
native2ascii message.properties message_zh_CN.properties 
执行 上 面 的 命令 后 将 看 到 系统 会 多 出 一 个 message_zh_CN.properties 文件 , 该 文件 将 作为 简体 中 文 
实际 的 国际 化 资源 文件 。 此 时 ， 程 序 拥有 了 两 份 资源 文件 ， 可 以 自 适应 美式 英语 和 简体 中 文 的 环境 。 
主 程序 部 分 如 下 。 
程序 清单 : codes\07\7.4\I18N\src\lee\SpringTest.java 
public class SpringTest 
{ 
public static void main(String[] args)throws Exception 
{ 
// 实 例 化 ApplicationContext 
ApplicationContext ctx = new 
ClassPathXmlApplicationContext ("bean.xml"); 
// 创 建 参数 数组 
Stringf] a = {" 读 者"}; 
// 使 用 getMessage 方法 获取 本 地 化 消息 . Locale 的 getDefault 方法 
// 返 回 计算 机 环境 的 默认 Locale 
String hello = ctx.getMessage("hello" , a,Locale.getDefault()); 
‘Object[] b = {new Date()}; 
String now = ctx.getMessage ("now" , b,Locale.getDefault()); 
Wt ph 
System.out.println (hello); 
System.out .println (now); 
} 
} 
上 面 的 两 条 粗 体 字 代码 是 Spring 容器 提供 的 获取 国际 化 消息 的 方法 ,这 两 个 方法 由 MessageSource 
接口 提供 。 
Rte 千 果 会 随 环境 不 同 而 改变 ， 在 简体 中 文 的 环境 下 ， 执 行 结果 如 下 : 


迎 你 ,读者 
2 08-7-9 下 午 12:18 
在 美国 英语 的 环境 下 ， 执 行 结果 如 下 ; 


welcome, 读 者 
now is:7/9/08 12:20 pM 


当然 ， 即 使 在 英文 环境 下 ,“ 读 者 ”这 个 词 都 无 法 变 成 英文 ， 因 为 “读者 ”是 写 在 程序 代码 中 ， 而 
Et 


未. 法 总 :* - 
Spring 的 国际 化 支持 ， 其 实 是 建立 在 Java 程序 国 际 化 的 基础 之 上 其 核 路 部 是 
将 程序 中 需要 实现 国际 化 的 信息 写 入 资源 文件 ， 和 息 的 Key. 村 
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> 7.4.4 ApplicationContext 的 事件 机 制 


ApplicationContext 的 事件 机 制 是 观察 者 设计 模式 的 实现 ， 通 过 ApplicationEvent 类 和 Application- 
Listener 接口 ， 可 以 实现 ApplicationContext 的 事件 处 理 。 如 果 容器 中 有 一 个 ApplicationListener Bean， 
每 当 ApplicationContext 发 布 ApplicationEvent 时 ，ApplicationListener Bean 将 自动 被 触发 。 

Spring 的 事件 框架 有 如 下 两 个 重要 成 员 。 

> ApplicationEvent: 容器 事件 ， 必 须 由 ApplicationContext 发 布 。 

> ”ApplicationListener: 监听 器 ， 可 由 容器 中 的 任何 监听 器 Bean 担任 。 

实际 上 ，Spring 的 事件 机 制 与 所 有 事件 机 制 都 基本 相似 ， 它 们 都 需要 事件 源 、 事 件 和 事件 监听 器 
组 成 。 只 是 此 处 的 事件 源 是 ApplicationContext， 且 事件 必须 由 Java 程序 显 式 触发 。 图 7.10 简单 示范 
了 ApplicationContext 的 事件 流程 。 


epscaaonCoraead 
本 
入 oorcanonE wert 从 

opecaon stener 
Wh 
ooowaponEver0 广 入 
Apptc monEvent 

汤 作 5 方法 


br 
图 7.10 Spring 容器 的 事件 机 制 示意 图 


下 面 的 程序 将 示范 Spring 容器 的 事件 机 制 。 程 序 先 定义 了 一 个 ApplicationEvent 类 ， 其 对 象 就 是 


-个 Spring 容器 事件 。ApplicationEvent 类 代码 如 下 。 
程序 清单 : codes\07\7.4\EventHandler\src\org\crazyit\app\event\EmailEvent.java 
public class EmailEvent 


{ 
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extends ApplicationEvent 


private String address; 
private String text; 
public EmailEvent (Object source) 
下 
super(source) 


} 
// 定 义 一 个 有 参数 的 构造 器 。 
public EmailEvent (Object source ， 
String address ，String text) 
{ 
super (source); 
this.address = address; 
this.text = text7 


) 
//address 属性 的 setter 和 getter 方 法 
public void setaddress (String address) 
{ 

this.address = address; 


} 
public String getAddress() 
{ 
return this.address; 
于 
//text 属性 的 setter 和 getter 方法 三 - 
public void setText (String text) 人 


{ 
this.text = text; 
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} 
public String getText() 
{ 

return this.text; 
上 


上 面 的 EmailEvent 类 继承 了 ApplicationEvent 类 ， 除 此 之 外 ， 它 就 是 一 个 普通 Java 类 。 
容器 事件 的 监听 器 类 必须 实现 ApplicationListener 接口 ， 实 现 该 接口 必须 实现 如 下 方法 。 
> ”onApplicationEvent(ApplicationEvent event): 每 当 容器 内 发 生 任何 事件 时 , 此 方法 都 被 触发 。 
本 例 所 用 的 容器 监听 器 类 代码 如 下 。 
程序 清单 :codes\07\7.4\EventHandler\src\org\crazyit\app\listener\EmailNotifierjava 
public class EmailNotifier 
implements ApplicationListener 


// 该 方法 会 在 容器 发 生 事件 时 自动 触发 
public void onApplicationEvent (ApplicationEvent evt) 


if (evt instanceof EmailEvent) 
{ 
// 只 处 理 EmailEvent， 发 送 email 通知 ... 
EmailEvent emailEvent = (EmailEvent)evt; 
System.out .println(" 需 要 发 送 邮件 的 接收 地 址 ” 
+ emailEvent .getRddress() )7 
System.out .println ("需要 发 送 邮件 的 邮件 正文 " 
+ emailEvent.getText ()); 


// 容 器 内 置 事件 不 作 任 何 处 理 
System,out.println(" 容 器 本 身 的 事件 : ”+ evt)7 


将 监听 器 配置 在 容器 中 ， 配 置 文件 如 下 。 
程序 清单 : codes\07\7.4\EventHandlen\src\bean.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3,0.xsd 语义 约束 -> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans" 
xsi;schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 监听 器 --> 
<bean class="org.crazyit.app.listener.EmailNotifier"/> 
</beans> 
从 上 面 的 粗 体 字 代 码 可 以 看 出 ， 为 Spring 容器 注册 事件 监听 器 ， 不 需要 像 AWT 编程 那样 采用 代 
码 进行 编程 ,只 要 进行 简单 配置 即 可 。 当 我 们 在 Spring 中 配置 一 个 实现 了 ApplicationListener 的 Bean， 
Spring 容器 就 会 把 这 个 Bean 当成 容器 事件 的 监听 器 。 
当 系 统 创建 Spring 容器 、 加 载 Spring 容器 时 会 自动 触发 容器 事件 ， 容 器 事件 监听 器 可 以 监听 到 这 
些 事件 。 除 此 之 外 ， 程 序 也 可 调用 ApplicationContext 的 pulishEvent0 方 法 来 主动 触发 容器 事件 。 如 下 
主 程序 使 用 ApplicationContext 的 publishEvent 来 触发 事件 。 
程序 清单 :codes\07\7.4\EventHandler\src\lee\SpringTest.java 


Public class SpringTest 
{ 
public static void main(string[] args) 
{ 
ApplicationContext ctx = new 
ClassPathXmlApplicationContext ("bean. xml"); 
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// 创 建 一 个 ApplicationEvent 对 象 
EmailEvent ele = new EmailEvent 
("hello", "spring_test@163.com" 

,"this is a test"); 

// 主 动 触发 容器 事件 

ctx.publishEvent (ele) ; 

} 
】 


上 面 程序 中 的 两 行 粗 体 字 代码 创建 了 ApplicationEvent 对 象 , 并 通过 ApplictionContext 主动 触发 了 
该 事件 。 运 行 上 面 的 程序 ， 将 看 到 如 下 执行 结果 : 
容器 本 身 的 事件 : 。 org.springframework.context.event.ContextRefreshed 
Event [source=org. springframework. context. support.ClassPathxmlApplicationContext@ 
a01335: startup date [Tue Nov 23 14:24:35 CST 2010]; root of context hierarchy] 


需要 发 送 邮件 的 接收 地 址 spring_test@163.com 
需要 发 送 邮件 的 邮件 正文 this is a test 


从 上 面 的 执行 结果 可 以 看 出 ， 监 昕 器 不 仅 监听 到 程序 所 触发 的 事件 ， 也 监听 到 容器 内 得 的 事件 。 
乐 上 ， 如 果 开 发 者 需要 在 Spring 容器 初始 化 、 销 毁 时 回调 自 定义 方法 ， 就 可 以 通过 上 面 的 事件 监听 


如 果 Bean 起 发 布 事件 ， 则 Bean 必须 获得 其 容器 的 引用 。 如 果 程序 中 没有 直接 攻取 
| 容器 的 引用 ， 则 应 该 让 Bean 实现 ApplicationContextAware 或 BeanFactoryAware 接口， 
| 从 而 可 以 获得 容器 的 引用 。 请 参考 后 面 获得 容器 的 引用 章节 . 


Spring 提供 如 下 几 个 内 署 事 件 

> ContextRefreshedEvent: ApplicationContext 容器 初始 化 或 刷新 触发 该 事件 。 此 处 的 初始 化 
是 指 ， 所 有 Bean 被 成 功 装载 ， 后 处 理 Bean 被 检测 并 激活 ， 所 有 Singleton Bean 被 预 实例 
化 ， ApplicationContext 容器 已 就 绪 可 用 。 

> ”ContextStartedEvent， 当 使 用 ConfigurableApplicationContext (ApplicationContext 的 子 接 
口 ) 接口 的 start() 方法 启动 ApplicationContext 容器 时 触发 该 事件 。 容 器 管理 生命 周期 的 
Bean 实例 将 获得 一 个 指定 的 启动 信号 ， 这 在 经 常 需要 停止 后 重新 启动 的 场合 比较 常见 。 

> ”ContextClosedEvent 当 使 用 ConfigurableApplicationContext (ApplicationContext 的 子 接 
口 ) 接口 的 close() 方法 关闭 ApplicationContext 容器 时 触发 该 事件 。 

> ContextStoppedEvent: 当 使 用 ConfigurableApplicationContext (ApplicationContext 的 子 
接口 ) 接口 的 stop() 方 法 使 ApplicationContext 停止 时 触发 该 事件 。 此 处 的 “停止 ”意味 着 
容器 管理 生命 周期 的 Bean 实例 将 获得 一 个 指定 的 停止 信号 , 被 停止 的 Spring 容器 可 再 次 调 
用 start() 方 法 重新 启动 。 

> ”RequestHandledEvent: Web 相关 的 事件 , 只 能 应 用 于 使 用 DispatcherServlet 的 Web 应 用 。 
在 使 用 Spring 作为 前 端的 MVC 控制 器 时 , 当 Spring 处 理 用 户 请 求 结束 后 , 系统 会 自动 触发 


>》>7.4.5 让 Bean 获取 Spring 容器 


前 面 介绍 了 儿 个 例子 ， 我 们 看 到 的 都 是 程序 先 创建 Spring 容器 ， 再 调用 Spring 容器 的 getBean0 
方法 来 获取 Spring 容器 中 的 Bean。 在 这 种 访问 模式 下 ， 程 序 中 总 是 持 有 Spring 容器 的 引用 
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但 在 实际 应 用 中 ,尤其 是 Web 应 用 中 ，Spring 容器 通常 采用 声明 式 方式 配置 产生 : 开发 者 只 要 在 
web.xml 文件 中 配置 一 个 Listener， 该 Listener 将 会 负责 初始 化 Spring 容器 。 前 端 MVC 框架 可 以 直接 
调用 Spring 容器 (无须 访问 Spring 容器 本 身 )。 在 这 种 情况 下 ， 容 器 中 Bean 处 于 容器 管理 下 ， 无 须 主 
动 访问 容器 ， 只 需 接受 容器 的 注入 管理 即 可 。Bean 实例 的 依赖 关系 通常 由 容器 动态 注入 ， 无 须 Bean 
实例 主动 请 求 。 

在 这 种 情况 下 ，Spring 容器 中 Bean 通常 不 会 需要 访问 容器 中 其 他 的 Bean 一 一 采用 依赖 注入 ， 让 
Spring 把 被 依赖 的 Bean 注入 到 依赖 Bean 中 即 可 。 但 在 某 些 特殊 情况 下 ， 容 器 中 的 Bean 可 能 需要 主 
动 访问 Spring 容器 本 身 ，Spring 也 为 这 种 需求 做 好 了 准备 。 

实现 BeanFactoryAware 接口 的 Bean， 拥 有 访问 BeanFactory 容器 的 能 力 ， 实 现 BeanFactoryAware 
接口 的 Bean 实例 被 容器 创建 以 后 ， 它 会 拥有 一 个 引用 ， 该 引用 指向 创建 它 的 BeanFactory 。 
BeanFactoryAware 接口 只 有 如 下 一 个 方法 。 

> ”setBeanFactory(BeanFactory beanFactory): 该 方法 有 一 个 参数 beanFactory， 该 参数 指向 

创建 它 的 BeanFactory。 

大 部 分 初学 者 看 到 这 个 setter 方法 会 感到 比较 奇怪 ， 因 为 以 前 当 我 们 定义 一 个 setter 方法 时 ， 该 
setter 方法 通常 都 是 由 程序 员 来 调用 的 ，setter 方法 参数 由 程序 员 指定 ， 即 使 使 用 Spring 依赖 注入 时 ， 
setter 方法 参数 值 也 是 由 程序 员 通过 配置 文件 来 指定 的 。 但 此 处 的 这 个 setter 方法 比较 奇怪 ， 这 个 方法 
将 由 Spring 调用 ，Spring 调用 该 方法 时 会 将 Spring 容器 作为 参数 传 入 该 方法 。 与 该 接口 类 似 的 还 有 
BeanNameAware、ResourceLoaderAware 接口 ， 这 些 接口 里 都 会 提供 类 似 的 setter 方法 ， 这 些 方法 也 由 
Spring 负责 调用 。 

与 BeanFactoryAware 接口 类 似 的 有 : ApplicationContextAware 接口 ,实现 该 接口 的 Bean 需要 时 下 

-个 setApplicationContext(ApplicationContext applicationContext) 方 法 该 方法 也 不 是 由 程序 员 负 责 
调用 的 ， 而 是 由 Spring 来 调用 的 。 当 Spring 容器 调用 该 方法 时 ， 它 会 把 自身 作为 参数 传 入 该 方法 。 
程序 清单 :codes\07\7.4\BeanFactoryAware\src\org\crazyit\app\service\Chinese.java 


// 定 义 Bean 类 ， 实 现 ApplicationContextAware 接口 
// 该 类 将 拥有 访问 容器 的 能 力 
public class Chinese 

implements ApplicationContextAvare 


{ 

// 将 BeanFactory 容器 以 成 员 变 量 保存 

private ApplicationContext ctx; pr 
/ss 

* 实现 ApplicationContextAware 接口 必须 实现 的 方法 

* @param ctx 创建 bean 实例 的 ApplicationContext 

Wa 
public void setApplicationContext (ApplicationContext ctx) 

throws BeansException 


{ 
this.ctx = ctxi 


} 
// 获 得 ApplicationContext 的 测试 方法 
public ApplicationContext getContext () 
{ 
return ctx7 
} 
} 


上 面 的 Chinese 类 实现 了 ApplicationContextAware 接口 ， 并 实现 了 该 接口 提供 的 setApplication 
ContextAware 0 方法 ， 这 就 使 得 该 Bean 实例 可 以 直接 访问 到 创建 它 的 Spring 容器 。 

将 该 Bean 部 署 在 Spring 容器 中 ， 部署 该 Bean 与 部 署 其 他 Bean 没有 任何 区 别 。 XML 配置 文件 如 下 。 

程序 清单 : codes\07\7.4\BeanFactoryAware\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
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<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmins="http: //www. springframework.org/schema/beans" 
xsi:schemaLocation="http://wuw.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 一 个 Bean 实例 --> 
<bean id="chinese" class="org.crazyit.app.service.Chinese"/> 
</beans> 


主 程序 部 分 进行 简单 测试 ， 程 序 先 通过 实例 化 的 方法 来 获得 ApplicationContext， 然 后 再 通过 
chinese Bean 来 获得 BeanFactory， 并 将 二 者 进行 比较 。 主 程序 如 下 。 
程序 清单 : codes\07\7.4\BeanFactory Aware\src\lee\SpringTestjava 


public class SpringTest 
{ 


public static void main(String[] args)throws Exception 

{ 
ApplicationContext ctx = new 

ClassPathxmlApplicationContext ("bean.xml")» 

Chinese p = ctx.getBean("chinese" , Chinese.class); 
// 打 印 出 Chinese 实例 获得 的 ApplicationContext 
System.out.println(p.getContext()); 
// 比 较 两 种 方法 获得 的 BeanFactory 
System.out.println (ctx 一 p.getCcontext()); 

} 

} 


程序 运行 结果 如 下 : 


true 


实现 ApplicationContextAware 接口 让 Bean 拥有 了 访问 容器 的 能 力 ， 但 污染 了 代码 ， 导 致 代码 与 
Spring 接口 耦 台 在 一 起 。 因 此 ， 如 果 不 是 特别 必要 ， 建 议 不 要 直接 访问 容器 。 


7.5 Spring 容器 中 的 Bean 


从 本 质 上 来 看 ，Spring 容器 就 是 一 个 “超大 型 ”工厂 ，Spring 容器 中 的 Bean 就 是 该 工厂 的 产品 。 
Spring 容器 能 产生 哪些 产品 ， 则 完全 取决 于 开发 者 在 配置 文件 中 的 配置 。 


总 对 于 开发 者 来 说 ,开发 者 使 用 Spring 框架 所 做 的 主要 是 两 件 事 : D 开 发 Bean; @ 配 置 Bean，| 
区 对 于 Spring 框架 来 说 ， 它 要 做 的 ， 就 是 根据 配置 文件 来 创建 Bean 实例 ， 并 调用 Bean 实例 的 
| 方法 完成 “ 依 术 注入 ”一 一 这 就 是 所 谓 JoC 的 本 质 ， 这 就 要求 开发 者 在 使 用 Spring 框架 时 ， | 
眼中 看 到 的 “XML 配置 "， 心 中 想 的 是 “Java 代码 "。 后 面 介绍 Spring 框架 时 ， 笔 者 会 尽量 向 | ! 

| 。 读者 揭示 “每 段 XML 配置 ”在 底层 所 对 应 的 “Java 代码 调用 ”。 


>>7.5.1 Bean 的 基本 定义 


<beans... 人 > 元 素 是 Spring 配置 文件 的 根 元 素 ， 该 元 素 可 以 指定 如 下 属性 。 

> default-lazy-init， 指定 该 <beans.../> 元 素 下 配置 的 所 有 Bean 默认 的 延迟 初始 化 行为 。 

> default-merge: 指定 该 <beans.../> 元 素 下 配置 的 所 有 Bean 默认 的 merget 行为 。 

> ”default-autowire: 指定 该 <beans.…/> 元 素 下 配置 的 所 有 Bean 默认 的 自动 装配 行为 。 

> ”default-autowire-candidates: 指定 该 <beans.../> 元 素 下 配置 的 所 有 Bean 默认 是 否 作为 自动 
装配 的 候选 Bean。 

default-init-method: 指定 该 <beans.… 人 元 素 下 配置 的 所 有 Bean 默认 的 初始 化 方法 。 
default-destroy-method: 指定 该 <beans.../> 元 素 下 配置 的 所 有 Bean 默认 的 回收 方法 。 
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提示 :元 才 上 而 所 能 搞定 的 局部 以 在 第 个 <br 记 于 元 来 中 措 定 将 属 如 去 | 
掉 default 即 可 . 区 别 是 : 为 <bean.. 人 > 元 素 指定 这 些 属性 ,只 对 特定 Bean 起 作用 ; 如 果 在 <beans… | 

| 。 户 元 素 上 指定 这 些 属性 ， 这 些 属性 将 会 对 <beans .人 > 包 含 的 所 有 Bean 都 起 作用 。 类 似 的 是 ， 当 : 
二 者 所 指定 的 属性 不 一 致 时 ，<bean../> 上 指定 的 属性 会 履 盖 <beans../> 上 指定 的 属性 。 | 


<bean... 人 > 元 素 是 <beans... 亿 元 素 的 子 元 素 ，<beans... 人 > 元 素 可 以 包含 多 个 <bean... 人 > 子 元 素 ， 每 个 
<bean.../> 子 元 素 定义 一 个 Bean， 每 个 Bean 对 应 Spring 容器 里 的 一 个 Java 实例 。 
定义 Bean 时 ， 通 常 需要 指定 两 个 属性 。 
> id: 确定 该 Bean 的 唯一 标识 符 ， 容 器 对 Bean 管理 、 访 问 ， 以 及 该 Bean 的 依赖 关系 ， 都 通 
过 该 属性 完成 。Bean 的 id 属性 在 Spring 容器 中 应 该 是 唯一 的 。 
> class: 指定 该 Bean 的 具体 实现 类 ， 这 里 不 能 是 接口 。Spring 容器 必须 知道 创建 Bean 的 实 
现 类 ， 而 不 能 是 接口 。 通 常情 况 下 ，Spring 会 直接 使 用 new 关键 字 创 建 该 Bean 的 实例 ， 因 
此 ， 这 里 必须 提供 Bean 实现 类 的 类 名 。 
id 属性 是 容器 中 Bean 的 唯一 标识 ， 这 个 id 属性 必须 遵循 XML 文档 的 id 属性 规则 ， 因 此 有 一 些 
特殊 要 求 ， 例 如 不 能 以 “/” 等 特殊 符号 作为 属性 值 。 但 在 某 些 特殊 时 候 ，Bean 的 标识 必须 包含 这 些 
特殊 符号 ， 此 时 可 以 采用 name 属性 , 用 于 指定 Bean 的 别名 , 通过 访问 Bean 别名 也 可 访问 Bean 实例 。 


村 


: 在 一 些 特 球 的 情况 下 、 Spring 会 采用 其 他 方式 创建 Bean 实例 ， 例如 工厂 方法 等 ， 出 
| 可 能 不 再 需要 class 属性 ， 这 此 内容 需要 参考 后 桓 的 儿 


下 面 给 出 包含 两 个 Bean 定义 的 简单 配置 文件 。 

<?xml version="1.0" encoding="GBK"?> 

<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http: //www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 第 一 个 Bean 实例 bean1， 对 应 的 实现 类 为 lee. Test1 --> 
<bean id="beanl” class="lee.Test1”/> 
<!-- 定义 第 二 个 Bean 实例 bean2， 对 应 的 实现 类 为 lee.Test2 --> 
<bean id="bean2” class="lee.Test2”/> 

</beans> 


Spring 容器 集中 管理 Bean 的 实例 化 ，Bean 实例 可 以 通过 BeanFactory 的 getBean(String beanid) 方 
法 得 到 , BeanFactory 变 成 简单 工厂 模式 里 的 工厂 , 程序 只 需要 获取 BeanFactory 引用 , 即 可 获得 Spring 
容器 管理 全 部 实例 的 引用 。 程 序 不 需要 与 具体 实例 的 实现 过 程 耦合 。 大 部 分 Java EE 应 用 里 ， 应 用 在 
启动 时 ,会 自动 创建 Spring 容器 ,组 件 之 间 直 接 以 依赖 注入 的 方式 耦合 ， 甚 至 无 须 主动 访问 Spring 容 
器 本 身 。 

当 我 们 在 配置 文件 中 通过 <bean id="xxx" class="lee.XxxClass"/> 方 法 配置 一 个 Bean 时 ， 这 样 要 求 
该 Bean 实现 类 必须 有 一 个 无 参数 的 构造 器 ， 因 此 Spring 底层 相当 于 调用 了 如 下 代码 : 

xxx = new lee.XxxClass() 


pe 
| 需要 注意 的 是 ,Spring 框架 从 XML 配置 文件 中 解析 出 来 Bean 的 这 、class 都 是 字符 


串 ， 因 此 Spring 只 能 通过 反射 来 完成 上 面 粗 体 字 代码 的 调用 . 关于 Java 反射 的 知识 , 请 . 
参考 疯狂 Java 体系 的 《疯狂 Java 讲义 》. 可 
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如 果 在 配置 文件 中 通过 构造 注入 来 创建 Bean， 配 置 代码 如 下 : 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans™" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 第 一 个 Bean 实例 bean1， 对 应 的 实现 类 为 lee.Testl --> 
<bean id="beanl” class="lee.Test1"> 
<constructor-arg value="hello"/> 
<constructor-arg value="23"/> 
</bean> 
</beans> 
上 面 的 粗 体 字 代码 相当 于 让 Spring 调用 如 下 代码 : 
beanl = new lee.Testl("hello" , "23"); OO 
由 于 Spring 本 身 提 供 了 功能 强大 类 型 转换 机 制 ， 因 此 如 果 lee.Testl 只 包含 一 个 Testl(String ，int) 
构造 器 ， 那 么 上 面 的 粗 体 字 配 置 文件 相当 于 让 Spring 执行 如 下 代码 : 
beanl = new lee.Testl ("hello" , 23); //® 
这 就 有 了 一 个 问题 ， 如 果 lee.Testl 类 既 有 Test1(String ,String) 构 造 器 ， 又 有 Testl(String ,int) 构 造 
器 ,那么 上 面 的 粗 体 字 配 置 文件 到 底 让 Spring 执行 哪 行 代码 呢 ? 答案 是 号 代码 ,因为 Spring 的 配置 
文件 还 不 够 强大 : 对 于 <constructor value="23"/>，Spring 只 能 解析 出 一 个 "23" 字 符 串 ,但 它 到 底 需 要 转 
换 为 哪 种 数据 类 型 一 一 从 配置 文件 中 看 不 出 来 ， 只 能 是 根据 lee.Testl 的 构造 器 来 尝试 转换 。 


一 


名 如 它 要 配置 一 个 字符 事 值 ， 用 : <string value="crazyitorg" >; 它 要 配置 一 个 可 型 值 ， 则 用 : | 
| <int value="23"/>. ] 
除了 可 以 为 <bean... 人 > 元 素 指 定 一 个 id 属性 之 外 ， 还 可 以 为 <bean.. 人 > 元 素 指定 name 属性 ， 用 于 为 

Bean 实例 指定 别名 。 
<bean... 人 > 元 素 的 id 属性 具有 唯一 性 ， 而 且 是 一 个 真正 的 XML ID 属性 ， 因 此 其 他 XML 元 素 在 

引用 该 刘 时 ， 可 以 利用 XML 解析 器 的 验证 功能 。 

由 于 XML 规范 规定 了 XML ID 标识 符 必须 由 字母 和 数字 组 成 ， 且 只 能 以 字母 开头 ， 但 在 一 些 特 

殊 情况 下 《例如 与 Stmutsl 整合 过 程 中 )， 我 们 必须 为 控制 器 Bean 指定 特殊 标识 名 ， 此 时 就 必须 为 控制 

器 Bean 指定 别名 。 

如 果 需 要 为 Bean 实例 指定 多 个 别名 ,可 以 在 name 属性 中 使 用 逗号 、 冒 号 或 者 空格 来 分 隔 多 个 别 

名 ， 后 面 遂 过 任 一 别名 即 可 访问 该 Bean 实例 。 

在 一 些 极端 的 情况 下 ， 程 序 无 法 在 定义 Bean 时 就 指定 所 有 的 别名 ， 而 是 需要 在 其 他 地 方 为 一 个 

已 经 存在 的 Bean 实例 指定 别名 ， 则 可 使 用 <alias... 人 > 元 素来 完成 ， 该 元 素 可 指定 如 下 两 个 属性 。 
> 。 name: 该 属性 指定 一 个 Bean 实例 的 标识 名 ， 表 明 将 为 该 Bean 实例 指定 别名 。 
> alias: 指定 一 个 别名 。 

如 以 下 代码 示例 : 
<alias name="person" alias="jack"/> 
<alias name="jack" alias="jackee"/> 


在 默认 情况 下 ， 当 Spring 创建 ApplicationContext 容器 时 ，Spring 会 自动 预 初始 化 容器 中 所 有 的 
singleton 实例 ， 如 果 我 们 不 想 让 Spring 容器 预 初始 化 某 个 singleton Bean， 则 可 为 该 <bean... 人 > 元 素 增加 
lazy-init 属性 ， 指 定 该 属性 为 we， 则 Spring 不 会 预 初始 化 该 Bean 实例 ， 如 下 面 的 配置 文件 所 示 。 


<bean id="bean2" class="lee.Test2" lazy-init="true"/> 
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>》>7.5.2 容器 中 Bean 的 作用 域 


当 通 过 Spring 容器 创建 一 个 Bean 实例 时 ， 不 仅 可 以 完成 Bean 实例 的 实例 化 ， 还 可 以 为 Bean 指 
定 特定 的 作用 域 。Spring 支持 如 下 5 种 作用 域 。 

> singleton: 单 例 模式 , 在 整个 Spring loC 容器 中 ,使 用 singleton 定义 的 Bean 将 只 有 一 个 实例 。 

> ”prototype: 原型 模式 ， 每 次 通过 容器 的 getBean 方法 获取 prototype 定义 的 Bean 时 ， 都 将 

产生 一 个 新 的 Bean 实例 。 
> ”request: 对 于 每 次 HTTP 请 求 ， 使 用 request 定义 的 Bean 都 将 产生 一 个 新 实例 , 即 每 次 HTTP 
请 求 将 会 产生 不 同 的 Bean 实例 。 只 有 在 Web 应 用 中 使 用 Spring 时 ， 该 作用 域 才 真正 有 效 。 

> ”session: 对 于 每 次 HTTP Session， 使 用 session 定义 的 Bean 都 将 产生 一 个 新 实例 ， 即 每 
次 HTTP Session 都 将 产生 不 同 的 Bean 实例 。 只 有 在 Web 应 用 中 使 用 Spring 时 ， 该 作用 
域 才 真正 有 效 。 

> ”global session: 每 个 全 局 的 HTTP Session 对 应 一 个 Bean 实例 .典型 情况 下 , 仅 在 使 用 portlet 

context 的 时 候 有 效 。 只 有 在 Web 应 用 中 使 用 Spring 时 ， 该 作用 域 才 真 正 有 效 。 

比较 常用 的 是 singleton 和 prototype 两 种 作用 域 ， 对 于 singleton 作用 域 的 Bean， 每 次 请 求 该 Bean 
都 将 获得 相同 实例 。 容 器 负责 跟踪 Bean 实例 的 状态 ， 负 责 维护 Bean 实例 的 生命 周期 行为 ， 如 果 一 个 
Bean 被 设置 成 prototype 作用 域 ， 程 序 每 次 请 求 该 id 的 Bean，Spring 都 会 新 建 一 个 Bean 实例 ， 然 后 
返回 给 程序 。 在 这 种 情况 下 ，Spring 容器 仅仅 使 用 new 关键 字 创建 Bean 实例 ， 一 旦 创建 成 功 ， 容 器 
不 再 跟踪 实例 ， 也 不 会 维护 Bean 实例 的 状态 。 

如 果 不 指定 Bean 的 作用 域 ，Spring 默认 使 用 singleton 作用 域 。Java 在 创建 Java 实例 时 ， 需 要 进 
行内 存 申请 ;销毁 实例 时 ， 需 要 完成 垃圾 回收 ， 这 些 工 作 都 会 导致 系统 开销 的 增加 。 因 此 ，prototype 
作用 域 Bean 的 创建 、 销 毁 代价 比较 大 。 而 singleton 作用 域 的 Bean 实例 一 旦 创建 成 功 ， 可 以 重复 使 
用 。 因此, 除非 必要 , 否则 尽量 避免 将 Bean 设置 成 prototype 作用 域 。 关 于 改变 Bean 的 生命 周期 行为 ， 
请 参 后 面 的 相关 知识 。 

设置 Bean 的 基本 行为 , 通过 scope 属性 指定 , 该 属性 可 以 接受 singleton、 prototype、 request、 session 
和 globalSession 5 个 值 ， 分 别 代表 上 面 介绍 的 5 个 作用 域 。 

下 面 的 配置 文件 中 配置 singleton 和 prototype Bean 各 有 一 个 。 

程序 清单 :codes\07\7.5\scope\src\beans.xml 


<2?xml version="1.0" encoding="GBK"?> 

<!-- spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 一 个 singleton Bean 实例 --> 
<bean id="pl" class="org.crazyit.app. service.Person"/> 
<!-- 配置 一 个 prototype Bean 实例 --> 
<bean id="p2" class="org.crazyit.app.service.Person" 

scope="prototype"/> 


</beans> 

从 上 面 的 两 行 粗 体 字 代码 中 可 以 看 到 ， 配 置 pl 对 象 时 没有 指定 scope 属性 ， 则 它 默 认 是 一 个 
singleton Bean; 而 p2 则 指定 一 个 prototype Bean。 主 程序 通过 如 下 代码 来 测试 两 个 Bean 的 区 别 。 

程序 清单 :codes\07\7.5\scope\src\lee\BeanTestjava 


Public class BeanTest 
{ 
public static void main(String[] args)throws Exception 


{ 
// 以 类 加 载 路 径 下 的 beans . xml 文件 创建 Spring 容器 
ApplicationContext ctx = new 
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ClassPathXmlApplicationContext ("bean.xml"); 
// 判 断 两 次 请 求 singleton 作用 域 的 Bean 实例 是 否 相等 
System.out.println (beanFactory.getBean ("p1") 
一 beanFactory.getBean ("pl1")); 
// 判 断 两 次 请 求 Prototype 作用 域 的 Bean 实例 是 否 相等 
System.out.println (beanFactory.getBean ("p2") 
一 beanFactory.getBean("p2")); 
了 
} 


程序 执行 结果 如 下 : 
true 
false 


从 上 面 的 运行 结果 可 以 看 出 : 对 于 singleton 作用 域 的 Bean， 每 次 请 求 该 id 的 Bean， 都 将 返回 同 
一 个 共享 实例 ， 因 而 两 次 获取 的 Bean 实例 完全 相同 ， 但 对 prototype 作用 域 的 Bean， 每 次 请 求 该 id 
的 Bean 都 将 产生 新 的 实例 ， 因 此 两 次 请 求 获得 Bean 实例 不 相同 


提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 
早期 指定 Bean 的 作用 域 也 可 通过 singleton 属性 指定 ， 该 属性 只 接受 两 个 属性 值 : | 
和 false， 分 别 代表 singleton 和 prototype 的 作用 域 。 使 用 singleton 属性 则 无 法 指定 其 他 三 | 
个 作用 域 ， 实 际 上 Spring 2.X 不 推荐 使 用 singleton 属性 指定 Bean 的 作用 域 ，singleton 属 
性 是 Spring 1.2.x 的 方式 。 | 
对 于 request 作用 域 ， 查 看 如 下 Bean 定义 : 
<bean id="loginAction" class="org.crazyit.app. struts.LoginAction" scope="requsst"/> 
针对 每 次 HTTP 请 求 ，Spring 容器 会 根据 loginAction Bean 定义 创建 一 个 全 新 的 LoginAction Bean 
实例 ， 且 该 loginAction Bean 实例 仅 在 当前 HTTP Request 内 有 效 。 因 此 ， 如 果 程 序 需要 ， 完 全 可 以 自 
由 更 改 Bean 实例 的 内 部 状态 ; 其 他 请 求 所 获得 的 loginAction Bean 实例 无 法 感觉 到 这 种 内 部 状态 的 改 
变 。 当 处 理 请 求 结 束 时 ，request 作用 域 的 Bean 实例 将 被 销毁 。 
元 提示 ;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
request、session 作用 域 的 Bean 只 对 Web 应 用 才 真 正 有 效 . 实际 上 通常 只 会 将 Web … 
应 用 的 控制 器 Bean 才 指定 成 request 作用 域 . | 


Session 作用 域 与 request 作用 域 完 全 类 似 ， 区 别 在 于 : request 作用 域 的 Bean 对 于 每 次 HTTP 请 求 
有 效 ， 而 session 作用 域 的 Bean 则 对 于 每 次 HTTP Session 有 效 。 
request 和 session 作用 域 只 在 Web 应 用 中 才 有 效 , 并 且 必 须 在 Web 应 用 中 增加 额外 配置 才 会 生效 。 
为 了 让 request 和 session 两 个 作用 域 生效 , 必须 将 HTTP 请 求 对 象 绑 定 到 为 该 请 求 提供 服务 的 线程 上 ， 
这 使 得 具有 request 和 session 作用 域 的 Bean 实例 能 够 在 后 面 的 调用 链 中 被 访问 到 。 
为 此 ， 我 们 需要 有 两 种 配置 方式 ;采用 Listener 配置 或 采用 Filter 配置 。 
当 使 用 支持 Servlet 2.4 及 以 上 规范 的 Web 容器 时 , 我 们 可 以 在 Web 应 用 的 web.xml 文件 中 增加 如 
下 Listener 配置 ， 该 Listener 负责 为 request 作用 域 生效 。 
程序 清单 : codes\07\7.5\requestScope\WEB-INF\web.xml 
<web-app> 


<listener> 
<listener-class>org. springframework .web. 

Context. request.RequestContextListener</listener-class> 
</listener> 


</web-app> 
如 果 使 用 了 只 支持 Servlet 2.4 以 前 规范 的 Web 容器 ， 则 该 容器 不 支持 Listener 规范 ， 故 无 法 使 用 
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这 种 配置 方式 ， 只 能 改 为 使 用 Filter 配置 方式 ， 配置 片 段 如 下 : 
<web-app> 
<filter> 
<filter-name>requestContextFilter</filter-name> 
<filter-class>org. springframework. 
web. filter.RequestContextFilter</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>requestContextFilter</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


</web-app> 

一 旦 在 web.xml 中 增加 了 如 上 任意 一 种 配置 ， 程 序 就 可 以 在 Spring 配置 文件 中 使 用 request 或 
session 作用 域 了 。 下 面 的 配置 文件 配置 了 一 个 实现 类 为 Person 的 Bean 实例 ， 其 作用 域 是 request。 配 
置 文件 代码 如 下 。 

程序 清单 :codes\07\7.5\requestScope\WEB-INF\applicationContext.xml 

‘<?xml version="1.0" encoding="GBK"?> 

件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

"http://www.w3.0rg/2001/XMLSchema-instance" 
://www. springframework.org/schema/beans™ 
xsi;:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0,xsd"> 


<!-~ 指定 使 用 request 作用 域 --> 


<bean id="p" class="org.crazyit.app. service.Person" 
scope="request"/> 


</beans> 


这 样 Spring 容器 会 为 每 次 HTTP 请 求生 成 一 个 Person 的 实例 ， 当 该 请 求 响应 结束 时 ， 该 实例 也 随 
之 消失 。 

如 果 Web 应 用 直接 使 用 Spring MVC 作为 MVC 框架 ， 即 用 SpringDispatcherServlet 或 
DispatcherPortlet 来 拦截 所 用 用 户 请 求 ， 则 无 须 这 些 额外 的 配置 ， 因 为 DispatcherServlet 和 
DispatcherPortlet 已 经 处 理 了 所 有 和 请 求 有 关 的 状态 处 理 。 

关于 HTTP Request 和 HTTP Session 的 作用 范围 ， 请 参看 第 2 章 关于 Web 编程 的 介绍 。 


省 六 作用 二 的 旬 请 参看 Spring 官方 文档 等 资料 . 


Spring 3.0 不 仅 可 以 为 Bean 指定 已 经 存在 的 5 个 作用 域 ， 还 支持 自 定 义 作用 域 。 关 3 


>>7.5.3 配置 依赖 


根据 前 面 的 介绍 ，Java 应 用 中 各 组 件 的 相互 调用 的 实质 可 以 归纳 为 依赖 关系 ， 根 据 注入 方式 的 不 
同 ，Bean 的 依赖 注入 通常 表现 为 如 下 两 种 形式 。 

> 属性: 通过 <property.…./> 元 素 配 置 ， 对 应 设 值 注 入 。 

> ”构造 器 参数 ， 通 过 <constructor-arg..…./> 元 素 指定 ， 对 应 构造 注入 。 

不 管 是 属性 ， 还 是 构造 器 参数 ， 都 视 为 Bean 的 依赖 ， 接 受 Spring 容器 管理 ， 依 赖 关 系 的 值 要 么 
是 一 个 确定 的 值 ， 要 么 是 Spring 容器 中 其 他 Bean 的 引用 。 

通常 情 况 下 ， 我 们 不 应 该 使 用 配置 文件 管理 普通 的 属性 值 ， 通 常 只 使 用 配置 文件 管理 容器 中 的 
Bean 实例 的 依赖 关系 。 

通常 情况 下 ，Spring 在 实例 化 容器 时 , 会 校 验 BeanFactory 中 每 一 个 Bean 的 配置 , 这 些 校 验 包 括 : 

> ”Bean 引用 的 依赖 Bean 是 否 指向 一 个 合法 的 Bean。 
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> ”Bean 的 普通 属性 值 是 否 获得 了 一 个 有 效 值 。 
对 于 singleton 作用 域 的 Bean， 如 果 没 有 强行 取消 其 预 初始 化 行为 ， 系 统 会 在 创建 Spring 容器 时 
预 初 始 化 所 有 singleton Bean， 与 此 同时 ， 该 Bean 所 依赖 的 Bean 也 被 一 起 实例 化 。 
BeanFactory 与 ApplicationContext 实例 化 容器 中 Bean 的 时 机 不 同 : 前 者 等 到 程序 需要 Bean 实例 
时 才 创建 Bean， 而 后 者 在 容器 创建 ApplicationContext 实例 时 ， 会 预 初始 化 容器 中 的 全 部 Bean。 
要 


和 注 齐 :和 
| 因为 采用 ApplicationContext 作为 Spring 容器 ， 创 建 容器 时 会 同时 创建 容器 中 所 有 i 

| singleton 作用 域 Bean， 因 此 可 能 需要 更 多 的 系统 开销 。 但 一 旦 创建 成 功 ， 应 用 后 面 的 响应 y 
: 

i 


速度 更 决 ， 因 此 ， 对 于 普通 Java EE 应 用 ， 推 荐 使 用 ApplicationContext 作为 Spring 容器 


创建 BeanFactory 时 不 会 立即 创建 Bean 实例 , 所 以 有 可 能 程序 可 以 正确 地 创建 BeanFactory 实例 ， 
但 当 请 求 Bean 实例 时 依然 抛 出 一 个 异常 创建 Bean 实例 或 注入 它 的 依赖 关系 时 出 现 错误 。 

配置 错误 的 延迟 出 现 ， 也 会 给 系统 引入 不 安全 因素 ， 而 ApplicationContext 则 默认 预 实例 化 所 有 
singleton 作用 域 Bean, 所 以 ApplicationContext 实例 化 过 程 比 BeanFactory 实例 化 过 程 的 时 间 和 内 存 开 
销 大 ， 但 可 以 在 容器 初始 化 阶段 就 检验 出 配置 错误 。 

实际 上 , Spring 允许 z 为 singleton 作用 域 的 Bean 指定 lazy-init="true", 该 属性 将 改变 singleton Bean 
实例 的 默认 行为 , 强制 取消 该 Bean 实例 预 初始 化 , 则 该 Bean 将 不 会 随 ApplicationContext 启动 而 预 实 
例 化 。 

前 面 提 到 Spring 的 作用 就 是 管理 Java EE 组 件 , Spring 把 所 有 Java 对 象 都 称 为 Bean， 所 以 我 们 可 
以 把 任何 Java 类 都 部 署 在 Spring 容器 中 一 一 只 要 该 Java 类 具有 相应 的 构造 器 即 可 。 

除 此 之 外 , Spring 可 以 为 任何 Java 对 象 注入 任何 类 型 的 属性 一 一 只 要 该 Java 对 象 为 该 属性 提供 了 
对 应 的 setter 方法 即 可 。 

例如 如 下 配置 片段 : 

<bean id="id"” class="lee.AClass"> 
<!-~ property 配置 需要 依赖 注入 的 属性 --> 


<property name="aaa" value="aVal"/> 
<property name="bbb" value="bVal"/> 


</bean> 
对 于 上 面 的 配置 片段 ， 有 效 的 数据 只 是 那些 粗 体 字 内 容 ，Spring 将 会 为 每 个 <bean... 人 > 元 素 创建 一 
个 Java 对 象 一 一 这 个 Java 对 象 就 是 一 个 Bean 实例 。 对 于 上 面 的 程序 ，Spring 将 采用 类 似 于 如 下 的 代 
码 创建 Java 实例 。 
/7 获取 lee.AClass 类 的 Class 对象 
Class targetClass = Class.forName ("lee.RClass"): 
// 创 建 lee.AClass 类 的 默认 实例 
Object bean = targetClass.newInstance(); 
创建 该 实例 后 , Spring 接着 遍历 该 <bean.… 人 > 元 素 里 的 所 有 <property.… 人 > 子 元 素 ,<bean... 人 > 元 素 每 包 
会 一 个 <property.…/> 子 元 素 , Spring 将 为 该 bean 实例 调用 一 次 setter 方法 .对 于 上 面 第 一 行 <property.. 伺 
子 元 素 ， 将 有 类 似 的 如 下 代码 : 
// 获 取 aaa 属性 对 应 的 setter 方法 名 
String _setNamel = "set" +"Aaa"; 
// 获 取 lee.Class 类 里 setAaa() 方 法 
Method setMethodl = targetClass.getMethod(setNamel , aVal.getClass()); 
// 调 用 bean 实例 的 setAaa () 方 法 
setMethod1. invoke (bean , aVal); 


通过 类 似 上 面 的 代码 , Spring 就 可 根据 配置 文件 的 信息 来 创建 Java 实例 , 并 将 为 该 Java 实例 注入 
合理 的 属性 值 一 一 这 是 再 普通 不 过 的 事情 ， 并 没有 任何 神奇 的 地 方 。 
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六 而 反射 也 是 Spring 框架 大 量 使 用 的 知识 ， 如 果 读者 | 
对 Java 反射 的 知识 还 不 太 热 悉 ， 建 议 阅读 笔者 所 著 的 《六 狂 Java 讲义 》 一 书 . | 


例如 如 下 配置 片段 : 
<bean id="id" class="lee.AClass"> 
<!-- property 配置 需要 依赖 注入 的 属性 -> 
<contructor index="1" value="aVal"/> 
< contructor index="0" value="bVal"/> 


</bean> 
上 面 的 配置 片段 指定 使 用 构造 注入 ， 则 Spring 不 会 采用 默认 的 构造 器 来 创建 Bean 实例 ， 而 是 使 
用 特定 构造 器 来 创建 该 Bean 实例 。 
Spring 将 会 采用 类 似 如 下 的 代码 来 创建 Bean 实例 : 


// 获 取 lee.AClass 类 的 Class 对 象 
Class targetClass = Class.forName ("lee.AClass"); 


// 获 取 第 一 个 参数 是 bVal 类 型 ， 第 二 个 参数 是 aVal 类 型 的 构造 器 
Constructor targetCtr = targetClass.getConstructor (bVal.getClass() , aVal.getclass()); 


// 以 指定 构造 器 创建 Bean 实例 
Object bean = targetCtr.newIntance(bVal , aVal); 


上 面 的 程序 片段 仅 是 一 个 示例 ，Spring 实际 上 还 需要 根据 <property.…/> 元 素 、<contructor-arg.…/> 元 
素 所 使 用 的 value 属性 、ref 属性 等 来 判断 需要 注入 的 到 底 是 什么 数据 类 型 ， 并 要 对 这 些 值 进行 合适 的 
类 型 转换 ， 所 以 Spring 实际 的 处 理 过 程 更 复杂 。 

提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 

Fes 通过 上 面 的 介绍 不 难看 出 ， 当 我 们 在 XML 文件 中 使 用 <property.…/> 元 素 为 配置 依赖 注 : 
和 入 时 ， 其 底层 的 本 质 就 是 调用 该 Bean 对 象 的 setter 方法 ， 每 个 <property.…/> 元 素 对 应 调用 

| ”一 次 setter 方法 。 J 

由 于 Java 实例 的 属性 值 可 以 是 各 种 数据 类 型 ,除了 基本 类 型 值 、 字 符 串 类 型 值 等 ， 还 可 以 是 其 他 

Java 实例 ， 也 可 以 是 容器 中 其 他 Bean 实例 ， 甚 至 是 Java 集合 、 数 组 等 ， 所 以 Spring 允许 通过 如 下 元 


素 为 Bean 实例 的 属性 指定 值 : 
> value 
> ref 
> bean 


> list、 set、map 及 props 
上 面 4 种 情况 分 别 代表 Bean 实例 的 4 种 属性 值 ， 下 面 详细 介绍 这 4 种 情况 。 


》>>7.5.4 设置 普通 属性 值 


<value... 人 > 元 素 用 于 指定 字符 串 类 型 、 基 本 类 型 的 属性 值 ，Spring 使 用 XML 解析 器 来 解析 出 这 些 
数据 ， 然 后 利用 java.beans.PropertyEditor 完成 类 型 转换 :从 java.lang.String 类 型 转换 为 所 需 的 参数 值 
类 型 。 如 果 目 标 类 型 是 基本 数据 类 型 ， 通 常 都 可 以 正确 转换 。 

下 面 的 代码 演示 value 元 素 确定 属性 值 的 情况 。 假设 有 如 下 的 Bean 类 ， 该 Bean 类 里 包含 int 型 和 
double 型 的 两 个 属性 ， 并 为 这 两 个 属性 提供 对 应 的 setter 方法 。 下 面 是 该 Bean 的 实现 类 代码 ， 因 为 仅 
仅 用 于 测试 注入 普通 属性 值 ， 因 此 没有 使 用 接口 。 

程序 清单 : codes\07\7.5\value\src\org\crazyit\app\service\ExampleBean.java 

public class ExampleBean 
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// 定 义 一 个 int 型 的 属性 
private int integerProperty; 
// 定 义 一 个 double 型 的 属性 
private double doubleProperty; 
//integerProperty 属性 的 setter 和 getter 方 法 
public void setIntegerProperty (int integerProperty) 
{ 

this.integerProperty = integerProperty; 
} 
public int getIntegerProperty() 
{ 

return this.integerProperty; 


} 
//doubleProperty 属性 的 setter 和 getter 方法 
public void setDoubleProperty (double doubleProperty) 
{ 
this.doubleProperty = doubleProperty; 


} 
public double getDoubleproperty() 
( 


return this.doublePproperty; 
} 
} 


上 面 的 Bean 类 的 两 个 属性 都 是 基本 类 型 值 ，Spring 配置 文件 使 用 <value..…/> 元 素 即 可 为 这 两 个 属 
性 指定 属性 值 。 配 置 文件 如 下 。 
程序 清单 :codes\07\7.5\Walue\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance' 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www,.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean xampleBean" class="org.crazyit.app.service.ExampleBean”"> 
<!-- 确定 int 型 属性 值 一 > 
<property name="integerProperty" value="1"/> 
<!-- 确定 double 型 属性 值 一 > 
name="doubleProperty" value="2.3"/> 


</bean> 
</beans> 


本 测试 的 主 程序 与 之 前 的 主 程序 相差 不 大 ， 此 处 不 再 玖 述 。 运 行程 序 ， 输 出 exampleBean 的 两 个 
属性 值 ， 看 到 输出 结果 分 别 是 1 和 2.3， 这 表明 Spring 已 为 这 两 个 属性 注入 了 属性 值 。 

<value.… 人 > 元 素 主 要 用 于 传 入 字符 串 、 基 本 类 型 的 属性 值 。 

早期 Spring 还 支持 一 个 “更 为 腾 肿 ”的 写法 ， 例 如 我 们 此 处 配置 一 个 驱动 类 ， 可 以 使 用 如 下 代码 片段 : 

<property name="driverClass" value="com.mysql.jdbc.Driver"/S 

上 面 的 配置 片段 通过 为 <property.… 户 元 素 增加 value 属性 ， 即 可 为 该 属性 指定 所 需 的 属性 值 ， 从 而 
完成 依赖 关系 的 设置 注入 ， 这 种 配置 方式 只 要 一 行 代码 即 可 完成 一 次 “依赖 注入 ”。 

这 条 配置 用 早期 Spring 配置 方式 ， 则 需要 如 下 三 行 代码 : 


<property name="driverClass"> 
<value>com.mysql.jdbc.Driver</value> 
</property> 也 


两 种 配置 方式 的 效果 完全 相同 ， 只 是 因为 Spring 版 本 改变 的 原因 ， 故 提供 了 多 种 配置 方式 。 在 早 
期 的 时 候 ，Spring 采用 <value.… 人 > 子 元 素 的 方式 来 指定 属性 值 ; 但 后 来 Spring 发 现 采用 <value.…. 人 > 子 元 
素 导致 配置 文件 非常 腾 肿 ， 而 采用 value 属性 则 更 加 简洁 ;两 种 方式 所 能 提供 的 信息 量 则 完全 一 样 ， 
所 以 后 来 Spring 都 推荐 采用 value 属性 的 方式 来 配置 。 
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使 用 WO 配置 普通 参数 值 时 ， 有 两 种 配置 方式 - 这 两 种 方式 效果 完全 一 ， 只 是 
其 中 一 种 写法 更 加 简洁 。 类 似 的 是 ，<constructor-arg.…/> 也 可 增加 value 属性 ， 用 于 设置 
字面 值 参 数值 .实际 上 ， 配置 合 作者 Bean、 配 置 集合 属性 等 都 提供 了 子 元 素 、 属 性 两 种 污 


配置 方式 ， 具体 请 参考 Spring 的 语义 约束 文档 . 


>》>7.5.5 配置 合作 者 Bean 


如 果 需 要 为 Bean 设置 的 属性 值 是 容器 中 的 另 一 个 Bean 实例 ， 则 应 该 使 用 <ref .人 元素。 使 用 
<ref .人 元 素 时 可 指定 如 下 两 个 属性 。 
> ”bean: 引用 不 在 同一 份 XML 配置 文件 中 的 其 他 Bean 实例 的 id 属性 值 。 
> local: 引用 同一 份 XML 配置 文件 中 的 其 他 Bean 实例 的 id 属性 值 。 
从 上 面 的 介绍 可 以 看 出 ，bean、local 属性 都 用 于 引用 Spring 容器 中 另 一 个 已 有 的 Bean 实例 ， 而 
local 属性 让 Spring 在 解析 XML 时 执行 更 严格 的 验证 。 
看 下 面 的 配置 片段 : 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 
<property name="axe"> 


<!-~ 引用 容器 中 另 一 个 bean --> 


<ref local="steelAxe"/> 
</property> 
</bean> 


与 注入 普通 属性 值 类 似 的 是 ， 注 入 合作 者 Bean 也 有 一 种 简洁 的 写法 ， 看 如 下 的 配置 方式 ， 


<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 

<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 

<!-- 引用 容器 中 另 一 个 bean -> 
<property name="axe" ref="steelAxe"/> 

</bean> 

通过 为 property 增加 ref 属性 ， 一 样 可 以 将 另 一 个 Bean 的 引用 设置 成 axe 属性 值 。 上 面 的 简洁 写 
法 的 配置 方式 与 前 面 注 入 合作 者 Bean 的 效果 完全 相同 。 使 用 这 种 简洁 写法 的 配置 方式 ， 则 无 须 使 用 
ref 元 素 ， 也 就 无 须 区 分 为 ref 元 素 增加 bean 属性 ， 还 是 增加 local 属性 了 。 


雪 
注意 : 才 

注入 另 一 个 Bean 的 引用 。 要 
)>》7.5.6 使 用 自动 装配 注入 合作 者 Bean 


Spring 能 自动 装配 Bean 与 Bean 之 间 的 依赖 关系 ， 即 无 须 使 用 ref 显 式 指定 依赖 Bean。 由 
BeanFactory 检查 XML 配置 文件 内 容 ， 根 据 某 种 规则 ， 为 主 调 Bean 注入 依赖 关系 。 

Spring 的 自动 装配 可 通过 <beans... 人 > 元 素 的 default-autowire 属性 指定 ， 也 可 通过 <bean... 人 > 元 素 的 
autowire 属性 指定 。 自 动 装配 可 以 指定 到 单独 Bean， 也 就 是 说 ， 同 一 个 Spring 容器 中 完全 可 让 某 些 
Bean 使 用 自动 装配 ， 而 另 一 些 Bean 不 使 用 自动 装配 。 

自动 装配 可 以 减少 配置 文件 的 工作 量 ， 但 降低 了 依赖 关系 的 透明 性 和 清晰 性 。 

使 用 autowire 属性 配置 自动 装配 ，autowire 属性 可 以 接受 如 下 值 。 

> no: 不 使 用 自动 装配 。Bean 依赖 必须 通过 ref 元 素 定义 。 这 是 默认 的 配置 ， 在 较 大 的 部 署 环 

境 中 不 鼓励 改变 这 个 配置 ， 显 式 配置 合作 者 能 够 得 到 更 清晰 的 依赖 关系 。 


constructor 元 素 也 可 增加 ref 属性 ， 从 而 可 以 通过 构造 
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> ”byName: 根据 属性 名 自动 装配 。BeanFactory 查找 容器 中 的 全 部 Bean， 找 出 其 中 id 属性 与 
属性 同名 的 Bean 来 完成 注入 。 如果 没有 找到 匹配 的 Bean 实例 , 则 Spring 不 会 进行 任何 注入 。 

> ”byType: 根据 属性 类 型 自动 装配 。BeanFactory 查找 容器 中 的 全 部 Bean， 如 果 正 好 有 一 个 
与 依赖 属性 类 型 相同 的 Bean， 就 自动 注入 这 个 属性 : 如 果 有 多 个 这 样 的 Bean， 就 抛 出 一 个 
异常 ， 如 果 没 有 匹配 的 Bean， 则 什么 都 不 会 发 生 ， 属 性 不 会 被 设置 。 如 果 需 要 无 法 自动 装 
配 时 抛 出 异常 ， 则 设置 dependency-check="objects"。 

> constructor: 与 byType 类 似 ， 区 别 是 用 于 构造 注入 的 参数 。 如 果 BeanFactory 中 不 是 恰好 
有 一 个 Bean 与 构造 器 参数 类 型 相同 ， 则 会 抛 出 一 个 异常 。 

> ”autodetect: BeanFactory 根据 Bean 内 部 结构 ， 决 定 使 用 constructor 或 byType。 如 果 找 到 
一 个 默认 的 构造 函数 ， 那 么 就 会 应 用 byType。 

7.5.6.1 byName 规则 


byName 规则 是 指 通过 名 字 注 入 依赖 关系 ， 假 如 Bean A 的 实现 类 包含 setB0 方 法 ， 而 Spring 的 配 
置 文件 恰好 包含 id 为 b 的 Bean， 则 Spring 容器 会 将 b 实例 注入 Bean A 中 。 如 果 容 器 中 没有 名 字 匹 配 
的 Bean，Spring 则 不 会 做 任何 事情 。 
看 如 下 配置 文件 : 
<?xml version="1,0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/xMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
nsi:schemaLocation="http: //www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese”" 
autowire="byName"/> 
<bean id="gundog" class="org.crazyit.app.service.impl.Gundog"> 
<property name="name" value="wangwang"/> 
</bean> 
</beans> 


上 面 的 配置 文件 指定 了 byName 自动 装配 策略 ， 则 要 求 org.crazyitapp.service.impl.Chinese 类 中 提 
供 如 下 依赖 注 入 的 方法 : 
Pn 
* 依赖 关系 必需 的 setter 方法 ， 因 为 需要 通过 名 字 自 动 装配 


* 所 以 setter 方法 名 必须 是 set + Bean 名 ，Bean 名 的 首 字母 大 写 
* Qparam dog 设置 的 dog 值 
下 


public void setGundog (Dog dog) 
{ 

this.dog = dog; 
上 


7.5.6.2 ”byType 规则 
byType 规则 ， 指 根据 类 型 匹配 来 注入 依赖 关系 。 假 如 A 实例 有 setB(B b) 方 法 ， 而 Spring 配置 文 
件 中 恰 有 一 个 类 型 B 的 Bean 实例 , 容器 为 A 注入 类 型 匹配 的 Bean 实例 , 如 果 容 器 中 没有 一 个 类 型 为 
B 的 实例 ， 则 什么 都 不 会 发 生 ; 但 如 果 容 器 中 有 多 于 一 个 的 B 实例 ， 都 将 抛 出 异常 。 
看 如 下 配置 文件 。 
程序 清单 : codes\07\7.5\antowire\src\bean.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://waw.w3.org/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans™" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 


http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese" 
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autowire="byType"/> 
<bean id="gundog" class="org.crazyit.app.service.impl.Gundog"> 
<property name="name" value="wangwang"/> 
</bean> 
</beans> 
上 面 的 配置 文件 要 求 Chinese 类 中 有 如 下 方法 。 
程序 清单 : codes\07\7.5\antowire\src\org\crazyit\app\service\impl\Chinese.java 
/us 
* 依赖 关系 必需 的 setter 方法 
* 因为 使 用 技 关 型 自动 装配 ，setter 方法 的 参数 类 型 与 容器 中 Bean 的 类 型 相同 
* 程序 中 的 Gunpog 实现 Dog 接口 
* 8@param dog 传 入 的 dog 对 象 
*/ 
public void setDog(Dog dog) 
{ 
this.dog = dog; 
} 


但 如 果 出 现 如 下 配置 文件 : 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http;//www.w3.0org/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schemaybeansn" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 指定 chinese Bean 使 用 自动 装配 ， 按 类 型 装配 --> 
<bean id="chinese" class="org.crazyit.app.service,impl.Chinese" 
autowire="byType"/> 
<!-- 配置 gundog Bean --> 
<bean id-"gundog”class="org.crazyit.app.service.impl.Gundog"> 
<property name="name" value="wangwang"/> 
</bean> 
<!-- 配置 Petdog Bean Pegdog 也 实现 Dog 接口 --> 
<bean id="petdog”class="arg .crazyit.app.service.impl.petdog"> 
<property name="name" value="ohoh"/> 
</bean> 
</beans> 


对 于 上 面 的 配置 文件 ，Spring 将 无 法 按 类 型 自动 装配 : 容器 中 有 两 个 类 型 为 Dog 的 Bean，Spring 
无 法 确定 应 为 chinese Bean 注入 哪个 Bean， 所 以 程序 将 抛 出 异常。 
剩 下 的 两 种 自动 装配 策略 与 byName、byType 大 同 小 异 ， 此 处 不 再 歼 述 。 
当 一 个 Bean 既 使 用 自动 装配 依赖 , 又 使 用 ref 显 式 指定 依赖 时 , 则 显 式 指定 的 依赖 著 盖 自动 装配 。 
在 如 下 配置 文件 中 : 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://waw.springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 指定 chinese Bean 使 用 自动 装配 ， 按 名 字 装 配 --> 
<bean id="chinese" class="org.crazyit.app. service.impl.Chinese" 
autowire="byName"> 
<property name="gundog” ref="petdog” /> 
</bean> 
<!-- 配置 gundog Bean --> 
<bean id="gundog" class="org.crazyit.app.service.impl.Gundog"> 
<property name="name" value="wangwang"/> 
</bean> 
<!-- 配置 petdog Bean Pegdog 也 实现 Dog 接口 --> 
<bean id="petdog" class="org.crazyit.app.service.impl.Petdog"> 
<property name="name" value="ohoh"/> 
</bean> 
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</beans> 
即使 Chinese 类 中 有 setGundog(Dog dog) 方 法 , Spring 依然 注入 petdog 实例 , 而 不 是 gundog 实例 ， 
ee ref 指定 的 依赖 关系 将 覆盖 自动 装配 的 依赖 关系 。 


四 注意， :有 

对 于 大 型 的 应 用 ， 不 鼓励 使 用 自动 装配 . 虽然 使 用 自动 装配 可 减少 配置 文件 的 工作 
量 ， 但 大 大 降低 了 依赖 关系 的 清晰 性 和 透明 性 。 依赖 关系 的 装配 依赖 于 源 文件 的 属性 名 
或 属性 类 型 ， 导 致 Bean 与 Bean 志 间 的 本 会 体 居 到 人 所 民 尖 ， 和 不利 笑 肖 是 尖 角 岳 。 


在 默认 情况 下 ，Spring 会 自动 搜索 容器 中 所 有 Bean， 并 对 这 些 Bean 进行 判断 ， 庆 断 它们 是 否 满 
足 自动 装配 的 条 件 ， 如 果 满足 ， 就 会 将 该 Bean 注入 目标 Bean 实例 中 。 

在 某 些 情况 下 ， 我 们 不 想 让 Spring 判断 某 些 Bean， 也 就 是 不 想 让 某 些 Bean 作为 自动 装配 的 候选 
者 ， 则 可 考虑 使 用 autowire-candidate 属性 ， 通 过 为 <bean.…/> 元 素 设置 autowire-candidate="false"， 即 可 
将 该 Bean 限制 在 自动 装配 范围 之 外 ， 容 器 在 查找 自动 装配 对 象 时 将 不 考虑 该 Bean。 

除 此 之 外 ， 我 们 还 可 通过 在 <beans/> 元 素 中 指定 default-autowire-candidates 属性 来 对 一 批 Bean 进 
行 限制 , 将 这 批 Bean 排除 在 自动 装配 之 外 。default-autowire-candidates 属性 的 值 允许 使 用 模式 字符 串 ， 
例如 我 们 指定 defaultrautowire-candidates="*abc"， 则 所 有 以 “abc” 结 尾 的 Bean 都 将 被 排除 在 自动 装 
配 之 外 。 不 仅 如 此 ， 该 属性 甚至 可 以 指定 多 个 模式 字符 串 ， 这 样 所 有 匹配 任 一 模式 字符 串 的 Bean 都 
将 被 排除 在 自动 装配 之 外 。 


>》>7.5.7 注入 说 套 Bean 


如 果 某 个 Bean 所 依赖 的 Bean 不 想 被 Spring 容器 直接 访问 ， 可 以 使 用 嵌 套 Bean。<bean.…/> 元 素 
用 来 定义 嵌 套 Bean， 翌 套 Bean 只 对 嵌 套 它 的 外 部 Bean 有 效 ，Spring 容器 无 法 直接 访问 嵌 套 Bean， 
因此 定义 嵌 套 Bean 时 无 须 指定 id 属性 。 
如 下 配置 片段 是 定义 嵌 套 Bean 的 示例 。 
<bean id="chinese" class="org.crazyit.app.service,impl.Chinese"> 
<property name="axe"> 
<!-- 属性 值 为 以 套 Bean, 恢 套 Bean 不 能 由 Spring 容器 直接 访问 。 
因此 ， 嵌 套 Bean 没有 id 属性 --> 
<bean class="org.craryit.app. service.impl. SteelAxe"/> 
</property> 
</bean> 


采用 上 面 的 配置 形式 可 以 保证 嵌 套 Bean 不 能 被 容器 访问 , 因此 不 用 担心 其 他 程序 修改 嵌 套 Bean。 
外 部 Bean 的 用 法 与 之 前 的 用 法 完全 一 样 ， 使 用 结果 也 没有 区 别 。 
幸 套 Bean 限制 了 Bean 的 访问 ， 提 高 了 程序 的 内 聚 性 。 
二 


谈 套 Bean 提高 了 程序 的 内 聚 性 ， 但 降低 了 程序 的 灵活 性 只 有 在 确定 无须 通过 
Spring 容器 访问 某 个 Bean 实例 时 ， 才 考虑 使 用 谋 套 Bean 定义 。 


使 用 堪 套 Bean 与 使 用 ref 引用 容器 中 另 一 个 Bean 在 本 质 上 是 一 样 的 ， 前 面 我 们 知道 Spring 配置 
文件 中 每 个 <property.…/> 都 对 应 调用 一 次 setter 方法 ， 随 着 setter 方法 形 参 类 型 的 变化 ，Spring 配置 文 
件 当然 也 要 随 之 改变 : 

> ”setter 方法 的 形 参 是 基本 类 型 、String、 日 期 等 ， 直 接 使 用 value 指定 字面 值 即 可 。 

> ”setter 方法 的 形 参 是 复合 类 (如 Person、Dog、DataSource 等 ) ， 那 就 需要 传 入 一 个 Java 
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对 象 作为 实 参 ， 于 是 有 两 种 方式 : @ 使 用 ref 引用 一 个 容器 中 已 配置 的 Bean (Java 对 象 ) ; 
回 使 用 bean 临时 配置 一 个 嵌 套 Bean (Java 对 象 ) 。 
除 此 之 外 ，setter 方法 形 参 还 可 能 是 Set、List、Map 等 集合 ， 也 可 能 是 数组 类 型 ， 接 下 来 我 们 继 
续 介 绍 如 何在 Spring 配置 文件 中 为 setter 方法 设置 Set、List、Map、 数 组 实 参 值 。 


>>7.5.8 注入 集合 值 


如 果 Bean 的 属性 是 个 集合 ， 则 可 以 使 用 集合 元 素 ，<list.…/>、<set.…/>、<map.… 户 和 <props.… 户 元 素 
分 别 用 来 设置 类 型 为 List、Set、Map 和 Properties 的 集合 属性 值 。 

下 面 先 定义 一 个 包含 大 量 集合 属性 的 Java 类 , 配置 文件 将 会 通过 上 面 那些 元 素来 为 这 些 集合 属性 
设置 属性 值 。 看 如 下 Java 类 的 代码 。 

程序 清单 ，codes\07\7.5\collection\src\org\crazyit\app\service\impl\Chinese.java 


public class Chinese 
implements Person 


// 下 面 是 系列 集合 属性 

private List<string> schools; 
private Map scores; 

Private Map<String , Axe> phaseAxes; 
Private Properties health; 

Private Set axes; 

Private String[] books; 

public Chinese() 

{ 


{ 


System.out .println ("spring 实例 化 主 调 bean， Chinese 实例 . .."); 


} 
//schools 属性 依赖 注入 必需 的 setter 方法 
public void setSchools(List schools) 
{ 

this.schools = schools; 


上 

//scores 属性 依赖 注入 必需 的 setter 方法 
Public void setScores (Map scores) 
{ 


this.scores = scores; 


//phaseAxes 属性 依赖 注入 必需 的 setter 方法 
public void setPhaseAxes (Map<String , Axe> phaseAxes) 
{ 

this.phaseAxes = phaseAxes; 


} 
//health 属性 依赖 注入 必需 的 setter 方法 
public void setHealth (Properties health) 


{ 
this.health = health; 


} 

//axes 属性 依赖 注入 必需 的 setter 方法 
public void setAxes(Set axes) 

{ 


this.axes = axes; 


} 
//books 属性 依赖 注入 必需 的 setter 方法 
public void setBooks (String[] books) 
{ 

this.books = books; 
} 


// 访 问 上 面 全 部 的 集合 属性 
public void test() 
{ 
System.out .printin {schools); 
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System.out .println (scores); 
System.out .Println (phaseAxes); 

System.out .Println (health); 

System.out .println(axes) 7 
System.out.println(java.util.Rrrays.toString(books))7 


} 
在 上 面 的 Chinese 类 中 ，6 行 粗 体 字 代码 定义 了 6 个 集合 属性 。 下 面 我 们 分 别 为 <property…/> 元 素 
增加 <list.. 户 、<set... 户 、<map... 人 > 和 <props... 人 > 子 元 素来 配置 这 些 集合 属性 值 。 
下 面 是 Spring 的 配置 文件 。 
程序 清单 : codes\07\7.5\collection\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans™" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 一 个 普通 Axe Bean --> 
<bean id="stoneAxe" class="org.crazyit.app.service.impl.StoneAxe"/> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 
<!-- 定义 chinese Bean --> 
<bean id="chinese" class="org.crazyit.app.service,impl.Chinese"> 
<property name="schools"> 
<!-- 为 List 属性 配置 属性 值 -~-> 
<list> 
<!-- 每 个 value、ref、bean 都 配置 一 个 List 元 素 --> 
<value> 小 学 </value> 
<value> 中 学 </value> 
<value> 大 学 </value> 
</list> 
</property> 
<property name="scores"> 


<!-- 为 Map 属性 配置 属性 值 --> 


<!-- 每 个 entry 配置 一 个 key-value 对 --> 
<entry key=" 数 学 "” value="87"/> 
<entry key=" 英 语 "value="89"/> 
<entry key=" 语 文 ”value="82"/> 
</map> 
</property> 
<property name="phaseAxes"> 
<!-- 为 Map 属性 配置 属性 值 --> 
<map> 


<!-- 每 个 entry 配置 一 个 key-value 对 --> 
<entry key=" 原 始 社会 ”value-ref="stonehxe"/> 
<entry key=" 农 业 社会 ”value-ref="steelAxe"/> 
</map> 
</property> 
<property name="health"> 
<!-- 为 Properties 属性 配置 属性 值 
<!-- 每 个 prop 元 素 配置 一 个 属性 项 ， 
其 中 key 指定 属性 名 --> 
<props> 
<prop key=" 血 压 "> 正常 </prop> 
<Prop key=" 身 商 ">175</prop> 
</props> 
</property> 
<property name="axes"> 
为 set 属性 配置 属性 值 --> 


<!-- 每 个 value、ref、bean 都 配置 一 个 Set 元 素 --> 
<value> 普 通 的 字符 串 </value> 

<bean class="org.crazyit.app.service. impl.SteelAxe"/> 
<ref local="stoneAxe"/> 


562 


http://52pdf.taobao.com 


和 7 


</set> 
</property> 
<property name="books"> 
<!-- 为 数组 属性 配置 属性 值 ~-> 
<list> 
<!-- 每 个 value、ref,、 bean ee op 
ne 2 
Java EE 企业 启用 实 这 <yvaluey 


se Java 讲义 </value> 
</list> 
‘</property> 
</bean> 
</beans> 


上 面 的 粗 体 字 代码 是 为 集合 属性 指定 属性 值 的 关键 代码 ， 从 配置 文件 可 以 看 出 ，Spring 对 List 属 
性 和 数组 属性 的 处 理 是 一 样 的 ， 都 用 <list.… 放 元 素来 配置 。 
当 使 用 <list..…/>、<set.…/>、<map.… 户 等 元 素 配置 集合 属性 时 ， 还 需要 手动 配置 集合 元 素 。 由 于 集 
合 元 素 又 可 以 是 基本 类 型 值 、 引 用 容器 中 其 他 Bean、 人 嵌 套 Bean 或 集合 属性 等 ， 所 以 <list.. 人 >、<key.… 和 > 
和 <set..… 户 元 素 又 可 接受 如 下 子 元 素 。 
> ”value: 指定 集合 元 素 是 基本 数据 类 型 值 或 字符 串 类 型 值 。 
> ref: 指定 集合 元 素 是 容器 中 另 一 个 Bean 实例 。 
> ”bean: 指定 集合 元 素 是 一 个 殿 套 Bean。 
> list、set、map 及 props: 指定 集合 元 素 值 又 是 集合 。 
<props.…/> 元 素 用 于 配置 Properties 类 型 的 属性 , Properties 类 型 是 一 种 特殊 的 类 型 , 其 key 和 value 
都 只 能 是 字符 串 ， 故 Spring 配置 Properties 类 型 的 属性 比较 简单 ;每 个 属性 项 只 要 分 别 给 出 属性 名 和 
属性 值 就 足够 了 一 一 而 且 属性 名 和 属性 值 都 是 字符 串 类 型 ,所 以 使 用 如 下 格式 的 <prop.… 记 元素 就 够 了 : 
> ”<prop key=" 血 压 "> 正常 </prop>， 其 中 <prop.…/> 元 素 的 key 属性 指定 属性 名 ，<prop…/> 元 素 
的 内 容 指定 属性 值 。 
当 使 用 <map.…/> 元 素 配置 Map 属性 时 比较 复杂 ， 因 为 Map 集合 的 每 个 元 素 由 key、value 两 个 部 
分 组 成 ， 所 以 配置 文件 中 每 个 <entry.…/> 配 置 一 个 Map 元 素 ， 其 中 <entry.…. 人 > 元 素 支持 如 下 4 个 属性 。 
> ”key: 如 果 Map key 是 基本 类 型 值 或 字符 串 ， 则 可 使 用 该 属性 来 指定 Map key。 
> key-ref: 如 果 Map key 是 容器 中 另 一 个 Bean 实例 , 则 可 使 用 该 属性 指定 容器 中 其 他 Bean 的 id。 
> ”value: 如 果 Map value 是 基本 类 型 值 或 字符 串 ， 则 可 使 用 该 属性 来 指定 Map value。 
> value-ref: 如 果 Map value 是 容器 中 的 另 一 个 Bean 实例 ， 则 可 使 用 该 属性 指定 容器 中 其 他 
Bean 的 id。 
由 于 Map 集合 的 key、value 都 可 以 是 基本 类 型 值 、 引 用 容器 中 其 他 Bean、 炭 套 Bean 或 集合 属性 
等 ， 所 以 也 可 以 采用 比较 传统 、 比 较 脐 肿 的 写法 ， 例 如 将 上 面 关 于 scores 属性 的 配置 写成 如 下 : 
<property name="scores"> 


<!-- 为 Map 属性 配置 属性 值 --> 


<map> 
<!-- 每 个 entry 配 置 一 个 key-value 对 --> 
Xen 
<1-- key 元 素 配置 Map key--> 


<!-- 每 个 value、ref、bean 都 配置 一 个 key 值 --> 


<entry> 
<key> 
<value> 英 语 </value> 
</key> 
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<value>89</value> 
</entry> 
<entry> 
<key> 
<value> 语 文 </value> 
</key> 
<value>82</value> 
</entry> 
</map> 
</property> 


所 以 <key... 记 元 素 、<entry... 记 的 子 元 素 又 可 以 是 value、ref、bean、list、set、map 和 props 等 。 
现在 Spring 还 提供 了 一 个 简化 语法 来 支持 Properties 形 参 的 setter 方法 , 例如 我 们 可 以 用 如 下 配置 片段 : 


<property name="health"> 
<value> 


height=175 
</value> 
</property> 

上 面 这 种 配置 方式 同样 配置 了 两 组 属性 一 一 但 这 种 配置 语法 有 一 个 很 大 限制 ， 属 性 名 、 属 性 值 都 
只 能 是 英文 、 数 字 ! 不 可 出 现 中 文 。 

从 Spring 2.0 开始 ，Spring loC 容器 将 支持 集合 的 合并 ， 子 Bean 中 的 集合 属性 值 可 以 从 其 父 Bean 
的 集合 属性 继承 和 覆盖 而 来 ; 也 就 是 说 ， 子 Bean 的 集合 属性 的 最 终 值 是 父 Bean、 子 Bean 合并 后 的 最 
终结 果 ， 而 且 子 Bean 集合 中 的 元 素 可 以 获 盖 父 Bean 集合 中 对 应 的 元 素 。 

下 面 的 配置 片段 示范 了 集合 合并 的 特性 。 
<beans> 
<!-- 将 父 Bean 定义 成 抽象 Bean 一 > 
<bean id="parent" abstract="true" class="example.ComplexObject"> 
<!-- 定义 Properties 类 型 的 集合 属性 ~ 
<property name="adminEmails"> 
<props> 
<prop key="administrator">administrator@crazyit.org</prop> 
<prop key="support">support@crazyit.org</prop> 
</props> 
</property> 
</bean> 
<!-- 使 用 parent 定义 该 Bean 继承 了 parent Bean --> 
<bean id="child" parent="parent"> 
<property name="adminEmails"> 
<!-~ 指定 该 集合 属性 支持 合并 --> 
<props merge="true"> 
<prop key="sales">sales@crazyit.org</prop> 
<prop key="support">master@crazyit.org</prop> 
</props> 
</property> 
</bean> 
<beans> 


上 面 的 配置 文件 中 child Bean 继承 了 parent Bean， 并 为 <props... 人 > 元 素 指定 了 merge="true"， 这 将 
会 把 parent Bean 的 集合 属性 合并 到 child Bean 中 ; 当 进行 合并 时 , 由 child Bean 再 次 配置 了 名 为 support 
的 属性 ,所 以 该 属性 将 会 覆盖 parent Bean 中 的 配置 定义 ,于 是 child Bean 的 adminEmails 属性 值 如 下 : 


administrator=administratorgcrazyit.org 
sales=sales@crazyit.org 
support=master@crazyit.org 


从 JDK 1.5 之 后 ，Java 可 以 使 用 泛 型 指定 集合 元 素 的 类 型 ， 则 Spring 也 可 通过 反射 来 获取 集合 元 
素 的 类 型 ， 这 样 Spring 的 类 型 转换 器 也 会 起 作用 了 。 
例如 如 下 代码 : 


public class Test 
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{ 
Private Map<String, Double> prices; 
Public void setPrices (Map<string, Double> prices) 
{ 
this.prices = prices; 
} 
} 


上 面 的 prices 集合 是 Map 集合 , 且 程 序 使 用 泛 型 限制 了 Map 的 key 是 String, 且 value 是 Double， 
Spring 将 可 根据 泛 型 信息 把 配置 文件 的 属性 值 转换 成 相应 的 数据 类 型 。 例 如 如 下 配置 文件 : 


<bean id="test" class="lee.Test"> 
<property name="prices"> 
<map> 
<entry key="Struts2 权威 指南 ”value="79.0"/> 
<entry key=" 疯 狂 Java 讲义 ”value="99"/> 
</map> 
</property> 
</bean> 


Spring 会 自动 将 每 个 entry 中 的 key 值 转换 成 String 类 型 , 并 将 value 指定 的 属性 值 转化 成 Double 类 型 。 
>>7.5.9 组 合 属 性 名 称 


当 在 配置 文件 中 为 Bean 属性 指定 值 时 ， 还 可 以 使 用 组 合 属性 名 的 方式 。 例 如 ， 我 们 使 用 如 
foo.barname 的 属性 名 ， 这 表明 为 Bean 实例 的 foo 属性 、bar 属性 的 name 属性 指定 值 。 
当 设 置 Bean 的 组 合 属性 时 ， 除 了 最 后 一 个 属性 外 ， 只 要 其 他 属性 值 不 为 null， 组 合 属性 名 是 完全 
合法 的 。 
例如 ， 我 们 有 如 下 的 Bean 类 。 
程序 清单 : codes\07\7.5\compositeProp\src\org\crazyitapp\service\ExampleBeanjava 
public class ExampleBean 


{ 
// 定 义 一 个 Person 型 的 属性 
private Person person 
= new Person(); 
//person 属性 的 getter 方法 
public Person getPerson() 
{ 
return this.person; 
} 
} 


上 面 ExampleBean 里 提供 了 一 个 person 属性 ， 该 person 的 类 型 是 Person 类 ，Person 是 一 个 Java 
类 ，Person 类 里 有 一 个 String 类 型 的 name 属性 。 则 我 们 可 以 使 用 组 合 属性 的 方式 为 ExampleBean 的 
person 属性 的 name 属性 指定 值 。 配 置 文件 如 下 。 

程序 清单 : codes\07\7.5\compositeProp\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans™" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://waw.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="exampleBean" class="org.crazyit.app.service.ExampleBean"> 
<!-- 为 复合 属性 指定 值 --> 
<property name="Person .name”value=" 孙 悟空 "/> 
</bean> 
</beans> 


通过 使 用 这 种 组 合 属性 的 方式 , Spring 允许 直接 为 Bean 实例 的 属性 指定 值 。 但 这 种 设置 方式 有 一 
点 需要 注意 : 为 组 合 属性 指定 值 时 ， 除 了 最 后 一 个 属性 外 ， 其 他 属性 都 不 能 为 null， 否 则 将 引发 
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NullPointerException 异常 。 例 如 ， 上 面 配置 文件 person.name 指定 属性 值 ， 则 exampleBean 的 person 
属性 一 定 不 可 为 null。 

对 于 这 种 注入 组 合 属性 值 的 形式 ， 每 个 <property... 人 > 元 素 依然 是 让 Spring 执行 一 次 setter 方法 , 但 
它 不 再 直接 调用 该 Bean 的 setter 方法 。 而 是 需要 先 调用 getter 方法 ， 然 后 再 去 调用 setter 方法 ， 例 如 
上 面 配置 片段 ， 相 当 于 让 Spring 执行 如 下 代码 : 

exampleBean .getPerson() .setName(" 孙 司空") ; 

也 就 是 说 ,组 合 属性 只 有 最 后 一 个 属性 才 是 调用 setter 方法 ， 前 面 各 属性 实际 上 对 应 于 调用 getter 
方法 一 一 这 也 是 前 面 属性 都 不 能 是 null 的 缘由 。 

例如 有 如 下 配置 片段 : 


<bean id="a" class="org.crazyit.app.service.AClass"> 
name="fo0.bar.x.y" value="xxx"/> 
</bean> 


上 面 的 组 合 属性 注入 相当 于 让 Spring 执行 如 下 代码 : 
a.getFoo() .getBar () .getX() .set¥ ("xc") 7 
对 于 Spring 开发 者 来 说 ，Spring 配置 文件 就 是 核心 ,而 Spring 配置 文件 中 依赖 关系 的 配置 十 分 容 
易 引起 错误 ， 为 了 帮助 开发 者 发 现 配 置 文件 中 依赖 关系 的 配置 错误 ，Spring 提供 了 依赖 检查 功能 。 


>>7.5.10 Spring 的 Bean 和 JavaBean 


Spring 容器 对 Bean 没有 特殊 要 求 ， 甚 至 不 要 求 该 Bean 像 标准 的 JavaBean 一 一 必须 为 每 个 属性 提 
供 对 应 的 getter 和 setter 方 法 .Spring 中 的 Bean 是 Java 实例 ,Java 组 件 ;而 传统 的 Java 应 用 中 的 JavaBean 
通常 作为 DTO〈 数 据 传输 对 象 )， 用 来 封装 值 对 象 ， 在 各 层 之 间 传 递 数据 。 

Spring 中 的 Bean 比 JavaBean 的 功能 要 复杂 , 用 法 也 更 丰富 。 当然 , 传统 JavaBean 也 可 作为 Spring 
的 Bean， 从 而 接受 Spring 管理 。 下 面 代码 演示 了 Spring 的 Bean 实例 ， 该 Bean 实例 是 数据 源 ， 提 供 

程序 清单 : codes\07\7.5\DataSource\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans™ 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource"” class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close' 
<!-~ 指定 连接 数据 库 的 驱动 --> 
<property name="driverClass" value="com.mysql.jdbc.Driver"/> 
<!- 指定 连接 数据 库 的 DRL --> 
<property name="jdbcUrl" value="jdbc:mysql://localhost/javaee"/> 
<!~- 指定 连接 数据 库 的 用 户 名 一 > 
<property name="user" value="root"/> 
<!-~ 指定 连接 数据 库 的 密码 --> 
<property name="password" value="32147"/> 
<!-- 指定 连接 数据 库 连 接 池 的 最 大 连接 数 --> 
<property name="maxPoolSize” value="40"/> 
<!-~ 指定 连接 数据 库 连接 池 的 最 小 连接 数 一 > 
<property name=”minPoolSizen value="1"/> 
<!-~ 指定 连接 数据 库 连 接 池 的 初始 化 连接 数 -> 
<property name="initialPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连 接 池 的 连接 的 最 大 空闲 时 间 -> 
<property name="maxIdleTime" value="20"/> 
</bean> 
</beans> 
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主 程序 部 分 由 BeanFactory 来 获取 该 Bean 的 实例 ， 获 取 实例 时 使 用 Bean 的 唯一 标识 符 : id 属性 ， 
id 属性 是 Bean 实例 在 容器 中 的 访问 点 。 下 面 是 主 程序 代码 。 
程序 清单 :codes\07\7.5\DataSource\src\lee\BeanTestjava 


public class BeanTest 
{ 
public static void main(String[] args) 
throws Exception 
{ 
// 实 例 化 Spring 容器 。Spring 容器 负责 实例 化 Bean 
ApplicationContext ctx = 
new ClassPathXmlApplicationContext ("bean. xml"); 
// 通 过 Bean id 获取 Bean 实例 ， 强 制 类 型 转换 为 DataSource 
DataSource ds = ctx.getBean("datasource", DataSource.class); 
// 通 过 Datasource 来 获取 数据 库 连 接 
Connection conn = ds.getConnection ()7 


// 通 过 数据 库 连接 获取 PreparedStatement 
PreparedStatement pstmt = conn.PrepareStatement ( 
"insert into news_inf values(null ，? ，3)")7 
pstmt .setstring (1 ，" 疯 狂 Java 联盟 成 立 了 ") ; 
pstmt .setString(2 ， "疯狂 Java 地 址 ; www.crazyit.org"); 
// 执 行 SQL 语句 
pstmt.executeUpdate () 7 
// 清 理 资源 ， 回 收 数据 库 连 接 资源 
if (pstmt != null)pstmt.close(); 
if (conn != null)conn.close(); 
? 
) 


上 面 程序 从 Spring 容器 中 获得 了 一 个 DataSource 对 象 ,通过 该 DataSource 对 象 就 可 以 获取 简单 的 
数据 库 连接 。 执 行 上 面 程序 ， 将 看 到 javaee 数据 库 的 news_inf 数据 表 中 多 了 一 条 记录 。 
从 该 实例 可 以 看 出 ，Spring 的 Bean 远 远 超出 值 对 象 的 JavaBean 范畴 ，Bean 可 以 代表 应 用 中 的 任 
何 组 件 、 任 何 资源 实例 。 
虽然 Spring 对 Bean 没有 特殊 要 求 ， 但 笔者 还 是 建议 Spring 中 的 Bean 应 满足 如 下 几 个 原则 ; 
> 尽量 为 每 个 Bean 实现 类 提供 无 参数 的 构造 器 。 
> ”接受 构造 注入 的 Bean， 则 应 提供 对 应 的 构造 函数 。 
> ”接受 设 值 注入 的 Bean， 则 应 提供 对 应 的 setter 方法 ， 并 不 强制 要 求 提供 对 应 的 getter 方法 。 
传统 JavaBean 和 Spring 中 Bean 存在 如 下 区 别 。 
> ”用 处 不 同 ， 传统 JavaBean 更 多 作为 值 对 象 传递 参数 ，Spring 的 Bean 用 处 几乎 无 所 不 包 ， 
任何 应 用 组 件 都 被 称 为 Bean。 
> ”写法 不 同 : 传统 JavaBean 作为 值 对 象 , 要 求 每 个 属性 都 提供 getter 和 setter 方法 ; 但 Spring 
的 Bean 只 需 为 接受 设 值 注入 的 属性 提供 setter 方法 。 
> ”生命 周期 不 同 ， 传统 JavaBean 作为 值 对象 传 递 ， 不 接受 任何 容器 管理 其 生命 周期 ，Spring 
中 的 Bean 由 Spring 管理 其 生命 周期 行为 。 


7.6 Spring 3.0 提供 的 Java 配置 管理 


Spring 3.0 为 不 喜欢 XML 的 人 提供 了 一 种 选择 : 如 果 不 喜欢 使 用 XML 来 管理 Bean、 以 及 Bean 
之 间 的 依赖 关系 ，Spring 允许 开发 者 使 用 Java 类 进行 配置 管理 。 

假如 有 如 下 Person 实现 类 。 

程序 清单 : codes\07\7.6\AppConfig\src\org\crazyit\app\service\impl\Chinese.java 


public class Chinese 
implements Person 
{ 
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Private Axe axe7 

private String name; 

// 设 值 注入 所 需 的 setter 方法 
public void setAxe (Axe axe) 


{ 
this.axe = axe; 


} 
// 设 值 注入 所 需 的 setter 方法 
public void setName (String name) 


{ 


this.name = name; 


} 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 
{ 
// 调 用 axe 的 chop () 方法 ， 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System.out.println ("我 是 : "+ name 
+ axe.chop()); 
} 
} 


上 面 的 Chinese 类 需要 注入 两 个 属性 : name 和 Axe， 本 示例 当然 也 为 Axe 提供 了 两 个 实现 类 : 
StoneAxe 和 SteelAxe。 如 果 我 们 采用 XML 配置 ， 相 应 的 配置 文件 如 下 。 
程序 清单 :codes\07\7.6\AppConfig\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://wuw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-~ 配置 chinese 实例 ， 其 实现 类 是 Chinese --> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 
<!-- 将 stoneAxe 注入 给 axe 属性 -> 
<property name="axe" ref="stoneAxe"/> 
<property name="name" Value=" 孙 悟空 "/> 
</bean> 
<!-- 孔 置 stoneAxe 实例 ， 其 实现 类 是 StoneAxe --> 
<bean id="stoneAxe" class="org.crazyit.app 


<!-- 配置 steelAxe 实例 ， 其 实现 类 是 SteelAxe --> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 
</beans> 


如 果 开 发 者 不 喜欢 使 用 XML 配置 文件 ，Spring 3.0 允许 开发 者 使 用 Java 类 进行 配置 。 
上 面 的 XML 配置 文件 可 以 替换 为 如 下 Java 配置 类 。 
程序 清单 ，codes\07\7.6\AppConfig\src\org\crazyit\app\config\AppConfig.java 


@Configuration 
public class AppConfig 


{ 
// 定 义 需 要 依赖 注入 的 属性 值 
@Value ("孙悟空 ") String personName; 
// 配 置 一 个 Bean: chinese 
@Bean (name="chinese") 
public Person person() 
{ 


rvice, impl.StoneAxe"/> 


Chinese p = new Chinese(); 
了 .setRxe (stoneAxe()); 
p.setName (PersonName) 7 
return p; 


} 

// 配 置 Bean: stoneAxe 
QBean (name="stoneAxe") 
public Axe stoneAxe() 
{ 
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return new StoneAxe(); 


} 
// 配 置 Bean: steelAxe 
@Bean (name="steelAxe") 
public Axe steelAxe() 
{ 
return new SteelAxe(); 
} 
上 


上 面 的 配置 文件 中 使 用 了 Java 配置 类 的 三 个 常用 Annotation。 
> ”@Configuration: 用 于 修饰 一 个 Java 配置 类 。 
> ”@Bean: 用 于 修饰 一 个 方法 ， 将 该 方法 的 返回 值 定义 成 容器 中 的 一 个 Bean。 
> ”@Value: 用 于 修饰 一 个 Field， 用 于 为 配置 一 个 值 。 
- 旦 使 用 了 Java 配置 类 来 管理 Spring 容器 中 Bean 及 其 依赖 关系 ， 此 时 需要 使 用 如 下 方式 来 创建 
Spring 容器 : 
7/ 创建 Spring 容器 


ApplicationContext ctx = new 
AnnotationConfigApplicationContext (AppConfig.class); 


上 面 的 AnnotationConfigApplicationContext 类 会 根据 Java 配置 类 来 创建 Spring 容器 。 不 仅 如 此 ， 
该 类 还 提供 了 一 个 register(Class) 方 法 用 于 添加 Java 配置 类 。 

获得 Spring 容器 之 后 , 接 下 来 利用 Spring 容器 获取 Bean 实例 、 调 用 Bean 方法 就 没有 任何 特别 之 
处 了 。 

使 用 Java 配置 类 时 ， 还 有 如 下 常用 的 Annotation。 

> @Import: 修饰 一 个 Java 配置 类 ， 用 于 向 当前 Java 配置 类 中 导入 其 他 Java 配置 类 。 

> ”@Scope: 用 于 修饰 一 个 方法 ， 指 定 该 方法 对 应 的 Bean 的 生命 域 。 

> ”@Lazy: 用 于 修饰 一 个 方法 ， 指 定 该 方法 对 应 的 Bean 的 是 否 需 要 延迟 初始 化 。 

> ”@DependOn: 用 于 修饰 一 个 方法 , 指定 在 初始 化 该 方法 对 应 的 Bean 之 前 初始 化 指定 Bean。 

就 笔者 的 习惯 来 看 , 还 是 使 用 XML 配置 文件 管理 Bean 及 其 依赖 关系 更 为 方便 一 一 毕竟 我 们 使 用 
XML 文件 来 管理 Bean 及 其 依赖 关系 是 为 了 解 耦 ， 但 这 种 Java 配置 类 的 方式 又 退回 到 Java 代码 耦合 
层次 ， 只 是 将 这 种 耦合 集中 到 一 个 或 多 个 Java 配置 类 中 ， 这 种 方式 到 底 有 多 少 价值 呢 ? 

实际 上 ，Spring 提供 @Configuration 和 @Bean 并 不 是 为 了 完全 取代 XML 配置 ， 只 是 希望 将 它 作 
为 XML 配置 的 一 种 补充 。 对 于 Spring 框架 的 用 户 来 说 ，Spring 配置 文件 的 “急剧 膨胀 ”是 一 个 让 人 
头痛 的 点 ， 因 此 Spring 框架 从 2.0 开始 就 不 断 地 寻找 各 种 对 配置 文件 “减肥 ”的 方法 。 

后 面 所 介绍 的 各 种 Annotation 也 都 是 为 了 简化 Spring 配置 文件 而 出 现 的 , 但 由 于 Annotation 引入 
时 间 较 晚 ， 因 此 在 一 些 特殊 功能 的 支持 上 ，Annotation 还 不 如 XML 强大 ， 因 此 在 目前 的 多 数 项 目 中 ， 
要 么 完全 使 用 XML 配置 方式 管理 Bean 的 配置 ， 要 么 使 用 以 Annotation 为 主 ，XML 为 辅 的 配置 方式 
管理 Bean 的 配置 ， 想 要 完全 放弃 XML 配置 还 是 比较 难 。 

之 所 以 会 出 现 两 者 共存 的 情况 ， 主 要 归结 为 三 个 原因 : 其 一 ， 目 前 绝 大 多 数 采 用 Spring 进行 开发 
的 项 目 ， 几 乎 都 是 基于 XML 配置 方式 的 ，Spring 在 引入 注解 的 同时 ， 必 须 保证 注解 能 够 与 XML 和 谐 
共存 ， 这 是 前 提 ; 其 二 ， 由 于 注解 引入 较 晚 ， 因 此 功能 也 没有 发 展 多 年 的 XML 强大 ， 因 此 ， 对 于 复 
杂 的 配置 ,注解 还 很 难 独当一面 , 在 一 段 时 间 内 仍然 需要 XML 的 配合 才能 解决 问题 。 除 此 之 外 , Spring 
的 Bean 的 配置 方式 与 Spring 核心 模块 之 间 是 解 看 的 ， 因 此 ， 改 变 配置 方式 对 Spring 的 框架 自身 是 透 
明 的 。Spring 可 以 通过 使 用 Bean 后 处 理 器 (BeanPostProcessor) 非常 方便 地 增加 对 于 注解 的 支持 。 这 
在 技术 实现 上 是 非常 容易 的 事情 。 

因此 实际 项 目 中 可 能 会 混合 使 用 XML 配置 和 Java 类 配置 ， 在 这 种 混合 下 存在 一 个 问题 : 项 目 到 
底 以 XML 配置 为 主 呢 ? 还 是 以 一 个 Java 类 配置 为 主 ? 

@ 如 果 以 XML 配置 为 主 ， 就 需要 让 XML 配置 能 加 载 Java 类 配置 。 这 并 不 难 ， 只 要 在 XML 
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配置 中 增加 如 下 代码 即 可 : 

<?xml version="1.0" encoding="GBK"?> 

<beans xmlns="http://www. springframework.org/schema/beans™" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www. springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context-3.0.xsd"> 
<context:annotation-config/> 
<!-- 加 载 Java 配置 类 --> 
<bean class="org.crazyit.app.config.AppConfig”/> 

</beans> 


由 于 应 用 以 XML 配置 为 主 ， 因 此 应 用 创建 Spring 容器 时 ， 还 是 以 这 份 XML 文件 为 参数 来 创建 
ApplicationContext 对 象 。 那 么 Spring 会 先 加 载 这 份 XML 配置 文件 ， 再 根据 这 份 XML 配置 文件 的 指 
示 ， 去 加 载 指定 的 Java 配置 类 。 

@ 如 果 以 Java 类 配置 为 主 ， 就 需要 让 Java 配置 类 能 加 载 XML 配置 。 这 就 需要 借助 于 
@ImportResource Annotation， 这 个 Annotation 可 修饰 Java 配置 类 ， 用 于 导入 指定 的 XML 配置 文件 。 
也 就 是 在 Java 配置 类 上 增加 如 下 Annotation 即 可 : 

econfiguration 


// 导 入 XML 配置 
8TmportResource ("classpath: /bean.xml") 
public class MyConfig 

{ 


dT 

由 于 应 用 以 Java 类 配置 为 主 ， 因 此 应 用 创建 Spring 容器 时 ， 应 以 Java 配置 类 为 参数 ， 创 建 
AnnotationConfigApplicationContext 对 象 来 作为 Spring 容器 。 那 么 Spring 会 先 加 载 这 个 Java 配置 类 ， 
再 根据 这 个 Java 配置 类 的 指示 ， 去 加 载 指定 的 XML 配置 文件 。 


7.7 ”Bean 实例 的 创建 方式 及 依赖 配置 


大 多 数 情 况 下 ，BeanFactory 直接 通过 new 关键 字 调用 构造 器 来 创建 Bean 实例 ， 而 class 属性 指 
定 了 Bean 实例 的 实现 类 。 因 此 ，<bean.…. 信 元 素 必 须 指定 Bean 实例 的 class 属性 ， 但 这 并 不 是 实例 化 
Bean 的 唯一 方法 。 


提示 ;… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
使 用 实例 工厂 方法 创建 Bean 实例 ， 以 及 使 用 子 Bean 方法 创建 Bean 实例 时 ， 都 可 以 、 
不 指定 class 属性 。 | 
创建 Bean 通常 有 如 下 方法 : 
> ”调用 构造 器 创建 Bean 实例 。 


> ”调用 静态 工厂 方法 创建 Bean。 
> ”调用 实例 工厂 方法 创建 Bean。 


》>>7.7.1 使 用 构造 器 创建 Bean 实例 


使 用 构造 器 来 创建 Bean 实例 是 最 常见 的 情况 ， 如 果 采 用 设 值 注 入 的 方式 , 要 求 该 类 提供 无 参数 
的 构造 器 。 在 这 种 情况 下 ，class 元 素 是 必需 的 (除非 采用 继承 )，class 属性 的 值 就 是 Bean 实例 的 实 
现 类 。 
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BeanFactory 将 使 用 默认 构造 器 来 创建 Bean 实例 ,该 实例 是 个 默认 实例 ,Spring 对 Bean 实例 的 所 
有 属性 执行 默认 初始 化 ， 即 所 有 基本 类 型 的 值 初始 化 为 0 或 false; 所 有 引用 类 型 的 值 初始 化 为 null。 

接 下 来 ，BeanFactory 会 根据 配置 文件 决定 依赖 关系 ， 先 实例 化 被 依赖 的 Bean 实例 ， 然 后 为 Bean 
注入 依赖 关系 。 最 后 将 一 个 完整 的 Bean 实例 返回 给 程序 ， 该 Bean 实例 的 所 有 属性 ， 已 经 由 Spring 容 
器 完成 了 初始 化 。 看 下 面 的 示例 ，Spring 将 调用 构造 器 创建 Bean 实例 。 

调用 者 Bean 的 接口 和 实现 类 : 

程序 清单 ，codes\07\7.7\direct\src\org\crazyit\app\service\Personijava 


public interface Person 


{ 
//Person 接口 里 定义 一 个 使 用 养子 的 方法 
public void useAxe(); 

} 


程序 清单 :codes\07\7.7\direct\src\org\crazyit\app\service\impl\Chinese.java 
public class Chinese 

implements Person 
{ 

private Axe axe; 

// 默 认 的 构造 器 

public Chinese() 

{ 

System,out,println("Spring 实例 化 主 调 Bean: Chinese 实例 ..."); 


} 

// 设 值 注入 所 需 的 setter 方法 

public void setAxe(Axe axe) 

{ 
System.out .println("Spring 执行 依 加 关系 注入 . .."); 
this.axe = axe; 


} 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 
{ 
System.out .println(axe.chop()); 
1 
) 


下 面 给 出 的 是 Person 接口 依赖 Bean 的 接口 和 实现 类 。 
程序 清单 : codes\07\7.7\direct\src\org\crazyit\app\service\Axe.java 
public interface Axe 
‘ 
//axe 接口 里 有 个 砍 的 方法 


public String chop()7 
} 


程序 清单 : codes\07\7.7\direct\src\org\crazyit\app\service\impl\SteelAxe.java 


public class SteelAxe 
implements Axe 


// 默 认 构造 器 
public SteelRxe() 
{ 


System.out .printlnf"Spring 实例 化 依赖 Bean: SteelAxe 实例 .，."); 


} 
// 实 现 Axe 接口 的 chop 方法 
public string chop{) 
{ 
return " 钢 状 砍 柴 真 快 "; 
} 
} 


Spring 的 配置 文件 如 下 。 
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程序 清单 : codes\07\7.7\direct\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0- xsd 语 义 约束 --> 
<beans xmlns:xsi="http://wuw.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
/wuw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
!-- 定义 第 一 个 Bean，id 是 chinese，class 指定 实现 类 --> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 
<!-- property 元 素 用 来 指定 需要 容器 注入 的 属性 ，axe 属性 需要 容器 注入 
此 处 是 设 值 注入 ， 因 此 Chinese 类 必须 拥有 setAxe 方法 --> 
<property name="axe" ref="steelAxe"/> 
</bean> 
<!-- 定义 steelAxe bean 
<bean id="steelAxe" cl 
</beans> 


主 程序 如 下 。 
程序 清单 : codes\07\7.7\direct\src\lee\BeanTestjava 


public class BeanTest 
{ 


="org.crazyit.app.service.impl.SteelAxe"/> 


public static void main(String[] args) 

{ 
ApplicationContext ctx = new 

ClassPathxmlApplicationContext ("bean. xml"); 

Person p = ctx.getBean("chinese" , Person.class); 
p.useAxe(); 

} 

} 


上 面 的 程序 中 粗 体 字 代码 仅仅 获取 了 一 个 Person 对 象 ，Spring 会 先 创建 Person 所 依赖 的 Bean 实 
例 , 再 创建 一 个 默认 的 Person 实例 , 然后 将 Person 所 依赖 的 Bean 实例 注入 Person 实例 。 执行 该 程序 ， 
看 到 如 下 执行 效果 : 


Spring 实例 化 依赖 Bean: SteelAxe 实例 . . . 
Spring 执行 依赖 关系 注入 .. 
钢 养 砍 柴 真 快 


执行 结果 清楚 地 反映 了 执行 过 程 : 

(1) 程序 创建 ApplicationContext 实例 。 

(2) 调用 Chinese 类 的 默认 构造 器 创建 默认 实例 。 

(3) 根据 配置 文件 注入 依赖 关系 ， 先 实例 化 依赖 Bean， 然 后 将 依赖 Bean 注入 。 
(4) 返回 一 个 完整 的 Chinese 实例 。 


》>>7.7.2 ”使 用 静态 工厂 方法 创建 Bean 


使 用 静态 工厂 方法 创建 Bean 实例 时 ，class 属性 也 必须 指定 ， 但 此 时 class 属性 并 不 是 指定 Bean 
实例 的 实现 类 ， 而 是 静态 工厂 类 。Spring 需要 知道 由 哪个 静态 工厂 方法 来 创建 Bean 实例 。 

除 此 之 外 ， 还 需要 使 用 factory-method 属性 来 指定 静态 工厂 方法 名 ，Spring 将 调用 静态 工厂 方法 
《可 能 包含 一 组 参数 )， 来 返回 一 个 Bean 实例 ， 一 旦 获得 了 指定 Bean 实例 ，Spring 后 面 的 处 理 步骤 与 
采用 普通 方法 创建 Bean 实例 则 完全 一 样 。 

下 面 的 Bean 要 由 factory-method 指定 的 静态 工厂 方法 来 创建 ， 所 以 这 个 <bean... 人 > 元 素 的 class 属 
性 指定 的 是 静态 工厂 类 ，factory-method 指定 的 工厂 方法 必须 是 静态 的 。 由 此 可 见 ， 采 用 静态 工厂 方法 
创建 Bean 实例 时 ，<bean.… 记 元素 需 要 指定 如 下 两 个 属性 。 

> ”class: 该 属性 的 值 为 静态 工厂 类 的 类 名 。 

> ”factory-method: 该 属性 指定 静态 工厂 方法 来 生产 Bean 实例 。 


572 


http://52pdf.taobao.com 


7 


如 果 静 态 工厂 方法 需要 参数 ， 则 使 用 <constructor-arg.… 人 > 元 素 传 入 。 

下 面 先 定义 一 个 Being 接口 ， 静 态 工厂 方法 所 产生 的 产品 是 该 接口 的 实例 。 
程序 清单 : codes\07\7.7staticFactory\src\org\crazyit\app\service\Being.java 
public interface Being 


// 接 口 定义 testBeing 方法 
Public void testBeing() 7 
i 


下 面 是 接口 的 两 个 实现 类 ， 静 态 工厂 方法 将 会 产生 这 两 个 实现 类 的 实例 。 
程序 清单 ，codes\O7\V7.7\staticFactory\srcvorg\crazyitapp\service\impI\Dog:java 


public class Dog 
implements Being 

{ 
private String msg; 
// 依 赖 注 入 时 候 必 须 的 sette 方法 
public void setMsg(String msg) 
{ 

this.msg = msg7 


} 

// 实 现 接口 必须 实现 的 testBeing 方法 
public void testBeing() 

{ 


System.out .println(msg + 
” 狗 爱 哺 骨 头 ") 7 
} 
} 


程序 清单 ，codes\07\7.7\staticFactory\src\org\crazyit\app\service\limpl\Cat.java 


public class Cat 
implements Being 

{ 
private String msg; 
// 依 赖 注入 时 候 必 须 的 setter 方法 
public void setMsg(String msg) 
{ 

this.msg = msg; 


) 

// 实 现 接口 必须 实现 的 testBeing 方法 
public void testBeing() 

{ 


System.out .println(msg + 
二 猎 喜 欢 吃 老鼠 ") ; 
)} 
} 


下 面 的 BeingFactory 工厂 包含 了 一 个 getBeing 静态 方法 ， 该 静态 方法 用 于 返回 一 个 Being 实例 ， 
这 是 典型 的 静态 工厂 的 设计 模式 。 
程序 清单 : codes\07\7.7\staticFactory\src\org\crazyit\app\factory\BeingFactory.java 


public class BeingFactory 
/a 
* 获取 Being 实例 的 静态 工厂 方法 
2 arg 决定 返回 哪个 Being 实例 的 参数 
public static Being getBeing (Stzing arg) 
{ 


// 调 用 此 静态 方法 的 参数 为 dog， 则 返回 Dog 实例 
if (arg.eqialsIgnoreCase("dog")) 
{ 


return new Dog(); 
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// 否 则 返回 cat 实例 
else 
{ 
return new Cat(); 
} 
} 
3 


上 面 的 BeingFactory 类 是 一 个 静态 工厂 类 , 该 类 的 getBeing() 方 法 是 一 个 静态 工厂 方法 , 该 方法 根 
据 传 入 的 参数 决定 返回 Cat 对 象 ， 还 是 Dog 对 象 。 

如 果 需 要 指定 Spring 让 BeingFactory 来 生产 Being 对 象 ， 则 应 该 按 如 下 静态 工厂 方法 的 方式 来 配 
和 Dog、Cat Bean。 本 应 用 中 Spring 配置 文件 如 下 。 

程序 清单 :codes\07\7.7\staticFactory\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beansn 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 BeingFactory 的 getBeing 方法 产生 dog Bean --> 
<bean id="dog" class="org.crazyit.app. factory.BeingFactory" 
factory-method="getBeing"> 
<!-- 配置 静态 工厂 方法 的 参数 --> 
<constructor-arg value="dog"/> 
<!-- property 配置 普通 依赖 注入 属性 --> 


factory-method="getBeing"> 
<!-- PE 
<constructor-arg value="cat"/> 
<!-~ Property 配置 普通 性 --> 
<property name="msg”value=" 我 是 猫 "/> 
< 
</beans> 


从 上 面 的 配置 文件 可 以 看 出 ，cat 和 dog 两 个 Bean 配置 的 class 属性 和 factory-method 属性 完全 相 
同一 一 这 是 因为 这 两 个 实例 都 是 由 同一 个 静态 工厂 类 、 同 一 个 静态 工厂 方法 生产 得 到 的 。 配 置 这 两 个 
Bean 实例 指定 了 静态 工厂 方法 的 实 参 值 不 同 ， 配置 工厂 方法 的 实 参 值 使 用 <contructor-arg.…. 亿 元素， 如 
上 配置 文件 所 示 。 

主 程序 获取 Spring 容器 的 cat、dog 两 个 Bean 实例 的 方法 依然 无 须 改变 ， 只 需要 调用 Spring 容器 
的 getBean() 方 法 即 可 。 主 程序 如 下 。 

程序 清单 : codes\07\7.7\staticFactory\src\lee\SpringTestjava 

public class SpringTest 


public static void main(String[] args) 


{ 
// 以 类 加 载 路 径 下 的 配置 文件 创建 ClassPathResource 实例 
ApplicationContext ctx = new 

ClassPathXmlApplicationContext ("bean.xml"); 

Being bl = ctx.getBean("dog" , Being.class); 
bl,testBeing()7 
Being b2 = ctx.getBean("cat" , Being.class); 
b2.testBeing(); 

} 

} 


使 用 静态 工厂 方法 创建 实例 时 必须 提供 工厂 类 ， 工 厂 类 包含 产生 实例 的 静态 工厂 方法 。 通 过 静态 
工厂 方法 创建 实例 需要 对 配置 文件 进行 如 下 改变 : 
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> ”class 属性 的 值 不 再 是 Bean 实例 的 实现 类 ， 而 是 生成 Bean 实例 的 静态 工厂 类 。 

> ”使 用 factory-method 属性 指定 生产 Bean 实例 的 静态 工厂 方法 。 

> ”如 果 静 态 工厂 方法 需要 参数 ， 则 使 用 <constructor-arg.…/> 元 素 指定 静态 工厂 方法 的 参数 。 

当 我 们 指定 Spring 使 用 静态 工厂 方法 来 创建 Bean 实例 时 ，Spring 将 先 解析 配置 文件 ， 并 根据 配置 文 
件 指定 的 信息 ， 通 过 反射 调用 静态 工厂 类 的 静态 工厂 方法 ， 将 该 静态 工厂 方法 的 返回 值 作为 Bean 实例 。 
在 这 个 过 程 中 ，Spring 不 再 负责 创建 Bean 实例 ，Bean 实例 是 由 用 户 提供 的 静态 工厂 类 负责 创建 的 。 

当 静 态 工厂 方法 创建 了 Bean 实例 后 ，Spring 依然 可 以 管理 该 Bean 实例 的 依赖 关闭 ， 包 括 为 其 注 
入 所 需 的 依赖 关系 、 管 理 其 生命 周期 等 。 


>>7.7.3 调用 实例 工厂 方法 创建 Bean 


实例 工厂 方法 与 静态 工厂 方法 只 有 一 点 不 同调 用 静态 工厂 方法 只 需 使 用 工厂 类 即 可 ， 调 用 实例 
工厂 方法 则 必须 使 用 工厂 实例 。 所 以 配置 实例 工厂 方法 与 配置 静态 工厂 方法 也 基本 相似 ， 只 有 一 点 区 
别 : 配置 静态 工厂 方法 指定 静态 工厂 类 ， 配 置 实例 工厂 方法 则 指定 工厂 实例 。 

使 用 实例 工厂 方法 时 ， 配 置 Bean 实例 的 <bean... 人 > 元 素 无 须 class 属性 ， 因 为 Spring 容器 不 再 直接 
实例 化 该 Bean，Spring 容器 仅仅 调用 实例 工厂 的 工厂 方法 ， 工 厂 方法 负责 创建 Bean 实例 。 

采用 实例 工厂 方法 创建 Bean 的 <bean... 人 > 元 素 时 需要 指定 如 下 两 个 属性 ， 

> ”factory-bean: 该 属性 的 值 为 工厂 Bean 的 id。 

> ”factory-method: 该 属性 指定 实例 工厂 的 工厂 方法 。 

与 静态 工厂 方法 相似 ， 如 果 需 要 在 调用 工厂 方法 时 传 入 参数 ， 则 使 用 <constructor-arg.…/> 元 素 确定 
参数 值 。 

下 面 先 定义 一 个 Person 接口 ， 实 例 工厂 方法 所 产生 的 对 象 将 实现 Person 接口 。 

程序 清单 : codes\07\7.7\factory\src\org\crazyit\app\service\Person.java 

Public interface Person 


// 定 义 一 个 打招呼 的 方法 

public String sayHello(String name); 

// 定 义 一 个 告别 的 方法 

public String sayGoodBye(String name); 
} 


该 接口 定义 Person 的 规范 ， 该 接口 必须 拥有 两 个 方法 ;能 打招呼 、 能 告别 ， 实 现 该 接口 的 类 必须 
实现 这 两 个 方法 。 下 面 是 Person 接口 的 第 一 个 实现 类 : American。 
程序 清单 : codes\07\7.7\factory\src\org\crazyit\app\service\impl\American.java 


public class American 
implements Person 
{ 
// 实 现 Person 接口 必须 实现 如 下 两 个 方法 
public String sayHello(String name) 
{ 
return name + ",Hello!™; 


上 
public String sayGoodBye(String name) 
{ 


return name + ",Good Bye!"; 
} 
} 


下 面 是 实现 Person 接口 的 另 一 个 类 : Chinese。 
程序 清单 :codes\07\7. Deceasedleray laneericelimoN ihesel java 


Public class Chinese 
implements Person 
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// 实 现 Person 接口 必须 实现 如 下 两 个 方法 
public String sayHello(String name) 
0 "您 好 "> 
Did String sayGoodBye String name) 
: return name + "， 下 次 再 见 "; 

: ) 


PersonFactory 是 负责 产生 Person 对 象 的 实例 工厂 ， 该 工厂 类 里 提供 了 一 个 getPerson( 方 法 ， 该 方 
法 根据 传 入 的 ethnic 参数 决定 产生 哪 种 Person 对 象 。 工 厂 类 代码 如 下 。 
程序 清单 : codes\07\7.7\factory\src\org\crazyit\app\factory\PersonFactory.java 


public class PersonFactory 


us 
* 获得 Person 实例 的 实例 工厂 方法 
* eparam ethnic 决定 返回 哪个 Person 实例 的 参数 
* ereturn 返回 Person 实例 
可 

public Person getperson (String ethnic) 


if (ethnic.equalsIgnoreCase ("chin")) 
{ 
return new Chinese(); 


else 
人 
return new American(); 
} 
} 


上 面 的 PersonFactory 就 是 一 个 简单 的 Person 工厂 ， getPerson() 方 法 就 是 负责 生产 Person 的 工厂 
方法 。 配 置 实例 工厂 与 配置 静态 工厂 基本 相似 ， 只 需 将 原来 的 静态 工厂 类 改 为 现在 的 工厂 实例 即 可 。 
该 应 用 的 配置 文件 如 下 。 

程序 清单 : codes\07\7.7\factory\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www, Springframework.org/schema/beans 
http://wuw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 工厂 Bean, 该 Bean 负责 产生 其 他 Bean 实例 --> 
<bean id="personFactory” 
class="org.crazyit.app. factory.PersonFactory"/> 
<!-- 采用 实例 工厂 创建 Bean 实例 ，factory-bean 指定 工厂 Bean 的 id 属性 
factory-method 属性 指定 工厂 Bean 的 实例 工厂 方法 --> 
<bean id="chinese" factory-bean="personFactory" 
factory-method="getPerson"> 
<!-- 调用 工厂 方法 时 ， 传 入 的 参数 通过 constructor-arg 元 素 指定 --> 
<constructor-arg value="chin"/> 
</bean> 
pn 
factory-method=" 
<constructor-arg rd 
</bean> 
</beans> 


调用 实例 工厂 方法 创建 Bean， 与 调用 静态 工厂 方法 创建 Bean 的 用 法 基本 相似 。 区 别 如 下 : 
> ”调用 实例 工厂 方法 创建 Bean, 必须 将 实例 工厂 配置 成 Bean 实例 .而 静态 工厂 方法 创建 Bean， 
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则 无 须 配 置 工厂 Bean。 

> ”调用 实例 工厂 方法 创建 Bean， 必须 使 用 factory-bean 属性 确定 工厂 Bean。 而 静态 工厂 方法 
创建 Bean， 则 使 用 class 元 素 确定 静态 工厂 类 。 

相同 之 处 

> ”都 需 使 用 factory-method 属性 指定 产生 Bean 实例 的 工厂 方法 。 

> 工厂 方法 如 果 和 需要 参数 ， 都 使 用 <constructor-arg..…/> 元 素 指定 参数 值 。 

> ”其 他 依赖 注入 属性 ， 都 使 用 <property.…/> 元 素 确定 参数 值 。 


7.8 深入 理解 容器 中 的 Bean 


Spring 框架 绝 大 部 分 工作 都 集中 在 对 容器 中 Bean 的 管理 上 ， 包 括 管理 容器 中 Bean 的 生命 周期 ， 
使 用 Bean 继承 等 特殊 功能 。 通 过 这 些 深入 的 管理 ， 应 用 程序 可 以 更 好 地 使 用 这 些 Java 组 件 〈 容 器 中 
的 Bean 对 应 用 而 言 ， 往 往 是 一 个 组 件 )。 


》>>7.8.1 使 用 抽象 Bean 


所 有 抽象 Bean， 就 是 指定 abstract 属性 为 true 的 Bean， 抽 象 Bean 不 能 被 实例 化 ，Spring 容器 不 
会 创建 抽象 Bean 的 实例 。 抽 象 Bean 的 价值 在 于 被 继承 ， 抽 象 Bean 通常 作为 父 Bean 被 继承 。 关 于 
Spring 容器 中 的 Bean 继承 请 看 下 一 节 的 内 容 。 

当 某 个 Bean 将 作为 其 他 Bean 的 模板 使 用 时 ， 该 Bean 通常 不 需要 实例 化 ， 而 ApplicationContext 
默认 预 初始 化 所 有 的 singleton Bean。 为 了 阻止 Bean 模板 被 预 初始 化 ， 可 指定 abstract="true" 将 该 模板 
Bean 设置 为 抽象 Bean，Spring 容器 会 忽略 所 有 的 抽象 Bean 定义 ， 预 初始 化 时 不 初始 化 抽象 Bean。 抽 
象 Bean 的 定义 如 下 面 的 配置 文件 所 示 。 

<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://wuw.springframework.org/schema/beans 
http://www, springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="steelAxe" class="org.crazyit.app. service.impl.SteelAxe"/> 
<!-- 通过 abstract 属性 定义 该 Bean 是 抽象 Bean --> 
<bean id="chineseTemplate" class=" org.crazyit.app.service.impl.Chinese" 
abstract="true"> 
<!-~ 定义 依赖 注入 的 属性 --> 
<property name="axe" ref="steelAxe"/> 
</bean> 
</beans> 


从 配置 文件 中 可 以 看 出 ， 抽 象 Bean 的 定义 与 普通 Bean 的 定义 几乎 没有 区 别 ， 仅 仅 增加 abstract 
属性 为 ue。 当 Spring 处 理 普通 Bean 和 处 理 抽象 Bean 时 存在 明显 的 区 别 。 
当 程 序 采 用 ApplicationContext 作为 Spring 容器 ， 程 序 实例 化 ApplicationContext 容器 时 会 默认 实 
例 化 所 有 singleton Bean， 但 不 会 初始 化 abstract Bean。 
抽象 Bean 是 一 个 Bean 模板 ， 容 器 会 忽略 抽象 Bean 定义 ， 不 会 实例 化 抽象 Bean。 抽 象 Bean 
为 无 须 实例 化 ， 因 此 可 以 没有 class 属性 ， 即 如 下 的 配置 文件 也 是 有 效 的 。 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 


<!-- 通过 abstract 属性 定义 该 Bean 是 抽象 Bean, 
抽象 Bean 可 以 没有 指定 class 属性 --> 
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<bean id="chineseTemplate" abstract="true"> 
<!-- 定义 依赖 注入 的 属性 -> 
<property name="axe" ref="steelAxe"/> 
</bean> 
</beans> 
二 、 
: 短 - 注 总: 
抽象 Bean 不 能 实例 化 ， 因 此 ， 县 不 能 通过 getBean0) 显 式 地 获得 抽象 Bean 实例 ， 也 


不 能 将 抽象 Bean 注入 成 其 他 Bean 依赖 属性 .不 论 如 何 ， 只 要 企图 实例 化 抽象 Bean， 都 可 


将 导致 错误 。 


》>>7.8.2 使 用 子 Bean 


随 着 应 用 规模 的 增 大 ，Spmng 配置 文件 的 增长 速度 更 快 。 当 应 用 中 组 件 越 来 越 多 时 ，Spring 配置 
文件 里 的 Bean 配置 也 随 之 大 幅度 增加 ， 慢 慢 地 就 出 现 了 一 种 现象 有 一 批 Bean 配置 的 大 量 配置 信息 
完全 相同 ， 只 有 少量 配置 不 同 。 那 么 我 们 是 否 有 办 法 来 简化 这 种 配置 呢 ? 

Spring 提供 了 Bean 继承 来 应 对 这 个 问题 !Spring 可 以 先 为 这 批 Bean 配置 一 个 Bean 模板 一 一 将 这 
批 Bean 中 相同 的 配置 信息 配置 成 Bean 模板 ， 因 为 Spring 容器 无 须 创建 Bean 模板 的 实例 ， 所 以 通常 
将 这 个 Bean 模板 配 成 抽象 Bean。 

将 大 部 分 相同 信息 配置 成 Bean 模板 后 ， 将 实际 的 Bean 实例 配置 成 该 Bean 模板 的 子 Bean 即 可 。 
子 Bean 定义 可 以 从 父 Bean 继承 实现 类 、 构 造 器 参数 、 属 性 值 等 配置 信息 ， 除 此 之 外 ， 子 Bean 配置 
人 息 ， 并 可 指定 新 的 配置 信息 覆盖 父 Bean 的 定义 。 

一 致 时 ， 子 Bean 所 3 


子 Bean 无 法 从 父 Bean 继承 如 下 属性 ，depends-on、autowire、singleton、scope、lazy-init， 这 些 局 
性 将 总 是 从 子 Bean 定义 中 获得 ， 或 采用 默认 值 。 

通过 为 一 个 <bean... 人 > 元素 指定 parent 属性 即 可 指定 该 Bean 是 一 个 子 Bean,parent 属性 指定 该 Bean 
所 继承 的 父 Bean 的 id。 修改 上 面 的 配置 文件 如 下 ， 增 加 了 子 Bean 定义 。 

程序 清单 : codes\07\7.8\abstract\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 

<!-~ Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema~instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://wuw, springframework.org/schena/beans/spring-beans-3.0.xsd"> 
<!-- 定义 两 个 Axe 实例 --> 
<bean id="steelAxe" cl 
<bean id="stoneAxe" clas: 


“ 北 : 渤 是 ， : 因 、 
当 子 Bean 指定 的 配置 信息 与 父 Bean 模板 所 指定 的 配置 信 
指定 的 配置 信息 将 会 覆盖 父 Bean 所 指定 的 配置 信 


rg -crazyit,app.service.imp1.SteelRhxen/> 


<bean id="chineseTemplate" class="org.crazyit.app.service.impl.Chinese" 
abstract="true"> 
<property name="axe" ref="steelAxe"/> 
< 
<!-- 通过 parent 属性 定义 子 bean --> 
<bean id="chinese" parent="chineseTeaplate"/> 
</beans> 


配置 文件 中 chinese Bean 定义 仅 有 一 个 parent 属性 ， 连 class 属性 都 可 省 略 ， 如 果 父 Bean 定义 中 
有 elass 属性 ， 则 子 Bean 定义 中 可 省 略 class 属性 ， 子 Bean 将 采用 与 父 Bean 相同 的 实现 类 。 程 序 执 
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行 结果 如 下 : 
Spring 实例 化 依赖 bean: SteelAxe 实例 . - . 
Spring 实例 化 依赖 Dean: StoneAxe 实例 . . 
Spring 实例 化 主 调 bean: Chinese 实例 .. . 
Spring 执行 依 


子 Bean 从 父 Bean 定义 继承 了 实现 类 、 依 赖 关系 等 配置 信息 。 实 际 上 ， 子 Bean 也 可 攻 盖 父 Bean 


的 配置 信息 ， 看 如 下 的 配置 文件 。 
程序 清单 : codes\07\7.8\abstract\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns="http://www .springframework.org/schema/beans" 
hemaLocation="http: //www. springframework.org/schema/beans 
/wuw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 两 个 Axe 实例 --> 
<bean id="steelAxe" class="org.crazyit 
<bean id="stoneAxe" class="org.crazyit 
<!-- 通过 abstract 属性 定义 该 Bean 是 抽象 Be: 
<bean id="chineseTemplate" class="org. 
abstract="true"> 
<property name="axe" ref="steelAxe"/> 
</bean> 
<!-- 通过 parent 属性 定义 子 bean --> 
<bean id-"chinese" parent="chineseTemplate"> 
<!-- 观 盖 父 Bean 中 依赖 关系 的 配置 --> 
<property name="axe”ref="stonahxen/> 


ervice.impl.SteelRxen/> 
rvice. impl.StoneAxe"/> 


azyit,app. service. impl.Chinese" 


</bean> 
</beans> 
上 面 的 配置 文件 中 配置 chinese Bean 时 ， 不 仅 指定 parent="chineseTemplate"， 这 表明 该 Bean 继承 
了 chineseTemplate Bean， 将 会 从 该 Bean 模板 中 获得 大 量 配 置信 息 。 除 此 之 外 ，chinese Bean 中 再 次 配 
算 将 stoneAxe 注入 给 axe 属性 一 一 这 将 覆盖 父 Bean 中 的 配置 。 
再 次 运行 主 程序 ， 将 看 到 如 下 的 运行 结果 : 
Spring 实例 化 依赖 bean: SteelAxe 实例 . . . 
spring 实例 化 依赖 bean; StoneAxe 实例 . . . 
Spring 实例 化 主 调 bean: Chinese 实例 ... 
Spring 执行 依赖 关系 注入 . 
石 状 砍 柴 好 慢 


true 
子 Bean 的 依赖 佐 头 将 变 成 stoneAxe， 不 再 是 父 Bean 所 配置 的 steelAxe 依赖 了 。 
号. 


上 例 中 的 子 Bean 定义 都 没有 class 属 父 Bean 定义 中 已 有 class 属性 ， 
子 Bean 的 class 属性 从 父 Bean 定义 中 继承 。 如 果 父 Bean 定义 中 也 没有 指定 class 属性 ， 
则 子 Bean 定义 中 必须 指定 class 属性 , 否则 出 错 . 如 果 父 Bean 定义 中 指定 了 class 属性 ， 
子 Bean 定义 中 也 指定 了 class 属性 , 则 子 Bean 定义 的 class 属性 覆盖 父 Bean 定义 的 class 守 
属性 。 


> >》7.8.3 Bean 继承 与 Java 继承 的 区 别 
Spring 中 的 Bean 继承 与 Java 中 的 继承 截然 不 同 。 前 者 是 实例 与 实例 之 间 的 参数 的 延续 ， 后 者 则 
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是 一 般 到 特殊 的 细 化 ; 前 者 是 对 象 与 对 象 之 间 的 关系 , 后 者 是 类 与 类 之 间 的 关系 。Spring 中 Bean 的 继 
承 和 Java 中 Bean 的 继承 有 如 下 区 别 : 
> ”Spring 中 的 子 Bean 和 父 Bean 可 以 是 不 同类 型 ,但 Java 中 的 继承 则 可 保证 子 类 是 一 种 特殊 
的 父 类 。 
> Spring 中 Bean 的 继承 是 实例 之 间 的 关系 ， 因 此 主要 表现 为 参数 值 的 延续 ， 而 Java 中 的 继 
承 是 类 之 间 的 关系 ， 主 要 表现 为 方法 、 属 性 的 延续 。 
> Spring 中 子 Bean 不 可 作为 父 Bean 使 用 ， 不 具备 多 态 性 ; Java 中 的 子 类 实例 完全 可 当成 父 
类 实例 使 用 。 


>>7.8.4 容器 中 的 工厂 Bean 


此 处 的 工厂 Bean， 与 前 面 介绍 的 实例 工厂 方法 创建 Bean， 或 者 静态 工厂 方法 创建 Bean 的 工厂 有 
所 区 别 : 前 面 那些 工厂 是 标准 的 工厂 模式 ,Spring 只 是 负责 调用 工厂 方法 来 创建 Bean 实例 ; 此 处 的 工 
厂 Bean 是 Spring 的 一 种 特殊 Bean， 这 种 工厂 Bean 必须 实现 FactoryBean 接口 。 

FactoryBean 接口 是 工厂 Bean 的 标准 接口 ， 实 现 该 接口 的 Bean 通常 只 能 作为 工厂 Bean 使 用 ， 当 
我 们 将 工厂 Bean 部 署 在 容器 中 , 并 通过 getBean0 方 法 来 获取 工厂 Bean 时 , 容器 不 会 返回 FactoryBean 
实例 ， 而 是 返回 FactoryBean 的 产品 。 

FactoryBean 接口 提供 如 下 三 个 方法 。 

> TgetObject(): 实现 该 方法 负责 返回 该 工厂 Bean 生成 的 Java 实例 。 

> Class<?> getObjectType(): 实现 该 方法 返回 该 工厂 Bean 生成 的 Java 实例 的 实现 类 。 

> ”boolean isSingleton(): 实现 该 方法 表示 该 工厂 Bean 生成 的 Java 实例 是 否 为 单 例 模 式 。 

实现 FactoryBean 接口 的 Bean 无 法 作为 正常 Bean 使 用 ， 配 置 FactoryBean 与 配置 普通 Bean 的 定 
义 没有 区 别 ， 但 当 客户 端 对 该 Bean id 请 求 时 ， 容 器 返回 该 FactoryBean 的 产品 ， 而 不 是 返回 该 
FactoryBean 本 身 。 


和 = 
Fe 也 就 是 说 ， 当 我 们 在 Spring 容器 中 部 署 一 个 工厂 Bean 之 后 ， 接 下 来 程序 尝试 获取 该 


下 面 定 义 了 一 个 标准 的 工厂 Bean， 这 个 工厂 Bean 实现 了 FactoryBean 接口 。 
程序 清单 : codes\07\7.8\FactoryBean\src\org\crazyit\app\factory\PersonFactory.java 


//PersonFactory 实现 FactoryBean 接口 ， 将 作为 工厂 Bean 使 用 
public class PersonFactory 
implements FactoryBean<Person> 
{ 
Person p = nvll; 
7/ 返回 工厂 Bean 所 生产 的 产品 
public Person getobject() 
{ 
if (p == null) 
{ 
p = new Chinese(); 
} 
return pi 


} 
// 获 取 工 厂 Bean 所 生产 的 产品 的 类 型 
Ppublic Class<? extends Person> getobjectType() 
{ 
return Chinese.class; 
} 
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// 返 回 该 工厂 Bean 所 生成 的 产品 是 否 为 单 例 
Public boolean isSingleton() 
{ 


return true; 
} 
本 
上 面 的 PersonFactory 是 一 个 标准 的 工厂 Bean， 该 PersonFactory 的 getObject0 方 法 保证 每 次 产生 
的 Person 对 象 是 单 例 的 ， 故 该 工厂 类 的 isSingleton0 方 法 返回 tue。 
将 上 面 的 PersonFactory 当成 普通 Bean 部 署 在 Spring 容器 中 ， 程 序 的 配置 文件 如 下 。 
程序 清单 : codes\07\7.8\FactoryBean\src\bean.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans" 
xsi ‘hemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 一 个 FactoryBean， 与 配置 背 通 Bean 完全 一 样 --> 
<bean id="chinese" class="org.crazyit.app.factory.PersonFactory"/> 
</beans> 
从 上 面 的 程序 可 以 看 出 , 部 署 工厂 Bean 与 部 署 普 通 Bean 其 实 没有 任何 区 别 , 同样 只 是 为 该 Bean 
配置 id、class 两 个 属性 即 可 。 
接 下 来 主 程序 请 求 获得 chinese Bean。 
程序 清单 : codes\07\7.8\FactoryBean\src\lee\SpringTest.java 
public class SpringTest 
旷 


public static void main(String[] args)throws Exception 

{ 
ApplicationContext ctx = new 

ClassPathXmlApplicationContext ("bean.xml"); 

// 直 接 请 求 FactoryBean 时 ， 系 统 将 返回 该 FactoryBean 的 产品 
Person P1 = ctx.getBean("chinese" , Person.class); 
System ,out .Println (pl1. sayHello ("Mary")); 
System.out.println (pl.sayGoodBye ("Mary")); 
// 再 次 获取 该 FactoryBean 的 产品 
Person p2 = ctx.getBean("chinese" , Person.class); 
System.out .println(pl == p2); 
// 如 需 获取 FactoryBean 本 身 ， 则 应 该 在 Bean id 前 增加 & 
System.out.printin(ctx.getBean("échinese")); 

} 

} 


上 面 的 程序 中 前 两 行 粗 体 字 代码 直接 请 求 容 器 中 的 FactoryBean, Spring 将 不 会 返回 该 FactoryBean 
实例 ， 而 是 返回 该 FactoryBean 的 产品 ， 程 序 的 第 三 行 粗 体 字 代码 在 Bean id 前 增加 & 符 号 ， 这 将 会 让 
Spring 返回 FactoryBean 本 身 。 

因为 FactoryBean 以 单 例 方式 管理 产品 Bean， 因 此 两 次 请 求 的 产品 ， 是 同一 个 共享 实例 。 

当 程序 需要 获得 FactoryBean 本 身 时 ， 并 不 直接 请 求 Bean id， 而 是 在 Bean id 前 增加 & 符 号 ， 容 器 
则 返回 FactoryBean 本 身 ， 而 不 是 其 产品 Bean。 

对 于 初学 者 而 言 ， 可 能 无 法 体会 到 工厂 Bean 的 作用 。 实 际 上 ，FactoryBean 是 Spring 中 非常 有 用 
的 一 个 接口 ，Spring 内 置 提供 了 很 多 实用 的 工厂 Bean， 例 如 TransactionProxyFactoryBean 等 ， 这 个 工 
门 用 于 为 目标 Bean 创建 事务 代理 。 


提示 :一 一 一 一 一 一 一 一 一 一 一 .一 .一 一 
部 Spring 提供 的 工厂 Bean， 大 多 以 FactoryBean 后 缓 结尾 ， Bean, 大 ， 
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>>7.8.5 获得 Bean 本 身 的 id 


在 前 面 的 示例 程序 中 , 程序 总 是 通过 Bean id 主动 来 获取 Bean 实例 ,程序 总 是 先 获得 Bean id， 然 
后 采取 获得 Bean 对 象 。 

但 对 于 一 个 真正 的 应 用 而 言 ， 一 个 Bean 与 Bean 之 间 的 关系 是 通过 依赖 注入 管理 的 ， 常 常 不 会 通 
过 调用 容器 的 getBean 方法 来 获取 Bean 实例 。 可 能 的 情况 是 : 应 用 中 已 经 获得 了 Bean 实例 的 引用 ， 
但 程序 无 法 知道 配置 该 Bean 时 指定 的 id 属性， 而 程序 又 需要 获取 配置 该 Bean 时 指定 的 id 属性 。 

除 此 之 外 ， 当 程序 定义 一 个 Bean 类 时 , 该 Bean 何 时 被 部 署 到 Spring 容器 中 ? 部署 到 Spring 容器 
时 所 指定 id 是 什么 ? 开发 该 Bean 类 时 无 从 知道 。 

在 某 些 极端 情况 下 ， 程 序 开 发 Bean 类 时 需要 获得 在 容器 中 部 署 该 Bean 时 指定 的 id 属性 ， 此 时 
可 借助 于 Spring 提供 的 BeanNameAware 接口 ， 通 过 该 接口 允许 Bean 类 获取 部 署 该 Bean 时 指定 的 id 
属性 。 

BeanNameAware 接口 提供 一 个 方法 :setBeanName(String name)， 该 方法 的 name 参数 就 是 Bean 
的 id， 实现 该 方法 的 Bean 类 就 可 通过 该 方法 来 获得 部 署 该 Bean 的 id 了。 
人 BeanNameAware 接口 中 的 setBeanName(String name) 方 法 与 前 面 介绍 的 BeanFactory 
”Aware、ApplicationContextAware 两 个 接口 中 的 setter 方法 一 样 ， 这 个 setter 方法 不 是 由 程 | 
| 。 序 员 来 调用 的 ， 该 方法 由 Spring 容器 负责 调用 一 一 当 Spring 容器 调用 这 个 setter 方法 时 ， 

会 把 部 署 该 Bean 的 id 属性 作为 参数 传 入 。 1 


下 面 定义 了 一 个 Bean， 该 Bean 实现 了 BeanNameAware 接口 。 
程序 清单 : codes\07\7.8\BeanNameAware\src\org\crazyit\app\service\Chinese.java 


public class Chinese 
implements BeanNameAware 


// 保 存 部 署 该 Bean 时 指定 的 id 属性 

Private String beanName; 

Public void setBeanName (String name) 
{ 


有 


this.beanName = name; 


} 
public void info() 
{ 
System.out.println("Chinese 实现 类 " 
+ "， 部 署 该 Bean 时 指定 的 id 为 ”+ beanName) 7 
) 
} 


将 该 Bean 部 署 在 容器 中 ， 该 Bean 的 部 署 与 普通 Bean 的 部 署 没有 任何 区 别 。 在 主 程序 中 通过 如 
下 代码 测试 。 
程序 清单 :; codes\07\7.8\BeanNameAware\src\lee\SpringTestjava 
public class SpringTest 
public static void main(String[] args) 
{ 


// 创 建 Spring 容器 ， 容 器 会 自动 预 初始 化 所 有 Bean 实例 
ApplicationContext ctx = 

new ClassPathxmlApplicationContext ("bean. xml"); 
Chinese chin = ctx.getBean("chinese" , Chinese.class); 
chin.info(); 
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上 面 的 主 程序 没有 丝毫 特殊 之 处 , 程序 仅仅 创建 了 ApplicationContext 实例 ， 也 就 是 创建 了 Spring 
容器 ，ApplicationContext 容器 会 预 初始 化 所 有 singleton 作用 域 的 Bean 实例 。 

从 代码 执行 结果 可 以 看 到 ，Spring 容器 初始 化 该 Bean 实例 时 回调 setBeanName( 方 法 ， 回 调 该 方 
法 时 ， 应 用 程序 将 可 以 获得 该 Bean 的 id 属性 值 。 


在 Bean 类 中 需要 获得 Bean id 的 情况 并 不 是 特别 常见 的 ， 但 如 果 有 这 种 需要 ， 我 们 就 “ 


,提示 : 
ES 可 考虑 让 Bean 类 实现 BeanNameAware 接口 。 | 


Spring 容器 何 时 回调 Bean 实例 的 setBeanName(String name) 方 法 呢 ? Spring 容器 会 在 Bean 初始 化 
完成 后 回调 该 方法 一 一 这 里 的 初始 化 指 的 是 Bean 的 初始 化 行为 :包括 回调 实现 InitializingBean 接口 所 
实现 的 afterPropertiesSet() 方 法 、 回 调 Bean 配置 中 init-method 属性 所 指定 的 方法 。 当 Spring 容器 完成 
了 Bean 初始 化 动作 之 后 ， 接 下 来 将 会 回调 实现 BeanNameAware 接口 里 的 setBeanName(String) 方 法 。 


> 7.8.6 强制 初始 化 Bean 


Spring 默认 有 个 规则 ， 总 是 先 初始 化 主 调 Bean， 然 后 再 初始 化 依赖 Bean。 

大 多 数 情况 下 ，Bean 之 间 的 依赖 非常 直接 ，Spring 容器 在 返回 Bean 实例 之 前 ， 完 成 Bean 依赖 关 
系 的 注入 。 假 如 Bean A 依赖 于 Bean B， 程 序 请 求 Bean A 时 ，Spring 容器 会 自动 先 初始 化 Bean B， 再 
将 Bean B 注入 Bean A， 最 后 将 具备 完整 依赖 的 Bean A 返回 给 程序 。 

在 极端 的 情况 下 ，Bean 之 间 的 依赖 不 够 直接 。 比 如 ， 某 个 类 的 初始 化 块 中 使 用 其 他 Bean，Spring 
总 是 先 初始 化 主 调 Bean， 执 行 初始 化 块 时 还 没有 实例 化 主 调 Bean， 被 依赖 Bean 还 没 实例 化 ， 此 时 将 
引发 异常 。 

为 了 让 指定 Bean 在 目标 Bean 之 前 初始 化 ， 可 以 使 用 depends-on 属性 ， 该 属性 可 以 在 初始 化 主 调 
Bean 之 前 ， 强 制 初始 化 一 个 或 多 个 Bean。 配 置 文件 片段 如 下 : 


<!-- 配置 beanone， 该 Bean 需要 实例 化 之 前 ， 使 用 manager Bean 

使 用 depends-on 强制 在 初始 化 beanOne 之 前 初始 化 manager Bean --> 

<bean id="beanOne" class-"ExampleBean” depends-on="manager"> 
<property name="manager" ref="manager"/> 

</bean> 

<bean id="manager" class="ManagerBean"/> 


7.9 容器 中 Bean 的 生命 周期 


Spring 可 以 管理 singleton 作用 域 Bean 的 生命 周期 ，Spring 可 以 精确 地 知道 该 Bean 何 时 被 创建 、 
何 时 被 初始 化 完成 、 容 器 何 时 准备 销毁 该 Bean 实例 。 

对 于 prototype 作用 域 的 Bean，Spring 容器 仅仅 负责 创建 ， 当 容器 创建 了 Bean 实例 之 后 ，Bean 
实例 完全 交 给 客户 端 代码 管理 ， 容 器 不 再 跟踪 其 生命 周期 。 

每 次 客户 端 请 求 prototype 作用 域 的 Bean 时 ，Spring 都 会 产生 一 个 新 的 实例 ，Spring 容器 无 从 知道 它 
曾经 创建 了 多 少 个 prototype 作用 域 Bean， 也 无 从 知道 这 些 prototype 作用 域 Bean 什么 时 候 才 会 被 销毁 。 

对 于 singleton 作用 域 的 Bean, 每 次 客户 端 代码 请 求 时 都 返回 同一 个 共享 实例 ,客户 端 代码 不 能 控 
制 Bean 的 销毁 ，Spring 容器 可 以 跟踪 Bean 实例 的 产生 、 销 毁 。 容 器 可 以 在 创建 Bean 之 后 ， 进 行 某 
些 通 用 资源 申请 ， 还 可 在 销毁 Bean 实例 之 前 ， 先 回收 某 些 资源 ， 比 如 数据 库 连接 。 

对 于 singleton 作用 域 的 Bean，Spring 容器 知道 Bean 何 时 实例 化 结束 、 何 时 销毁 ，Spring 可 以 管 
理 实例 化 结束 之 后 和 销毁 之 前 的 行为 。 管 理 Bean 的 生命 周期 行为 主要 有 如 下 两 个 时 机 : 

> ”注入 依赖 关系 之 后 。 
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> ”即将 销毁 Bean 之 前 。 
》>》>7.9.1 依赖 关系 注入 之 后 的 行为 


Spring 提供 两 种 方式 在 Bean 全 部 属性 设置 成 功 后 执行 特定 行为 : 
> ”使 用 init-method 属性 。 
> ”实现 InitializingBean 接口 。 
第 一 种 方式 ， 使 用 init-method 属性 指定 某 个 方法 应 在 Bean 全 部 依赖 关系 设置 结束 后 自动 执行 。 
使 用 这 种 方法 不 需 将 代码 与 Spring 的 接口 耦合 在 一 起 ， 代 码 污染 小 。 
第 二 种 方式 也 可 达到 同样 的 效果 ,就 是 让 Bean 类 实现 InitializingBean 接口 ,该 接口 提供 一 个 方法 : 
> voidafterPropertiesSet() throws Exception; 
Spring 容器 会 在 为 该 Bean 注入 依赖 关系 之 后 ， 接 下 来 会 调 该 Bean 所 实现 的 afterPropertiesSet0 方 法 。 
下 面 的 程序 我 们 让 Bean 类 既 实现 InitializingBean 接口 ,也 包含 一 个 普通 初始 化 方法 一 一 通过 在 配 
置 文件 中 将 该 方法 配置 成 初始 化 方法 。 
下 面 是 该 Bean 实现 类 的 代码 。 
程序 清单 ;: codes\07\7.9\ifecycle-init\src\org\crazyit\app\service\impl\Chinese.java 


public class Chinese 
implements Person,InitializingBean 


{ 
private Axe axe; 
public Chinese() 
{ 
System,out .println ("Spring 实例 化 主 调 bean: Chinese 实例 ..."); 


) 

// 依 赖 注 入 必须 的 setter 方法 

public void setAxe(Axe axe) 

{ 
System.out .println ("Spring 执行 依赖 关系 注入 ..."); 
this.axe = axe; 


} 
public void useAxe() 
人 
System.out.println(axe. chop()); 


} 

// 测 试用 初始 化 方法 
Public void init() 
{ 


System.out.Println(" 正 在 执行 初始 化 方法 init..."); 


} 

// 实 现 InitializingBean 接口 必须 实现 的 方法 

public void afterPropertiesSet() throws Exception 
{ 


system.out.printin(" 正 在 执行 初始 化 方法 afterPropertiesSet..."); 
} 
1 


上 面 的 程序 中 粗 体 字 代码 定义 了 一 个 普通 的 init0 方 法 ,实际 上 这 个 方法 的 方法 名 是 任意 的 ， 并 不 
- 定 是 init0 方 法 ，Spring 也 不 会 对 这 个 init0 方 法 进行 任何 特别 的 处 理 。 只 是 接 下 来 会 配置 文件 用 

init-method 属性 指定 该 方法 是 一 个 “生命 周期 方法 ”。 

增加 init-method="init" 来 指定 init0 方 法 应 在 Bean 的 全 部 属性 设置 结束 后 自动 执行 , 如 果 它 不 实现 
InitializingBean 接口 ， 上 面 的 Chinese 类 没有 实现 任何 Spring 的 接口 ,只 是 增加 一 个 普通 的 init0 方 法 ， 
它 依然 是 一 个 普通 的 Java 文件 ， 没 有 代码 污染 。 

上 面 的 程序 中 粗 体 字 代码 的 afterPropertiesSet0 方 法 是 一 个 特殊 的 方法 ，Bean 类 实现 
InitializingBean 接口 必须 实现 了 该 方法 。 
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下 面 的 配置 文件 指定 org.crazyit.app.service.impl.Chinese 的 init0 方 法 是 一 个 生命 周期 方法 。 
程序 清单 : codes\07\7.9\lifecycle-init\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http: //www. springframework.org/schema/beans™ 
xsi:schemaLocation="http://wuw. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 
<!-- 配置 chinese Bean, 使 用 init-method="init" 
指定 该 Bean 所 有 属性 设置 完成 后 ， 自 动 执行 init 方法 -一 > 
<bean id="chinese" class="org.crazyit.app-service.impl.Chinese" 
init-method="init"> 
<property name="axe" ref="steelAxe"/> 
</bean> 
</beans> 


使 用 主 程序 获取 、 并 调用 chinese Bean， 主 程序 的 执行 结果 如 下 : 


Spring 实例 化 依赖 bean: SteelAxe 区 a 
Spring 实例 化 主 调 bean: Chinese 实例 . . 
Spring 执行 依赖 关系 

正在 执行 初始 化 方法 afterpropertiesset.. 
正在 执行 初始 化 方法 ”init. 

钢 状 砍 柴 真 快 


通过 上 面 的 执行 结果 可 以 看 出 ， 当 Spring 将 steelAxe 注入 chinese Bean 之 后 一 一 也 就 是 完成 依赖 
注入 之 后 ， 程 序 先 调用 afterPropertiesSet 方法 进行 初始 化 ， 再 调用 init-method 属性 所 指定 的 方法 进行 
初始 化 。 

对 于 实现 InitializingBean 接口 的 Bean, 无 须 使 用 init-method 属性 来 指定 初始 化 方法 , 配置 该 Bean 
实例 与 配置 普通 Bean 实例 完全 一 样 ,Spring 容器 会 自动 检测 Bean 实例 是 否 实现 了 特定 生命 周期 接口 ， 
并 由 此 决定 是 否 需 要 执行 生命 周期 方法 。 

如 果 某 个 Bean 类 实现 了 InitializingBean 接口 ， 当 该 Bean 的 所 有 依赖 关系 被 设置 完成 后 ，Spring 
容器 会 自动 调用 该 Bean 实例 的 afterPropertiesSet0 方 法 。 其 执行 结果 与 采用 init-method 属性 指定 生命 
周期 方法 儿科 一 样 。 但 实现 InitializingBean 接口 污染 了 代码 ， 是 侵入 式 设计 ， 因 此 不 推荐 采用 。 


如 果 隋 采用 initmethod 属性 指定 初始 化 方法 ， 又 实现 InitializingBean 接口 来 指 定 初 。 | 
始 化 方法 ， 容器 会 执行 两 个 初始 化 方法 先 执行 InitializingBean 接口 中 定义 的 方法 ， 然 3 


> >7.9.2 Bean 销毁 之 前 的 行为 


与 定制 初始 化 行为 相似 , Spring 也 提供 两 种 方法 定制 Bean 实例 销毁 之 前 的 特定 行为 ， 这 两 种 方式 
如 下 : 

> ”使 用 destroy-method 属性 。 

> ”实现 DisposableBean 接口 

第 一 种 方式 ，destroy-method 属性 指定 某 个 方法 在 Bean 销毁 之 前 被 自动 执行 。 使 用 这 种 方法 ， 不 
需要 将 代码 与 Spring 的 接口 耦合 在 一 起 ， 代 码 污染 小 。 

第 二 种 方式 也 可 达到 同样 的 效果 ， 就 是 让 Chinese 类 实现 DisposableBean 接口 ， 该 接口 内 提供 一 
个 方法 : 

> void destroy() throws Exception; 

实现 该 接口 必须 实现 该 方法 ， 该 方法 就 是 Bean 实例 被 销毁 之 前 应 该 执行 的 方法 。 
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下 面 的 示例 程序 让 Bean 类 既 包括 一 个 普通 方法 ， 但 通过 在 配置 时 将 该 方法 指定 为 生命 周期 方 
法 ;也 让 该 Bean 类 实现 DisposableBean 接口 ， 因 此 也 包含 一 个 destroy0 生 命 周 期 方法 。 该 Bean 类 
代码 如 下 。 

程序 清单 : codes\07\7.9\lifecycle-destroy\src\org\crazyit\app\service\impl\Chinese.java 

public class Chinese 
ts Person,DisposableBean 
{ 
private Axe axe; 
public Chinese() 
{ 
System.out .println ("Spring 实例 化 主 调 bean: Chinese 实例 ..."); 
} 
public void setAxe(Axe axe) 
{ 
System.out.println("Spring 执行 依赖 关系 注入 . . .") 7 
this.axe = axe; 
) 
public void useAxe() 
{ 
System.out.println (axe.chop()); 
} 
Public void close() 
{ 


System ,out.Println(" 正 在 执行 销毁 之 前 的 方法 close..."); 
} 
Public void destroy () throws Exception 
{ 


System .out.Println (" 正 在 执行 销毁 之 前 的 方法 destroy...") ; 
} 
} 


上 面 的 程序 中 粗 体 字 代码 定义 了 一 个 普通 的 close0 方 法 ， 实 际 上 这 个 方法 的 方法 名 是 任意 的 ， 并 
不 一 定 是 close() 方 法 ，Spring 也 不 会 对 这 个 close0 方 法 进行 任何 特别 的 处 理 。 只 是 配置 文件 使 用 
destroy-method 属性 指定 该 该 方法 是 一 个 “生命 周期 方法 ”。 

增加 destroy-method="close" 来 指定 close0 方 法 应 在 Bean 实例 销毁 之 前 自动 执行 ， 如 果 它 不 实现 
DisposableBean 接口 ， 上 面 的 Chinese 类 没有 实现 任何 Spring 的 接口 ， 只 是 增加 一 个 普通 的 close0 方 
法 ， 它 依然 是 一 个 普通 的 Java 文件 ， 没 有 代码 污染 。 

上 面 的 程序 中 粗 体 字 代码 的 destroy0 方 法 是 一 个 特殊 的 方法 ，Bean 类 实现 DisposableBean 接口 必 
须 实现 了 该 方法 。 

配置 文件 增加 destroy-method="close"， 指 定 close0 方 法 应 该 在 Bean 实例 被 销毁 之 前 自动 被 调用 。 
配置 文件 代码 如 下 。 

程序 清单 :codes\07\7.9\lifecycle-destroy\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 -> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema~instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 
<!-- 配置 chinese Bean, 使 用 destroy-method="close”" 
指定 该 Bean 实例 被 销毁 ，Spring 自动 执行 close 方法 --> 
<bean id="chinese" class="org.crazyit.app.service.inpl.Chinese" 
destroy-method="close"> 
<property name="axe” ref="steelAxe"/> 
</bean> 
</beans> 


配置 该 Bean 与 配置 普通 Bean 没有 任何 区 别 ，Spring 可 以 自动 检测 容器 中 的 DisposableBean， 在 
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销毁 Bean 实例 之 前 ，Spring 容器 会 自动 调用 该 Bean 实例 的 destroy() 方 法 。 

singleton 作用 域 的 Bean 通常 会 随 容器 的 关闭 而 销毁 ， 但 问题 是 ， ApplicationContext 容器 在 什么 
时 候 关闭 呢 ? 在 基于 Web 的 ApplicationContext 实现 中 ， 系 统 已 经 提供 了 相应 的 代码 保证 关闭 Web 应 
用 时 恰当 地 关闭 Spring 容器 。 

如 果 处 于 一 个 非 Web 应 用 的 环境 下 ， 为 了 让 Spring 容器 优雅 地 关闭 ， 并 调用 singleton Bean 上 的 
相应 析 构 回调 方法 ， 则 需要 在 JVM 里 注册 一 个 关闭 钩子 (shutdown hook)， 这 样 就 可 保证 Spring 容器 
被 恰当 关闭 ， 且 自动 执行 singleton Bean 实例 的 析 构 回调 方法 。 

为 了 注册 关闭 钩子 ， 只 需要 调用 在 AbstractApplicationContext 中 提供 的 registerShutdownHook0 方 
法 即 可 。 看 如 下 主 程序 。 

程序 清单 :codes\07\7.9\lifecycle-destroy\src\lee\BeanTest.java 


public class BeanTest 


{ 
public static void main(String[] args) 


{ 
// 以 CLASSPATH 路 径 下 的 配置 文件 创建 ApplicationContext 
AbstractApplicationContext ctx = new 
ClassPathxmlApplicationContext ("bean. xml"); 


// 获 取 容器 中 的 Bean 实例 


Person p = ctx.getBean("chinese" , Person.class); 
P.useRxe() 17 
// 为 Spring 容器 注册 关闭 钩子 
ctx. registerShutdownHook () ; 
上 
} 


上 面 程序 的 最 后 一 行 粗 体 字 代 码 为 Spring 容器 注册 了 一 个 关闭 钩子 ， 程 序 将 会 在 退出 JVM 之 前 
优雅 地 关闭 Spring 容器 ， 并 保证 关闭 Spring 容器 之 前 调用 singleton Bean 实例 的 析 构 回调 方法 。 
运行 上 面 的 程序 ， 将 可 以 看 到 程序 退出 执行 输出 如 下 两 行 : 
正在 执行 销毁 之 前 的 方法 destroy... 
正在 执行 销毁 之 前 的 方法 ” close.- . 


通过 上 面 的 执行 结果 可 以 看 出 ， 当 Spring 容器 关闭 之 前 ， 注 入 之 后 ， 程 序 先 调用 destroy 方法 进 
行 回收 资源 ， 再 调用 close0 方 法 进行 回收 资源 。 

如 果 某 个 Bean 类 实现 了 DisposableBean 接口 ， 在 Bean 被 销毁 ，Spring 容器 会 自动 调用 该 Bean 
实例 的 destroy0 方 法 。 其 执行 结果 与 采用 destroy-method 属性 指定 生命 周期 方法 几乎 一 样 。 但 实现 
InitializingBean 接口 污染 了 代码 ， 是 侵入 式 设计 ， 因 此 不 推荐 采用 。 

对 于 实现 DisposableBean 接口 的 Bean， 无 须 使 用 destroy-method 属性 来 指定 销毁 之 前 的 方法 ， 配 
置 该 Bean 实例 与 配置 普通 Bean 实例 完全 一 样 ，Spring 容器 会 自动 检测 Bean 实例 是 否 实现 了 特定 生 
命 周期 接口 ， 并 由 此 决定 是 否 需要 执行 生命 周期 方法 。 

二 


如 果 既 采用 destroy-method 属性 指定 销毁 之 前 的 方法 ， 又 采用 实现 DisposableBean 
接口 来 指定 销毁 之 前 的 方法 ， 容 器 会 执行 两 个 方法 ， 先 执行 DisposableBean 接口 中 定义 
的 方法 ， 然 后 执行 destroy-method 属性 指定 的 方法 。 要 


除 此 之 外 ， 如 果 容 器 中 很 多 Bean 都 需要 指定 特定 的 生命 周期 行为 ， 则 可 以 利用 <beans.., 人 > 元 素 的 
default-init-method 属性 和 default-destroy-method 属性 ， 这 两 个 属性 的 作用 类 似 于 <bean... 人 > 元 素 的 
init-method 和 destroy-method 属性 的 作用 ， 关 键 是 default-init-method 属性 和 default-destroy-method 属 
性 是 属于 <beans.. 信 元 素 的 ， 它 们 将 使 容器 中 所 有 Bean 生效 。 

例如 ， 我 们 采用 如 下 配置 片段 : 


http://52pdf.taobao.com 
攻 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


<beans default-init-method="init"> 
</beans> 
上 面 的 配置 片段 中 粗 体 字 代码 指定 了 default-init-method="init"， 这 意味 着 只 要 Spring 容器 中 的 
Bean 实例 具有 init0 方 法 ，Spring 会 在 设置 该 Bean 的 依赖 关系 之 后 ， 自 动 调用 该 Bean 实例 的 init0 
方法 。 
图 7.11 显示 了 Spring 容器 中 Bean 实例 完整 的 生命 周期 行为 。 


Em! A | 
| 


=== 


Beim 


图 7.11 Spring 容器 中 Bean 的 生命 周期 


需要 指出 的 是 ， 当 Bean 实现 了 ApplicationContextAware 接口 、BeanNameAware 接口 之 后 ，Spring 
容器 会 在 该 Bean 初始 化 完成 之 后 一 一 也 就 是 调用 init-method 属性 所 指定 的 方法 (如 果 有 ) 之 后 ， 再 
来 回调 setApplicationContext(ApplicationContext applicationContext)、setBeanName(String name) 方 法 。 


> >7.9.3 协调 作用 域 不 同步 的 Bean 


当 Spring 容器 中 作用 域 不 同 的 Bean 相互 依赖 时 , 可 能 出 现 一 些 问题 : 当 两 个 singleton 作用 域 Bean 
存在 依赖 关系 时 ， 或 当 prototype 作用 域 Bean 依赖 singleton 作用 域 Bean 时 ， 通 过 属性 定义 依赖 关系 
就 足够 了 。 

但 当 singleton 作用 域 Bean 依赖 prototype 作用 域 Bean 时 ，singleton 作用 域 Bean 只 有 一 次 初始 化 
的 机 会 ， 它 的 依赖 关系 也 只 在 初始 化 阶段 被 设置 ， 它 所 依赖 的 prototype 作用 域 Bean 则 需要 每 次 都 得 
到 一 个 全 新 的 Bean 实例 ， 这 将 导致 singleton 作用 域 的 Bean 的 依赖 得 不 到 即时 更 新 。 例 如 我 们 有 如 图 
7.12 所 示 的 依赖 关系 。 

对 于 图 7.12 所 示 的 依赖 关系 ，singleton Bean 依赖 于 prototype Bean， 当 Spring 容器 初始 化 时 ， 它 会 初 
始 化 容器 中 所 有 singleton Bean， 此 时 prototype Bean 被 创建 出 来 ， 并 注入 到 singleton Bean 中 一 一 此 处 当 
singleton Bean 创建 完成 后 ， 它 就 持 有 了 一 个 prototype Bean， 容 器 再 不 会 为 singleton Bean 执行 注入 了 。 

由 于 singleton Bean 具有 单 例 行 为 ， 当 客户 端 多 次 请 求 singleton Bean 时 ，Spring 返回 给 客户 端的 将 
是 同一 个 singleton Bean 实例 ， 这 不 存在 任何 问题 。 问 题 是， 如 果 客 户 端 多 次 请 求 singleton Bean、 并 调 
用 该 singleton Bean 去 调用 prototype Bean 的 方法 时 一 一 始终 都 是 调用 同一 个 prototype Bean 实例 , 这 就 违 
背 了 设置 prototype Bean 的 初 囊 ， 本 来 希望 它 具 有 prototype 行为 ， 但 实际 上 它 却 表现 出 singleton 行为 了 。 

问题 产生 了 : 当 singleton 作用 域 Bean 依赖 于 prototype 作用 域 Bean 时 ， 会 产生 不 同步 的 现象 。 
解决 该 问题 有 如 下 两 种 思路 。 
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图 7.12 Singleton Bean 依赖 于 Prototype Bean 


> ”部 分 放弃 依赖 注入 singleton 作用 域 Bean 每 次 需要 prototype 作用 域 Bean 时 ， 主 动向 容 
器 请 求 新 的 Bean 实例 ， 即 可 保证 每 次 注入 的 prototype Bean 实例 都 是 最 新 的 实例 。 

> ”利用 方法 注入 。 

第 一 种 方式 显然 不 是 一 个 好 的 做 法 ， 代 码 主动 请 求 新 的 Bean 实例 ， 必 然 导致 代码 与 Spring API 
耦合 ， 造 成 严重 代码 污染 。 

通常 情况 下 ， 我 们 采用 第 二 种 做 法 ， 使 用 方法 注入 。 

方法 注入 通常 使 用 lookup 方法 注入 , 利用 lookup 方法 注入 可 以 让 Spring 容器 重 写 容器 中 Bean 的 
抽象 或 具体 方法 ， 返 回 查找 容器 中 其 他 Bean 的 结果 ， 被 查找 的 Bean 通常 是 一 个 non-singleton Bean， 
(尽管 也 可 以 是 一 个 singleton 的 )。Spring 通过 使 用 CGLIB 库 修改 客户 端的 二 进 制 码 ， 从 而 实现 上 述 
的 要 求 。 

为 了 较 好 地 向 用 户 示范 这 种 用 法 ， 下 面 先 定义 一 个 SteelAxe 类 ， 该 类 定义 一 个 count 状态 ， 每 当 
SteelAxe 对 象 调用 chop() 方 法 一 次 ， 该 count 值 就 加 一 。 

程序 清单 :codes\07\7.9\lookup\src\org\crazyit\app\service\impl\SteelAxe.java 


public class SteelAxe 
implements Axe 


{ 
public SteelAxe() 


System.out.println ("Spring 实例 化 依赖 Bean: SteelAxe 实例 .。.");- 


} 
// 测 试用 方法 
public string chop() 


Sm " 铜 养 砍 柴 真 快 1"; 
。 
上 面 的 SteelAxe 将 被 部 署 成 prototype 作用 域 Bean, 并 被 一 个 singleton 作用 域 Bean 所 依赖 。 如 果 
让 Spring 容器 直接 将 prototype 作用 域 的 Bean 注入 singleton 作用 域 Bean， 就 会 出 现 前 面 描述 的 问题 。 
为 了 解决 这 个 问题 , 我 们 在 singleton Bean 里 新 增 一 个 抽象 方法 , 该 方法 的 返回 值 类 型 是 被 依赖 的 Bean 
一 一 注意 该 方法 是 一 个 抽象 方法 ， 程 序 员 没 有 为 该 方法 提供 实现 ， 该 方法 的 实现 由 Spring 完成 。 下 面 
是 该 Bean 类 的 代码 。 


程序 清单 : codes\07\7.9\lookup\src\org\crazyit\app\service\impl\Chinese.java 
public abstract class Chinese 
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implements Person 


public Chinese() 
{ 
System.out .println ("Spring 实例 化 主 调 bean: Chinese 实例 ..."); 


} 
// 定 义 一 个 抽象 方法 ， 该 方法 将 由 Spring 负责 实现 
Public abstract Axe getAxe(); 
Public void useAxe() 
{ 
System.out .println(" 正 在 使 用 ”+ getAxe() 
+ " 砍 柴 ! "); 
System.out.println (getAxe() .chop()); 
} 
} 


上 面 的 程序 中 粗 体 字 代码 定义 了 一 个 抽象 的 getAxe( 方 法 ， 通 常情 况 下 ， 程 序 不 能 调用 这 个 抽象 
方法 。 但 Spring 框架 将 会 负责 为 该 方法 提供 实现 体 ， 这 样 这 个 方法 就 会 变 成 具体 方法 了 ， 程 序 也 就 可 
以 调用 该 方法 了 。 问 题 是 ，Spring 怎么 知道 如 何 实现 该 方法 呢 ? 为 了 让 Spring 知道 如 何 实现 该 方法 ， 
我 们 需要 在 配置 文件 中 使 用 <lookup-method... 人 > 元 素来 配置 这 个 方法 。 

使 用 <lookup-method.… 人 元素 需 要 指定 如 下 两 个 属性 。 

> ”name: 指定 需要 让 Spring 实现 的 方法 。 

> ”bean: 指定 Spring 实现 该 方法 后 的 返回 值 。 

下 面 是 该 应 用 的 配置 文件 。 

程序 清单 : codes\07\7.9\lookup\src\bean.xml 

<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http: //www. springframework. org/schema/beans" 
xsi:schemaLocation="http://www, springframework.org/schema/beans 
http://wuw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 一 个 steelAxe 实例 ， 指 定 prototype 的 作用 域 ~-> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe" 
scope="prototype"/> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese"> 
<!-- 指定 getAxe 方法 返回 steelAxe 


每 次 调用 getAxe 方法 将 获取 新 的 steelAxe 对 象 --> 


name="getAxe" bean="steelAxe"/> 


</bean> 
</beans> 


上 面 程序 的 粗 体 字 代 码 指 定 Spring 将 负责 实现 getAxe0 方 法 ,该 方法 的 返回 值 是 容器 中 的 steelAxe 
Bean 实例 。 


R: | 
起. 通常 情况 下 ，Java 类 里 所 有 方法 都 应 该 由 程序 员 来 负责 实现 ， 系 统 无 法 为 我 们 实现 任 ， 
何方 法 一 一 否则 ， 还 要 程序 员 干 什么 ?但 在 有 些 情况 下 ， 系 统 可 以 为 我 们 实现 一 些 极其 简 | 

| 。 单 的 方法 ， 例 如 ， 此 处 Spring 将 负责 为 我 们 实现 getAxe() 方 法 ，Spring 实现 该 方法 的 逻辑 ， 
: 是 国定 的 ， 它 总 采用 如 下 代码 来 实现 该 方法 : | 


| public Axe getAxe() | 
{ 

| // 获 取 Spring 容器 ctx 
: /7 7 下面 代码 中 的 steelaxe 由 lookup-method 元 素 的 bean 属性 指定 | 
| return ctx.getBean("steelAxe"); 


| 从 上 面 的 方法 实现 来 看 ， 程 序 每 次 调用 Chinese 对 象 的 getAxe() 方 法 时 ， 该 方法 将 可 
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主 程序 两 次 获取 chinese Bean， 并 通过 该 Bean 来 useAxe0 方 法 ， 将 可 以 看 到 每 次 请 求 时 所 使 用 都 


是 全 新 的 Axe 实例 。 
程序 清单 : codes\07\7.9\lookup\src\lee\BeanTest.java 


public class BeanTest 


{ 
public static void main(String[] args) 


ApplicationContext ctx = new 
ClassPathxmlApplicationContext ("bean. xml"); 

Person p = ctx.getBean("chinese"” , Person.class); 
// 两 次 通过 p 对 象 使 用 Axe 对 象 

Pp.useAxe(); 

Pp.useAxe(); 

} 
} 


正如 前 面 所 介绍 的 ， 因 为 getAxe0 方 法 由 Spring 提供 实现 ，Spring 保证 每 次 调用 getAxe() 时 都 会 

返回 最 新 的 SteelAxe 实例 。 执 行 上 面 的 程序 ， 将 看 到 如 下 运行 结果 : 

Spring 实例 化 主 调 bean， Chinese 实例 . .. 

Spring 实例 化 依赖 Bean: SteelRxe 实例 ... 

正在 使 用 org.crazyit.app.service.impl.SteelAxe@1c247a0 砍 柴 ! 

Spring 实例 化 依赖 Bean， SteelAxe 实例 ... 

钢 莽 砍 柴 真 快 ! 

Spring 实例 化 依赖 Bean: SteelAxe 实例 . . - 

正在 使 用 org.crazyit.app.service.impl.SteelAxe8@lec6696 砍 柴 ! 

Spring 实例 化 依赖 Bean: SteelAxe 实例 . .. 

钢 莽 砍 柴 真 快 ! 


执行 结果 表明 : 使 用 lookup 方法 注入 后 ， 系 统 每 次 调用 getAxe0 方 法 都 将 生成 一 个 新 的 SteelAxe 
实例 , 这 就 可 以 保证 当 singleton 作用 域 的 Bean 需要 全 新 的 Bean 实例 时 , 直接 调用 getAxe0 方 法 即 可 ， 
从 而 可 避免 - 直 使 用 最 早 注入 的 Bean 实例 。 


| 要 保证 lookup 方法 注入 每 次 产生 新 的 Bean 实例 ， 光 须 将 目标 Bean (上 例 就 是 | 
| steelAxe ) 部 署 成 prototype 作用 域 。 否则， 如 果 容 器 中 只 有 一 个 目标 Bean 实例 ， 即 使 采 | 
| 用 lookup 方法 注入 ， 每 次 依然 返回 同一 个 Bean 实例 。lookup 方法 注入 不 仅 能 用 于 设 值 可 


注入 ， 也 可 用 于 构造 注入 。 


7.10 深入 理解 依赖 关系 配置 


对 于 Spring 来 说 ， 我 们 可 以 将 Bean 实例 的 所 有 属性 ， 甚 至 普通 JavaBean 属性 都 通过 配置 文件 来 
指定 ， 这 种 方式 提供 了 很 好 的 解 耦 。 但 是 否 真 的 值得 呢 ? 如 果 将 普通 的 JavaBean 属性 都 通过 配置 文件 
指定 ， 虽 然 提 供 了 很 好 的 解 厅 ， 但 大 大 降低 了 程序 的 可 读 性 必须 同时 参照 配置 文件 才 可 知道 程序 中 
各 属性 的 属性 值 )。 因 此 ， 滥 用 依赖 注入 也 会 引起 一 些 问题 。 

通常 的 建议 是 ， 组 件 与 组 件 之 间 的 耦合 ， 采 用 依赖 注入 管理 ; 但 普通 的 JavaBean 属性 值 ， 应 直接 
在 代码 中 设置 。 对 于 组 件 之 间 的 耦合 关系 ， 通 过 使 用 控制 反 转 ， 代 码 变 得 非常 清晰 。 因 此 ，Bean 无 须 
管理 依赖 关系 ， 而 是 由 容器 提供 注入 ，Bean 无 须知 道 这 些 实例 在 哪里 ， 以 及 它们 具体 的 实现 。 

前 面 介绍 的 依赖 关系 ， 要么 是 JavaBean 式 的 值 ， 要 么 直接 依赖 于 其 他 Bean。 在 实际 的 应 用 中 ， 
某 个 实例 的 属性 可 能 是 某 个 方法 的 返回 值 , 或 者 类 的 Field 值 , 或 者 属性 值 ，Spring 同样 可 以 支持 这 种 
非常 规 的 注入 方式 。Spring 甚至 支持 将 Bean 实例 的 属性 值 、 方 法 返回 值 、Field 值 ， 直 接 定义 成 容器 
中 的 一 个 变量 。 下 面 将 深入 介绍 这 些 特殊 的 注入 形式 。 
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SS 在 Spring 配置 文件 中 使 用 XML ML 元 素 进行 配置 实际 上 是 让 Spring 执行 相应 的 代码 。 浊 
例如 : 


| 今 使 用 <bean... 人 > 元 素 ， 实 际 上 是 让 Spring 执行 无 参数 构造 器 、 或 有 参数 的 构造 器 。 

今 使 用 <property..… 记 元素， 实际 上 是 让 Spring 执行 一 次 setter 方法 。 | 
| 但 Java 程序 还 可 能 有 其 他 类 型 的 语句 : 调用 Better 方法 、 调 用 普通 方法 、 访 问 类 或 对 ， 
;和 象 的 Field， 而 Spring 也 为 这 种 语句 提供 了 对 应 的 配置 语法 
| 今 调用 getter 方法 : 使 用 PropertyPathFactoryBean. 
| 今 访问 类 或 对 象 的 Field 值 : 使 用 FieldRetrievingFactoryBean. 
， 今 调用 普通 方法 ; 使 用 MethodInvokingFactoryBean。 
| 由 此 可 见 ， 我 们 可 以 换 一 个 角度 来 看 Spring 框架 : Spring 框架 的 功能 是 什么 ? 它 可 以 ， 
; ”让 开发 者 无 须 书写 Java 代码 就 可 进行 Java 编程 ， 当 开发 者 XML 采用 合适 语法 进行 配置 之 | 
| 。 后 ，Spring 就 可 通过 放射 在 底层 执行 任意 的 Java 代码 。 


》>》>7.10.1 注入 其 他 Bean 的 属性 值 


PropertyPathFactoryBean 用 来 获得 目标 Bean 的 属性 值 (实际 上 就 是 它 的 getter 方法 的 返回 值 ), 获 
得 的 值 可 注入 给 其 他 Bean， 也 可 直接 定义 成 新 的 Bean。 

看 如 下 配置 文件 。 

程序 清单 :codes\07\7.10\property_inject\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instancen 
xmlns="http://www.springframework.org/schema/beans， 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-~ 以 下 定义 了 将 要 被 引用 的 目标 bean--> 
<bean id="person" class="org.crazyit.app.service.Person"> 
<!-- 为 age 属性 指定 值 一 > 
<property namesnagen value="30"/> 
<property name="son"> 
<!--~ 使 用 嵌 套 Bean 定义 属性 值 --> 
<bean class="org.crazyit.app. .Son"> 
<property name="age" value="l1" /> 
</bean> 
</property> 
</bean> 
<!-- 如 下 定义 son2 的 Bean， 该 Bean 的 age 属性 不 是 直接 注入 
， 而 是 依赖 于 其 他 Bean 的 属性 值 --> 
<bean id="son2" class="org.crazyit-app-service-Son"> 
<property name="age"> 
<!-- 以 下 是 访问 Bean 属性 的 简单 方式 ,这 样 可 以 将 person Bean 的 son 属性 的 、 
age 属性 赋值 给 son2 这 个 bean 的 age 属性 --> 
<bean id="person.son.age" class= 
"org. springframework .beans. factory. config. PropertyPathFactoryBean"/> 
</property> 
</bean> 
</beans> 


主 程序 如 下 。 
程序 清单 ，codes\07\7.10\property_inject\src\lee\SpringTestjava 


Public class SpringTest 
{ 
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和 7 


public static void main(String[] args) 
{ 
system.out .println ("系统 获取 son2: " 
+ ctx.getBean("son2")); 
! 
} 


执行 结果 如 下 : 

系统 获取 son2: Son[age=11] 

从 上 面 的 粗 体 字 代码 可 以 看 出 ，son2 Bean 实例 的 age 属性 值 并 不 是 直接 指定 的 , 而 是 将 容器 中 另 

一 个 Bean 实例 的 属性 值 赋 给 了 son2 的 age 属性 ， PropertyPathFactoryBean 工厂 Bean 负责 获取 容器 
中 另 一 个 Bean 的 属性 值 。 

SS “PropertyPathFactoryBean 就 是 工厂 Bean， 大 看 7.8.4 节 的 内 容 ， 工 厂 Bean 专门 返回 某 : 

个 类 型 的 值 , 并 不 是 返回 该 Bean 的 实例 . 在 这 种 配置 方式 下 , 配置 PropertyPathFactoryBean 
而 是 指定 属性 表达 式 值 。 


工厂 Bean 时 指定 的 id 属性 ， 并 不 是 该 Bean 的 唯一 标 


Bean 实例 的 属性 值 ， 不 仅 可 以 注入 另 一 个 Bean， 还 可 将 Bean 实例 的 属性 值 直 接 定义 成 Bean 实 
例 ， 也 是 通过 PropertyPathFactoryBean 完成 的 。 对 上 面 的 配置 文件 增加 如 下 一 段 。 


程序 清单 : codes\07\7.10\property_inject\src\bean.xml 
<!-- 将 指定 Bean 实例 的 属性 值 定义 成 指定 Bean 实例 -> 
<bean id="sonlw 
class="org.springframework.beans,. factory.config.PropertyPathFactoryBean"> 
<!-- 确定 目标 Bean， 表 明 son1 Bean 来 自 哪 个 Bean 的 属性 --> 
<property name="targetBeanName" value="person"/> 
<!-- 确定 属性 表达 式 ， 表 明 son1 Bean 来 自 目标 bean 的 哪个 属性 -~> 
<property name="propertyPath" value="son"/> 
</bean> 
主 程序 部 分 增加 如 下 的 输出 : 
System.out .println(" 系 统 获取 的 sonl: " + ctx.getBean("son1")); 
主 程序 部 分 直接 输出 bean1， 此 输出 语句 的 执行 结果 如 下 : 
系统 获取 的 son1: Son[age=11] 
将 Bean 实例 的 属性 值 直接 配置 成 容器 中 Bean 实例 时 ， 配 置 PropertyPathFactoryBean 时 指定 的 id 
属性 值 就 是 该 Bean 实例 的 标识 ,在 这 种 情况 下 ,配置 PropertyPathFactoryBean 必须 指定 如 下 两 个 属性 值 。 
> targetBeanName: 用 于 指定 目标 Bean， 确 定 获取 哪个 Bean 的 属性 值 。 
> propertyPath: 用 于 指定 属性 ， 确 定 获取 目标 Bean 的 哪个 属性 值 ， 此 处 的 属性 可 直接 使 用 
复合 属性 的 形式 。 例 如 : 想 获 取 person Bean 的 son 属性 的 age 属性 ， 可 采用 son.age。 
甚至 可 以 将 基本 数据 类 型 的 属性 值 定义 成 Bean 实例 。 在 配置 文件 中 再 增加 如 下 一 段 。 
程序 清单 : codes\07\7.10\property_inject\src\bean.xml 
<!-- 将 基本 数据 类 型 的 属性 值 定义 成 Bean 实例 --> 
<bean id="theAge" class= 
"org. springframework.beans. factory. config.PropertyPathFactoryBean"> 
<!-- 确定 目标 Bean， 表 明 theAge Bean 来 自 哪个 Bean 的 属性 -> 
<property name="targetBeanName" value="person"/> 
<!-- 确定 属性 名 ， 表 明 theAge Bean 来 自 目 标 Bean 的 哪个 属性 ， 
此 处 的 属性 采用 复合 属性 的 形式 一 > 
name="propertyPath" value="son.age"/> 
</bean> 
主 程序 部 分 增加 如 下 输出 : 
System.out .println ("系统 获取 theAge 的 值 : " + ctx.getBean("theAge")); 
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程序 执行 结果 如 下 : 
系统 获取 theAge 的 值 : 11 
目标 Bean 既 可 以 是 容器 中 已 有 的 Bean 实例 ， 也 可 以 是 嵌 套 Bean 实例 。 因 此 ， 下 面 的 定义 也 是 
有 效 的 。 
程序 清单 :codes\07\7.10\property_inject\src\bean.xml 
<!-- 将 基本 数据 类 型 的 属性 值 定义 成 Bean 实例 --> 
<bean id="theAge2" class= 
"org.springframework.beans. factory. config.PropertyPathFactoryBean"> 
<!-- 确定 目标 Bean， 表 明 theAge2 Bean 来 自 哪个 Bean 的 属性 。 
此 处 采用 嵌 套 Bean 定义 目标 Bean 一 > 
<property name="targetObject"> 
<!-- 目标 Bean 不 是 容器 中 已 经 存在 的 Bean， 而 是 如 下 的 以 套 Bean--> 
<bean class="org.craryit.app. service.Person"> 
<property name="age" value="30"/> 
</bean> 
</property> 
<!-- 确定 属性 表达 式 ， 表 明 theAge2 Bean 来 自 目标 bean 的 哪个 属性 --> 
<property name="propertyPath" value="age"/> 
</bean> 


》>》》7.10.2 注入 其 他 Bean 的 Field 值 


通过 FieldRetrievingFactoryBean 类 ， 可 以 将 其 他 Bean 的 Field 值 ，FieldRetrievingFactoryBean 获 
得 目标 Bean 的 Field 值 之 后 ， 得 到 的 值 可 注入 给 其 他 Bean， 也 可 直接 定义 成 新 的 Bean。 

下 面 的 配置 文件 将 指定 类 的 静态 Field 设置 成 Bean 属性 值 。 

程序 清单 :codes\07\7.10Vfield_inject\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 将 java.sql.Connection 的 TRANSACTION_SERIALIZABLE 
的 值 赋 给 son 的 age 属性 一 > 
<bean id="son" class="org.crazyit.app.service.Son"> 
<property name="age"> 
<bean id="java.sql.Connection.TRANSACTION. SERIALIZABLE" 
class="org. springframework.beans. factory.config. FieldRetrieving- 
FactoryBean"/> 
</property> 
</bean> 
</beans> 


主 程序 获取 son Bean 的 age 属性 值 。 主 程序 如 下 。 
程序 清单 :codes\07\7.10\property_inject\src\bean.xml 


public class SpringTest 


public static void main(String[] args) 
{ 
ApplicationContext ctx ~ new 
ClassPathXxmlApplicationContext ("bean. xml"); 
// 获 取 son Bean 实例 
Son son = ctx.getBean("son" , Son.class); 
// 输 出 son 的 age 值 
System.out.printin ("系统 获取 son 的 age 属性 值 :" 
+ son.getAge()); 
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区 


程序 的 执行 结果 如 下 : 
统 获取 son 的 age 属性 值 : 8 
son Bean 的 age 值 , 等 于 java.sql.Connection 接口 中 的 TRANSACTION_SERIALIZABLE 值 。 在 上 
面 定义 中 ， 定 义 FieldRetrievingFactoryBean 工厂 Bean 时 ， 指 定 的 id 属性 ， 并 不 是 该 Bean 实例 的 唯一 


标识 ， 而 是 指定 Field 表达 式 。 


党 
-大 .注意 : 

Field 既 可 以 是 静态 的 ， 也 可 以 是 非 静 态 的 。 上 面 的 配置 片段 指定 的 Field 表达 式 是 
静态 Field 值 ， 因 此 直接 通过 类 名 访问 特定 Field; 如 果 需 要 访问 Field 是 非 静 态 的 Field 


值 ， 则 不 能 通过 类 名 直接 访问 Field， 而 应 该 通过 容器 中 已 经 存在 的 Bean 来 访问 Field 可 


值 一 一 即 Field 表达 式 的 第 一 个 短语 应 该 是 容器 中 已 经 存在 的 Bean. 


Field 值 也 可 定义 成 Bean 实例 ， 在 配置 文件 中 增加 如 下 一 段 。 
程序 清单 ;codes\07\7.10Mfield_inject\src\bean.xml 
<!-- 将 Field 值 定义 成 Bean 实例 --> 


<bean id="theAgel" class= 
"org. springframework.beans. factory.config. FieldRetrievingFactoryBean"> 


<!-- targetClass 指定 Field 所 在 的 目标 类 --> 
name="targetClass" value="java.sql.Connection"/> 


<property 
<!-- targetField 指 定 Field 名 --> 
name="targetField" value="TRANSACTION_SERIALIZABLE"/> 
</bean> 
主 程序 部 分 增加 如 下 输出 : 
System.out .println ("系统 获取 theAgel 的 值 ，" 
+ ctx.getBean("theAgel")); 
运行 上 面 的 代码 ， 输 出 结果 如 下 : 
系统 获取 theAgel 的 值 ， 8 
使 用 FieldRetrievingFactoryBean 获取 Field 值 时 ， 必 须 指定 如 下 两 个 属性 值 。 
> ”targetClass 或 targetObject: 分 别 用 于 指定 Field 值 所 在 的 目标 类 或 目标 对 象 ， 如 果 需 要 获得 
Field 是 静态 Field， 则 使 用 targetClass 指定 目标 类 ; 否则 使 用 targetObject 指定 目标 对 象 。 
> targetField: 用 于 指定 目标 Field 的 Field 名 。 
如 果 Field 是 个 静态 Field， 则 有 一 种 更 加 简洁 的 写法 ， 看 下 面 的 配置 片段 。 
程序 清单 :codes\07\7.10Vfield_inject\src\bean.xml 
<!-- 将 Field 值 定义 成 Bean 实例 --> 


<bean id-"theAge2" class= 
pringframework.beans. factory.config. FieldRetrievingFactoryBean"> 


ue 指定 采用 哪个 类 的 哪个 静态 域 值 --> 
name="staticField" 
value="java. sql.Connection. TRANSACTION_SERIALIZABLE"/> 


</bean> 
这 种 简洁 的 配置 方式 ， 与 前 面 分 别 配置 targetClass 属性 和 targetField 属性 的 效果 完全 相同 。 但 如 
果 Field 不 是 静态 的 ， 则 只 能 通过 分 别 指定 targetObject 和 targetField 属性 来 配置 。 


》>》7.10.3 注入 其 他 Bean 的 方法 返回 值 


通过 MethodInvokingFactoryBean 工厂 Bean， 可 将 指定 方法 返回 值 注入 成 目标 Bean 的 属性 值 ， 
MethodInvokingFactoryBean 用 来 获得 指定 方法 的 返回 值 ， 该 方法 既 可 以 是 静态 方法 ， 也 可 以 是 实例 方 
法 ; 获得 的 方法 返回 值 既 可 被 注入 到 指定 Bean 实例 的 指定 属性 ， 也 可 以 直接 定义 成 Bean 实例 。 
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看 如 下 配置 文件 。 
程序 清单 : codes\07\7.10\method_inject\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 - 
<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance: 
xmlns="http://waw. springframework.org/schema/beans™ 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://wuw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 目标 Bean， 后 面 将 会 获取 该 Bean 的 方法 返回 值 --> 
<bean id="valueGnerator" class="org.crazyit.app.util.ValueGenerator"/> 
<!-- 定义 名 为 son1 的 Bean --> 
<bean id="sonl" class="org.crazyit.app.service.Son"> 
<property name="age"> 
<!-- 获取 方法 返回 值 一 > 
<bean class= 
"org. springframework.beans. factory.config.MethodInvokingFactoryBean"> 
- targetObject 确定 目标 Bean， 指 定 调用 哪个 Bean --> 
<property name="targetObject" ref="valueGnerator"/> 
<!-- targetMethod 确定 目标 方法 ， 指 定 调用 目标 Bean 的 哪个 方法 --> 
<property name="targetMethod" value="getValue"/> 


</property> 
</bean> 
</beans> 


下 面 给 出 ValueGenerator 的 代码 部 分 ，ValueGenerator 类 包含 两 个 方法 : 一 个 静态 方法 ， 一 个 实例 
方法 ， 两 个 方法 都 返回 整 型 值 。 
程序 清单 : codes\07\7.10\method_inject\src\org\crazyit\app\util\ValueGeneratorjava 
public class ValueGenerator 


public int getValue() 
{ 
return 27 
} 
public static int getStaticValue() 
{ 
return 9; 
} 
} 


主 程序 如 下 。 
程序 清单 : codes\07\7.10\method_inject\src\lee\SpringTestjava 
public class SpringTest 
Public static void main(String[] args) 
{ 
ApplicationContext ctx = 
new ClassPathxmlApplicationContext ("bean. xml"); 
// 获 取 son1 Bean 实例 
Son sonl = ctx.getBean("sonl" , Son.class); 
// 输 出 sonl 的 age 值 
SYstem.out.println (" 系 统 获取 sonl 的 age 属性 值 ，” 
+ sonl.getAge()); 
} 
} 


执行 结果 如 下 : 
系统 获取 sonl 的 age 属性 值 : 2 
Bean sonl 的 age 属性 值 ， 来 自 于 ValueGenerator 类 的 实例 方法 返回 值 。 
当 需 要 获取 Bean 的 实例 方法 返回 值 时 ， 必 须 指定 如 下 两 个 属性 。 
> targetObject:， 确定 目标 Bean， 该 Bean 可 以 是 容器 中 已 有 的 Bean， 也 可 以 是 嵌 套 Bean。 
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对 2 


> ”targetMethod: 确定 目标 方法 ， 确 定 获取 目标 Bean 哪个 方法 的 返回 值 。 

如 果 需 要 获取 静态 方法 的 返回 值 ， 则 无 须 指定 targetObject, 但 需要 指定 目标 class, 指定 目标 class 
的 属性 通过 targetClass 属性 。 使 用 静态 方法 注入 ， 需 指定 如 下 两 个 属性 。 

> targetClass: 确定 目标 class。 

> ”targetMethod: 确定 目标 方法 ， 确 定 获取 目标 class 哪个 方法 的 返回 值 。 

在 配置 文件 中 增加 如 下 一 段 。 

程序 清单 : codes\07\7.10\method_inject\src\bean.xml 


<!-- 定义 名 为 son2 的 Bean --> 
<bean id="son2" class="org.crazyit.app.service.Son"> 
<property name="age"> 
<bean class= 
"org. springframework.beans. factory. config.MethodInvokingFactoryBean"> 
<!-~ targetClass 确定 目标 类 ， 指 定 调用 哪个 类 -~> 
name=" value="org. ‘app.util. ValueGenerator"/> 


<property ‘targetClass" Craryit. 
<!-- targetMethod 确定 目标 方法 , 指定 调用 有 目标 class 的 可 人 法 : 
该 方法 必须 是 静态 方法 --> 
name="targetMethod" value="getstaticValue"/> 
</bean> 
</property> 
</bean> 


主 程序 中 增加 如 下 代码 : 


// 获 取 son2 Bean 实例 

Son son2 = (Son)ctx.getBean("son2"); 

// 输 出 son2 的 age 值 

System,out,println(" 系 统 获取 son5 的 age 属性 值 :" 
+ son2.getRhge())7 


程序 执行 结果 如 下 : 

系统 获取 son2 的 age 属性 值 ，9 

想必 读者 都 已 经 想到 了 : Java 是 面向 对 象 的 语言 ， 对 象 的 方法 是 支持 重 载 的 ， 即 仅 指定 方法 名 是 
无 法 唯一 确定 一 个 方法 的 ， 必 须 同 时 指定 方法 名 和 参数 列表 才 可 唯一 确定 一 个 方法 。 但 上 面 代码 片段 
仅仅 指定 了 目标 方法 为 getStaticValue， 并 没有 指定 参数 列表 ， 那 到 底 怎么 确定 方法 昵 ? 实际 上 ， 没 有 
指定 参数 列表 ， 默 认 采 用 空 参数 列表 ， 即 要 求 org.crazyit.app.util.ValueGenerator 类 中 有 一 个 
BetStaticValue(0) 方 法 ， 该 方法 不 能 有 任何 参数 。 

如 果 要 为 目标 方法 确定 参数 ， 使 用 arguments 属性 值 ， 下 面 将 给 出 详细 示范 。 

使 用 MethodInvokingFactoryBean 也 可 将 方法 返回 值 直接 定义 成 Bean 实例 ， 在 配置 文件 中 增加 如 
下 一 段 。 

程序 清单 : codes\07\7.10\method_inject\src\bean.xml 


<!-- ”将 静态 方法 返回 值 直 接 定义 成 Bean --> 
<bean id="sysProps" class= 
"org. springframework.beans. factory.config.MethodInvokingFactoryBean"> 
<!-- targetclass 确定 目标 类 ， 确 定 调 用 哪个 类 --> 
<property name="targetClass" value="java.lang.System"/> 
<!-- targetMethod 确定 目标 方法 ， 确 定 调用 目标 class 的 哪个 方法 
该 方法 必须 是 静态 方法 ~-> 


该 配置 文件 将 java.lang.System 类 的 getProperties 方法 的 返回 值 定 义 成 Bean 实例 ,也 就 是 说 ,Spring 
容器 中 的 sysProps Bean 就 是 System.getProperties0) 的 返回 值 。 
接 下 来 ， 在 配置 文件 中 增加 如 下 一 段 。 
程序 清单 : codes\07\7.10method_inject\src\bean.xml 
<!-- 将 实例 方法 返回 值 直接 定义 成 Bean --> 
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<bean id="javaVersion" class= 
"org.springframework.beans. factory. config. MethodInvokingFactoryBean"> 
<!-- targetObject 确定 目标 Bean， 确 定 调用 哪个 Bean -> 
<property name="targetObject" ref="sysProps"/> 
<!-- targetMethod 确定 目标 方法 ， 确 定 调用 目标 Bean 的 哪个 方法 --> 
<property name="targetMethod" value="getProperty"/> 
<!-- 确定 调用 目标 方法 的 参数 --> 
<property name="arguments"> 
<!-- 1ist 元 素 列 出 调用 方法 多 个 参数 值 --> 
<list> 
<value>java.version</value> 
</list> 
</property> 
</bean> 
该 配置 文件 将 实例 方法 返回 值 直接 定义 成 Bean， 调 用 的 目标 Bean 是 上 面 配置 的 sysProps Bean， 
实例 方法 是 Property 类 的 getProperty0 方 法 ， 且 传 入 一 个 参数 值 ，java.version。 上 面 配 置 片段 相当 于 
如 下 代码 : 
// 调 用 sysProps 的 getProperty 1() 方法， 将 方法 返回 值 定义 成 javaVersion 
javaVersion = sysProps.getProperty{"java.version") 


主 程序 增加 如 下 输出 : 


System.out .println ("系统 获取 Java 版 本 : " 
+ ctx.getBean("javaVersion")); 


输出 结果 如 下 
系统 获取 Java 版 本 : 1.6.0_22 
从 上 面 的 代码 可 以 看 出 ，Spring 提供 的 MethodInvokingFactoryBean 确实 功能 非常 强大 ， 通 过 使 用 
这 个 工厂 Bean， 我 们 可 以 通过 Spring 配置 文件 来 调用 指定 方法 ， 并 获取 方法 返回 值 。 
通过 这 种 配置 方式 , 也 可 定义 静态 工厂 方法 创建 Bean 实例 , 或 定义 实例 工厂 方法 创建 Bean 实例 。 
配置 示例 如 下 ; 


<!-- 定义 通过 静态 工厂 方法 创建 的 Bean 实例 --> 
<bean id="myBean" class= 
"org.springframework.beans. factory. config.MethodInvokingFactoryBean"> 
<!~~ targetClass 确定 目标 类 ， 确 定 调用 哪个 工厂 类 --> 
<property name="targetClass" value="lee.MyClassFactory"/; 
<!-- targetMethod 指定 静态 工厂 方法 -~-> 
<property name="targetMethod" value="getInstance"/> 
</bean> 


对 于 这 种 情况 ， 通 常 不 推荐 采用 此 配置 方法 ， 建 议 采用 factory-method 的 方法 来 配置 Bean， 请 参 
阅 7.7 节 的 内 容 。 
如 果 该 方法 是 静态 方法 ， 则 可 以 直接 指定 staticMethod 属性 值 来 简化 配置 。 看 如 下 配置 片段 : 
<!-- 定义 通过 静态 工厂 方法 创建 的 Bean 实例 --> 
<bean id="myBean" class= 
"org, springframework.beans. factory.config.I Wothbdrn oldie ona 
<!-- staticMethod 属性 同时 指定 目标 类 、 目 标 方 法 --> 
<property name="staticMethod" value="lee.MyClassFactory. etnsbanos"/> 
</bean> Ns 


这 种 配置 方式 与 分 别 指定 targetClass 和 targetMethod 属性 的 配置 方式 几乎 相同 ， 但 对 于 实例 方法 
的 情况 ， 则 只 能 采用 指定 targetObject 和 targetMethod 属性 值 的 方式 进行 配置 了 。 


7.11 基于 XML Schema 的 简化 配置 方式 


从 Spring 2.0 开始 ，Spring 允许 使 用 基于 XML Schema 的 配置 方式 来 简化 Spring 配置 文件 。 
对 于 早期 的 基于 DTD 的 Spring 配置 文件 而 言 ，Spring 用 一 种 <bean... 人 > 元 素 即 可 配置 所 有 的 Bean 
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实例 ， 而 每 个 属性 再 用 一 个 <property.… 人 > 元 素 即 可 ， 这 种 配置 方式 简单 、 直 观 ， 而 且 能 以 相同 风格 处 理 
所 有 Bean 配置 一 一 唯一 的 缺点 是 配置 复杂 ， 但 Bean 实例 的 属性 足够 多 且 属 性 类 型 复杂 (大 多 是 集合 
属性 时 )， 基 于 DTD 的 配置 文件 将 变 得 更 加 复杂 。 

在 这 种 情况 下 ，Spring 提出 了 使 用 基于 XML Schema 的 配置 方式 ， 这 种 配置 方式 更 加 简洁 ， 可 以 
对 Spring 配置 文件 进行 “减肥 ”， 但 需要 花 一 些 时 间 来 了 解 这 种 配置 方式 。 


>>7.11.1 使 用 p 名 称 宝 间 配置 属性 


Pp 名 称 空间 甚至 不 需要 特定 的 Schema 定义 , 它 直接 存在 于 Spring 内 核 中 .与 前 面 采 用 <property…/> 
元 素 定义 Bean 的 属性 不 同 的 是 ， 当 我 们 采用 了 p 名 称 空间 之 后 ， 就 可 直接 在 <bean... 人 > 元 素 中 使 用 属 
性 来 定义 Bean 实例 的 属性 值 了 。 

假设 有 如 下 的 持久 化 类 。 

程序 清单 : codes\07\7.11\p_namespace\src\org\crazyit\app\service\impl\Chinese.java 


public class Chinese 
implements Person 


{ 
private Axe axey 
private int agey 
public Chinese() 
{ 


} 
// 设 值 注入 axe 属性 所 需 的 setter 方法 
public void setAxe {Axe axe) 
{ 

this.axe = axe; 


} 
/7 设 值 注入 age 属性 所 希 的 setter 方法 
public void setAge(int age) 
{ 
this,age = age 


) 
// 实 现 Person 接口 的 usehxe 方法 
public void useAxe() 


{ 
// 调 用 axe 的 chop () 方法 ， 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System.out .Println (axe.chop()) 
System.out .printInt"age 属性 值 ， ”+ age) 7 
) 
} 


上 面 的 持久 化 类 中 有 axe、age 两 个 属性 需要 接受 依赖 注入 ， 如 果 采 用 原来 的 配置 方式 ， 则 需要 使 
用 <property.. 人 > 元 素来 配置 这 两 个 属性 ; 但 如 果 采 用 p 名 称 空 间 ， 则 可 直接 采用 属性 来 配置 它们 。 本 应 
用 的 配置 文件 如 下 。 
程序 清单 : codes\07\7.11\p_namespace\src\bean.xml 
<?xml version="1.0" encoding="GBK"?> 
<!-~ 指定 Spring 配置 文件 的 根 元 素 和 Schema 
并 导入 Pp 命名 空间 的 元 素 一 > 0 
<beans xmlns="http://www.springframework-org/schema/beansn 
xmlns:xsi="http: //www.w3.0rg/2001/XMLSchema-instance™ 
xmlns:p="http://ww.springframework.org/schema/p" 
xsi:schemaLocation="http://wuw. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 chinese 实例 ， 其 实现 类 是 Chinese --> 
<bean id="chinese" class="org.crazyit.app.service.impl.Chinese" 
P:age="29" p:axe-ref="stoneAxe"/> 
<!-- 配置 steelAxe 实例 ， 其 实现 类 是 SteelAxe --> 
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<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 

<!-- 配置 stoneAxee 实例 ， 其 实现 类 是 StoneAxe 一 -> 

<bean id="stoneAxe" class="org.crazyit.app.service.impl.StoneAxe"/> 
</beans> 


配置 文件 的 第 一 行 粗 体 字 代码 用 于 导入 XML Schema 里 的 p 名 字 空 间 ， 配置 文件 的 第 二 行 粗 体 字 
代码 则 直接 使 用 属性 配置 了 age、axe 两 个 属性 ， 其 中 因为 axe 属性 需要 引用 容器 中 另 一 个 已 存在 的 
Bean 实例 ， 故 在 axe 后 增加 了 “-ref” 后 级 ， 这 个 后 缀 指定 该 值 不 是 一 个 具体 的 值 ， 而 是 对 另外 一 个 
Bean 的 引用 。 


有 标准 的 XML 格式 灵活 ， 如 果 某 个 Bean 的 属性 名 是 以 “-ref” i 


六 
re 注意 :站 
使 用 p 名 称 空 


出 现 这 种 问题 。 


结尾 的 ， 那 么 采用 p 名 称 空间 定义 时 就 会 导致 冲突 ， 而 采用 标准 XML 格式 定义 则 不 会 be 


>>7.11.2 使 用 util Schema 


在 Spring 框架 解压 缩 包 的 projects\org.springframework.beans\src\main\resources\ 路 径 下 包含 大 量 
Schema 文件 ， 例 如 spring-beans-3.0.xsd、spring-tool-3.0.xsd 和 spring-util-3.0.xsd 等 ， 在 这 些 Schema 
中 ， 只 有 spring-beans-3.0.xsd 是 Spring 的 内 核 ， 其 他 Schema 大 都 用 于 简化 某 些 方面 的 配置 。 


“在 Spring 的 projects 分 模块 的 项 目 对 应 的 目录 下 ， 还 可 以 找到 spring-context-3.0.xsd、 
spring -bc-3.0.xsd 等 XML Schema 文档 , 这些 XML Schema 都 可 用 于 简化 Spring 配置 ， 后面 | 
| ”还 会 看 到 这 些 XML Schema 的 用 法 . j 


此 处 先 介绍 spring-util-3.0.xsd Schema 的 简化 功能 。 为 了 使 用 util Schema， 我 们 必须 先 在 Spring 
配置 文件 中 导入 spring-util-3.0.xsd， 也 就 是 需要 在 Spring 配置 文件 中 增加 如 下 粗 体 字 代码 配置 片段 : 

<?xml version="1.0"” encoding="GBK"?> 

<!-- 指定 Spring 配置 文件 的 根 元 素 和 Schema 
导入 Pp 命名 空间 和 util 命名 空间 的 元 素 --> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:util="http://mm™w. springfranework.org/schema/util" 
xsi:schemaLocation="http: //www.springframework.org/schema/beans 
http://ww. springframework.org/schema/beans/spring-beans-3.0.xsd 
http: //www.springframework.org/schema/util 
http://mmw.springfranework .org/schema/util/spring-util-3.0.xed">.... 

</beans> 

在 util Schema 下 提供 了 如 下 几 个 元 素 。 

> ”constant: 该 标签 用 于 将 指定 类 的 静态 Field 暴露 成 一 个 Bean 实例 。 使 用 该 标签 时 可 指定 如 
下 两 个 属性 。 

> ”id: 该 属性 指定 将 静态 Field 定义 成 名 为 id 的 Bean 实例 。 

> static-field: 该 属性 指定 将 哪个 类 、 哪 个 静态 Field 暴露 出 来 。 

> ”property-path: 该 标签 用 于 将 指定 Bean 实例 的 指定 属性 暴露 成 一 个 Bean 实例 。 使 用 该 标 
签 时 可 指定 如 下 两 个 属性 。 

> ”id: 该 属性 指定 将 属性 定义 成 名 为 id 的 Bean 实例 。 

> ”path: 该 属性 指定 将 哪个 Bean 实例 、 哪 个 属性 支持 复合 属性 ) 暴露 出 来 。 
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Fag constant、property-path 两 个 元 素 部 分 代替 了 FieldRetrievingFactoryBean、PropertyPath 
更 加 简洁 。 


> list， 该 标签 用 于 定义 一 个 List Bean， 支 持 使 用 <value.…/>、<ref../>、<bean.…/> 等 标签 来 定 
义 List 集合 元 素 。 使 用 该 标签 支持 如 下 三 个 属性 。 
> ”id: 该 属性 指定 定义 一 个 名 为 id 的 List Bean 实例 。 
> “list-class: 该 属性 指定 Spring 使 用 哪个 List 实现 类 来 创建 Bean 实例 。 
> ”scope: 指定 该 List Bean 实例 的 作用 域 。 
> ”set; 该 标签 用 于 定义 一 个 Set Bean， 支 持 使 用 <value.../>、<ref.../>、<bean../> 等 标签 来 定 
义 Set 集合 元 素 。 使 用 该 标签 支持 如 下 三 个 属性 。 
id: 该 属性 指定 定义 一 个 名 为 id 的 Set Bean 实例 。 
set-class: 该 属性 指定 Spring 使 用 哪个 Set 实现 类 来 创建 Bean 实例 。 
scope: 指定 该 Set Bean 实例 的 作用 域 。 
map: 该 标签 用 于 定义 一 个 Map Bean,， 支持 使 用 <entry.…/> 来 定义 Map 的 key-value 对 。 使 
用 该 标签 支持 如 下 三 个 属性 。 
> id: 该 属性 指定 定义 一 个 名 为 d 的 Map Bean 实例 。 
> map-class: 该 属性 指定 Spring 使 用 哪个 Map 实现 类 来 创建 Bean 实例 。 
> ”scope: 指定 该 Map Bean 实例 的 作用 域 。 
> ”properties: 该 标签 用 于 加 载 一 份 资源 文件 , 并 根据 加 载 的 资源 文件 创建 一 个 Properties Bean 
实例 。 使 用 该 标签 可 指定 如 下 几 个 属性 。 
> id: 该 属性 指定 定义 一 个 名 为 id 的 Properties Bean 实例 。 
> “location: 指定 资源 文件 的 位 置 。 
> ”scope: 指定 该 Properties Bean 实例 的 作用 域 。 
假设 有 如 下 的 Bean 类 文件 ， 这 份 文件 需要 List、Set、Map 等 集合 属性 。 
程序 清单 :codes\07\7.11\util\src\org\crazyit\app\service\impl\Chinese.java 
public class Chinese implements Person 
private Axe axe; 
private int age 
Private List schools: 
private Map scores; 
private Set axes; 


// 省 略 各 属性 的 setter 和 getter 方法 
EE ws 


下 面 使 用 基于 XML Schema 的 配置 文件 来 简化 这 种 配置 。 
程序 清单 : codes\07\7.11\utihsre\bean.xml 


<?xml version="1.0" encoding="GBK"?% 

<!-- 指定 Spring 配置 文件 的 根 元 素 和 Schema 
导入 Pp 命名 空间 和 util 命名 空间 的 元 素 --> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:p="http://www. springframework.org/schema/p" 
xmlns:util="http://ww. springframework.org/schema/util" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://ww. springframework.org/schema/util 
http://ww. springframework.org/schema/util/spring-util-3.0.xsd"> 
<1-- 配置 chinese 实例 ， 其 实现 类 是 Chinese 一 -> 
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<bean id="chinese" class="org.crazyit.app.service.impl.Chinese" 
Pp:age-ref="chin.age" Pp:axe-ref="stoneAxe" 
p:schools-ref="chin.schools" 
Pp:axes-ref="chin, axes" 
Pp:scores-ref="chin. scores"/> 
<!-- 使 用 util:constant 将 指定 类 的 静态 Field 典 露 出 来 --> 
<util:constant id="chin.age" static-field= 


property-path id="test" path="chinese. 
!-- 使 用 util.properties 加 载 指定 资源 文件 --> 
<util:properties id="confTest" 
location="classpath:test_zh_CN.properties"/> 
<!-- 使 用 util:1ist 定义 一 个 List 对 象 --> 
<util:list id="chin.schools" list-class="java.util.LinkedList"> 
<!-- 每 个 value、ref、bean 都 配置 一 个 List 元 素 --> 
<value> 小 学 </value> 
<value> 中 学 </value> 
<value> 大 学 </value> 
</util:list> 
<!-- 使 用 util:set 定义 一 个 Set 对 象 --> 
:set id="chin.axes" set-class="java.util.HashSet"> 
<!-- 每 个 value、ref、bean 都 配置 一 个 Set 元 素 --> 
<value> 字 符 串 莽 子 </valbey 
<bean class="org.crazyit.app.service.impl.SteelAxe"/> 
<ref local="stoneAxe"/> 
</util:set> 
<!-- 使 用 util:map 定义 一 个 Map 对 象 --> 
<util:map id="chin,scores" map-class="java.util.TreeMap"> 
<entry key=" 数 学 "value="87"/> 
<entry key=" 英 语 " value="89"/> 
<entry key=" 语 文 ”value="82"/> 
</util:map> 
<!-~ 配置 steelAxe 实例 ， 其 实现 类 是 SteelAxe 一 -> 
<bean id="steelAxe" class="0rg.crazyit.app.service.impl.SteelAxe"/> 
<!-- 配置 stoneAxee 实例 ， 其 实现 类 是 StoneAxe --> 
<bean id="stoneAxe" class="org.crazyit.app.service.impl.StoneAxe"/> 


</beans> 
上 面 的 配置 文件 完整 地 示范 了 util Schema 下 的 各 简化 标签 的 用 法 。 从 上 面 的 配置 文件 可 以 看 出 ， 
使 用 这 种 简化 标签 确实 可 让 Spring 配置 文件 更 加 简洁 ; 但 相对 而 言 , 这 种 配置 方式 降低 了 Spring 配置 
文件 的 可 读 性 。 
除 此 之 外 ， 关 于 Spring 其 他 常用 的 简化 Schema 的 简要 说 明 如 下 。 


> 


Vvvyv 


Fi2 


spring-aop-3.0.xsd: 用 于 简化 Spring AOP 配置 的 Schema。 
spring-jee-3.0.xsd: 用 于 简化 Spring 的 Java EE 配置 的 Schema。 
spring-jms-3.0.xsd: 用 于 简化 Spring 关于 JMS 配置 的 Schema。 
spring-lang-3.0.xsd: 用 于 简化 Spring 动态 语言 配置 的 Schema。 
spring-tx-3.0.xsd: 用 于 简化 Spring 事务 配置 的 Schema。 


Spring 3.0 提供 的 表达 式 语言 (SpEL) 


Spring 表达 式 语言 (简称 SpEL》 是 一 种 与 JSP 2 EL 功能 类 似 的 表达 式 语言 ， 它 可 以 在 运行 时 查 
询 和 操作 对 象 图 。 与 JSP2 的 EL 相 比 ，SpEL 功能 更 加 强大 ， 它 甚至 支持 方法 调用 和 基本 字符 串 模板 


函数 。 


SpEL 可 以 独立 于 Spring 容器 使 用 一 一 只 是 当成 简单 的 表达 式 语言 来 使 用 ， 也 可 以 在 Annotation 
或 XML 配置 中 使 用 SpPEL， 这 样 可 以 充分 利用 SpEL 简化 Spring 的 Bean 配置 。 
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>>7.12.1 使 用 Expression 接口 进行 表达 式 求 值 


Spring 的 SpEL 可 以 单独 使 用 ， 可 以 使 用 SpEL 对 表达 式 计算 、 求 值 。SpEL 主要 提供 了 如 下 两 个 
接口 。 

> ”ExpressionParser: 该 接口 的 实例 负责 解析 一 个 SpEL 表达 式 ， 返 回 一 个 Expression 对 象 。 

> ”Expression: 该 接口 的 实例 代表 一 个 表达 式 。 

Expression 实例 代表 一 个 表达 式 ， 它 包含 了 如 下 方法 可 用 于 计算 、 得 到 表达 式 的 值 。 

> ”Object getValue(): 计算 表达 式 的 值 。 

> <T>T getValue(Class<T> desiredResultType): 计算 表达 式 的 值 ， 而 且 尝试 将 该 表达 式 的 值 
当成 desiredResultType 类 型 处 理 。 

> ”Object getValue(EvaluationContext context): 使 用 指定 的 EvaluationContext 来 计算 表达 式 
的 值 。 

> <T> T getValue(EvaluationContext context， Class<T> desiredResultType) 使 用 指定 的 
Evaluation Context 来 计算 表达 式 的 值 。 而 且 尝 试 将 该 表达 式 的 值 当成 desiredResultType 
类 型 处 理 。 

> Object getValue(Object rootObject)， 以 rootObject 作为 表达 式 的 root 对 象 来 计算 表达 式 的 值 。 

> <T>TgetValue(Object rootObject, Class<T> desiredResultType): 以 rootObject 作为 表达 式 
的 root 对 象 来 计算 表达 式 的 值 。 而 且 尝试 将 该 表达 式 的 值 当成 desiredResultType 类 型 处 理 。 

下 面 的 程序 示范 了 如 何 利用 ExpressionParser 和 Expression 来 计算 表达 式 的 值 。 
程序 清单 : codes\07\7.12\Expression\src\lee\SpELTestjava 


public class spELTest 


{ 
public static void main{String[] args) 


{ 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser ~ new SpelExpressionParser(); 
// 最 简单 的 字符 申 表达 式 
Expression exp = parser.parseExpression("'HelloWorld'"); 
System.out .println("'HelloWorld' 的 结果 : ”+ exp.getValue()); 
// 调 用 方法 的 表达 式 
exp = parser.parseExpression("'HelloWorld' .concat ("1')"); 
System.out .println(""'HelloWorld' .concat ('!') 的 结果 : “" 
+ exp.getValue()); 
// 调 用 对 象 的 getter 方法 
xp = parser.parseExpression("'HelloWorld' .bytes") ; 
System.out .println("'HelloWorld' .bytes 的 结果 : " 
+ exp.getValue()); 
// 访 问 对 象 的 属性 (d 相当 于 HelloWorld.getBytes() .length) 
exp = Parser.parseExpression("'HelloWorld' .bytes.length") ; 
System.out .println("'HelloWorld' .bytes.length 的 结果 :" 
+ exp.getValue()); 
// 使 用 构造 器 来 创建 对 象 
exP = Parser.parseExpression ("new String(’helloworld')" 
+ ".toUpperCase()"); 
System.out .println("new String('helloworld')" 
+ ".,toUpperCase () 的 结果 是 : " 
+ exp.getValue(String.class)); 
Person person = new Person(1 ，" 孙 情 空 "，new Date()); 
exp = parser.parseExpression ("name") ; 
// 以 指定 对 象 作为 root 来 计算 表达 式 的 值 
// 相 当 于 调用 person .name 表达 式 的 值 
system.out.println(" 以 persn 为 root，name 表达 式 的 值 是 ， " 
+ exp.getValue (person , String.class)); 
exp = parser.parseExpression ("name==' 孙 司空 '") ; 
StandardEvaluationContext ctx = new StandardEvaluationContext (); 
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ctx. setRootObject (person); 
// 以 指定 Context 来 计算 表达 式 的 值 
System .out-Println (exp.getValue(ctx ，Boolean .class)) 
List<Boolean> list = new ArrayList<Boolean>(); 
list.add(true); 
EvaluationContext ctx2 = new StandardEvaluationContext ()7 
// 将 1ist 设置 成 EvaluationContext 的 一 个 变量 
ctx2.setVariable ("list" , list); 
// 修 饰 1ist 变量 的 第 一 个 元 素 的 值 
parser.parseExpression ("#1ist[0]") .setValue(ctx2 , "false"); 
//1ist 集合 的 第 一 个 元 素 被 改变 
System.out .println ("list 集合 的 第 一 个 元 素 为 : " 
+ list.get(0)); 
了 
上 


上 面 的 程序 中 粗 体 字 代 码 使 用 了 ExpressionParser 多 次 解析 了 不 同类 型 的 表达 式 , ExpressionParser 
调用 parseExpression() 方 法 将 返回 一 个 Expression 实例 (表达 式 对 象 )。 程 序 调用 Expression 对 象 的 
getValue() 方 法 即 可 获取 该 表达 式 的 值 。 

上 面 的 程序 还 涉及 一 个 EvaluationContext 对 象 ， 它 是 SpEL 计算 表达 式 值 的 “上 下 文 ” 对 象 ， 这 
个 Context 对 象 可 以 包含 多 个 对 象 ， 但 只 能 有 一 个 root ( 根 ) 对 象 。 

Fy valuationContext 的 作用 有 点 类 似 于 前 面 介绍 的 OGNL 中 的 Stack Context，Evaluation 1 
Context 可 以 包含 多 个 对 象 ， 但 只 能 有 一 个 root 对 入. | 


为 了 往 EvaluationContext 里 放 入 对 象 (SpEL 称 之 为 变量 )， 可 以 调用 该 对 象 的 如 下 方法 
> setVariable(String name, Object value): 向 EvaluationContext 中 放 入 value 对 象 ， 该 对 象 
名 为 name。 
为 了 在 SpEL 访问 EvaluationContext 中 指定 对 象 ， 应 采用 与 OGNL 类 似 的 格式 : 
#name 
StandardEvaluationContext 提供 了 如 下 方法 来 设置 root 对 象 。 
> setRootObject(Object rootObject) 
在 SpEL 中 访问 root 对 象 的 属性 时 ， 可 以 省 略 root 对 象 前 组 ， 例 如 如 下 代码 : 
foo.bar // 访 问 rootobject 的 foo 属性 的 bar 属性 。 
当然 ， 使 用 Expression 对 象 计算 表达 式 时 ， 也 可 以 直接 指定 root 对 象 ， 例 如 上 面 的 程序 中 的 粗 体 
字 代码 ; 
exp.getValue (person ，string.class) ”// 以 person 对 象 为 root 对 象 计算 家 达 起 的 什 ， 
上 面 的 程序 中 使 用 了 一 个 简单 的 Person 类 ， 它 只 是 一 个 普通 的 Java Bean， 读 者 可 以 参考 光盘 中 
codes\07\7. ee re 来 了 解 该 类 的 代码 。 


》>>7.12.2 Bean 定义 中 的 表达 式 语言 支持 


SpEL 的 一 个 重要 作用 就 是 扩展 Spring 容器 的 功能 ， 允 许 在 Bean 定义 中 使 用 SpPEL。XML 配置 文 
件 和 Annotation 中 都 可 以 使 用 SpEL。 在 XML 配置 文件 和 Annotation 中 使 用 SpEL 时 ， 都 需要 在 表达 
式 外 面 增加 #{} 包 围 。 

例如 下 面 有 如 下 Author 类 。 

程序 清单 : codes\07\7.12\SpEL_XML\src\org\crazyit\app\service\impl\Authorjava 


Public class Ruthor 
implements Person 
{ 
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Private String name; 
Private List<String> books; 
Private Axe axe; 
7/ 依赖 注入 Axe 对 象 的 setter 方法 
public void setAxe (Axe axe) 
{ 

this-axe = axe; 


了 
// 省 略 其 他 属性 的 setter 和 getter 方法 


public void useAxe() 
{ 
System,out .printin ("我 是 " 

+ name 
+ "正在 砍 柴 \n" 
+ axe.chop())7 

} 

上 


上 面 的 Author 类 需要 以 依赖 注入 name、books、axe 属性 ， 当 然 ， 可 以 按 前 面 介 绍 的 方式 来 进行 
配置 ， 但 如 果 使 用 SpEL， 将 可 以 对 Spring 配置 作 进一步 简化 。 


此 处 不 再 再 述 .。 | 


nd ee a 
GG. “本 应 用 还 使 用 了 Axe 接口 和 SteelAxe 实现 类 ， 由 于 这 个 接口 和 实现 类 都 非常 简单 ， 故 “ 


下 面 使 用 SpEL 对 这 个 Bean 进行 配置 ， 配 置 代码 如 下 。 
程序 清单 :codes\07\7.12\SpEL_XML\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 

<!-~ 指定 Spring 配置 文件 的 根 元 素 和 Schema 
导入 Pp 命名 空间 和 util 命名 空间 的 元 素 --> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:p="http://www. springframework.org/schema/p” 
xmlns:util="http://www. springframework.org/schema/util" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 

/www. springframework.org/schema/beans/spring-beans-3.0.xsd 

/www. springframework.org/schema/util 

/www. springframework.org/schema/util/spring-util-3.0.xsd"> 

使 用 util.properties 加 载 指定 资源 文件 一 > 

<util:properties id="confTest" 
location="classpath:test_zh_CN.properties"/> 


<!-- 
配置 name 属性 值 时 ， 在 表达 式 中 调用 方法 
配置 axe 属性 值 时 ， 在 表达 式 中 创建 对 象 --> 
<bean id="author" class="org.crazyit.app.service.impl.Author" 
Pp:name="#{T (java. lang.Math) .random() }" 
Pp:axe="#{new org.crazyit.app. service. impl.SteelAxe()}"> 
<property name="books"> 
<list> 
<!-- 在 表达 式 中 访问 其 他 Bean 的 属性 --> 
‘<value>#{confTest.a}</value> 
<value>#{confTest.b}</value> 
</list> 
</property> 
</bean> 
</beans> 


上 面 的 粗 体 字 代 码 就 是 利用 SpEL 进行 配置 的 代码 ， 使 用 SpEL 可 以 在 配置 文件 中 调用 方法 、 创 
建 对 和 象 《 这 种 方式 可 以 代替 嵌 套 Bean 语法 )， 访 问 其 他 Bean 的 属性 ,等 等 ， 总 之 SpEL 支持 的 语法 都 
可 以 在 这 里 使 用 ，SpEL 极 大 地 简化 了 Spring 的 配置 。 

需要 指出 的 是 , 在 Annotation 中 使 用 SpEL 与 在 XML 中 使 用 SpEL 基本 上 相似 , 关于 Spring 使 用 
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Annotation 进行 配置 管理 的 内 容 请 参考 下 一 章 的 知识 。 
> >7.12.3 SpEL 语法 详 述 


虽然 SpEL 的 功能 上 大 致 与 JSP2 的 EL 类 似 , 但 SpEL 比 JSP2 的 EL 更 强大 , 接 下 来 我 们 详细 介 
绍 SpEL 所 支持 的 各 种 语法 细节 。 

1. 直接 量 表达 式 

直接 量 表达 式 是 SpEL 中 最 简单 的 表达 式 ， 直 接 量 表达 式 就 在 表达 式 中 使 用 Java 语言 支持 的 直接 
量 ， 包 括 字符 串 、 日 期 、 数 值 、boolean 值 和 null。 

例如 如 下 代码 片段 : 


ExpressionParser parser = new SpelExpressionParser(); 


// 计算 结果 为 "Hello World" 
String helloWorld = parser.parseExpression("'Hello World'") 
“getValue (String.class); 
double num = (Double) parser.parseExpression("0.23") 
.getValue (Double.class); 
2. 在 表达 式 中 创建 数组 
SpEL 表达 式 直接 支持 使 用 静态 初始 化 、 动 态 初始 化 两 种 语法 来 创建 数组 ， 例 如 如 下 代码 片段 : 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser(); 
// 创 建 一 个 数组 
Expression exp = parser.parseExpression( 
"new String[]{'java' , 'Struts' , 'Spring'}"); 
System.out .println (exp.getValue()); 
// 创 建 二 维 数组 
@xp = parser. 
"new int[2][4]"); 
System.out.println (exp.getValue()); 


3， 在 表达 式 中 创建 List 集合 
SpEL 直接 使 用 如 下 语法 可 以 创建 List 集合 : 


{elel ，ele2 , ele3 ...} 


例如 如 下 代码 : 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser(); 
// 创 建 一 个 List 集合 
Expression exp = parser.parseExpression( 

"{'java' , ‘Struts' , 'Spring'}"); 
System.out.println (exp.getValue()); 
// 创 建 “ 二 维 ”List 集合 
exP = parser.parseExpression( 

"{{' 妆 狂 Java 讲义 ，' "1，《{" 左 传 ” ， "战国 策 '11") 7 
System.out.println(exp.getValue ()) 7 


3. 在 表达 式 中 访问 List、Map 等 集合 元 素 

为 了 在 SpEL 中 访问 List 集合 的 元 素 ， 可 以 使 用 如 下 语法 格式 : 
1ist[index] 

为 了 在 SpEL 中 访问 Map 集合 的 元 素 ， 可 以 使 用 如 下 语法 格式 : 
map[key] 

例如 如 下 代码 : 

List<string> list = new ArrayList<string>()? 


list.add("Java"); 
list.add("spring"); 


ion( 
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和 7 


Map<String, Double> map = 

new HashMap<String, Double>(); 
map.put ("Java™" , 80.0); 
map.put ("Spring" , 89.0); 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser(); 
EvaluationContext ctx = new StandardEvaluationContext(); 
// 设 置 两 个 变量 
ctx.setVariable ("mylist" , list); 
ctx.setVvariable ("mymap" , map); 
// 访 问 Fist 集合 的 第 二 个 元 素 
System.out.println(parser 

k sion("#mylist[1]") .getVvalue (ctx) ) ; 
// 访 问 Map 集合 | 元 


System.out .println (parser 
.ParseExpression ("#mymap[' Java']") .getValue (ctx)) 7 


4. 调用 方法 
在 SpEL 中 调用 方法 与 在 Java 代码 中 调用 方法 没有 任何 区 别 。 如 以 下 代码 所 示 : 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 


ExpressionParser parser = new SpelExpressionParser() 7 

EvaluationContext ctx ~ new StandardEvaluationContext ()7 

// 调 用 Stringd 对 象 的 substring 方法 

System ,out.Println (parser 
.parseExpression ("'HelloWor1d' .substring(2，5)") 
-getValue ()); 

List<string> list = new ArrayList<string>()? 

list.add("java"); 

list.add("struts"); 

list.add("spring"); 

list.add{("hibernate"); 

// 设 置 一 个 变量 

ctx.setVariable ("mylist" , list); 

System.out.println (parser 
,parseExpression("#mylist. subList (1, 3)").getValve(ctx)); 


5. 算术 、 上 比较、 逻辑 、 赋 值 、 三 目 等 运算 符 

与 JSP 2 EL 类 似 的 是 SpEL 同样 支持 算术 、 比 较 、 逻 辑 、 赋 值 、 三 目 运 算 赋 等 各 种 运算 符 ， 值 得 
指出 的 是 ， 在 SpEL 中 使 用 赋值 运算 符 功能 比较 强大 。 这 种 赋值 可 以 直接 改变 表达 式 所 引用 的 实际 对 
象 。 如 以 下 代码 所 示 : 


// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 

ExpressionParser parser ~ new SpelExpressionParser(); 

EvaluationContext ctx = new StandardEvaluationContext(); 

List<string> list = new ArrayList<string>(); 

list.add("java"); 

list.add("struts"); 

list.add("spring"); 

list.add ("hibernate"); 

// 设 置 一 个 变量 

ctx.setVariable ("mylist" , list); 

// 对 集合 的 第 一 个 元 素 进行 赋值 

Parser .parseExpression("#mylist[0]=' 疙 狂 Java 讲义 '") 
.getValue (ctx) ; 

// 下 面 将 输出 疯狂 Java 讲义 

System. out..println(list.get (0)); 

// 使 用 三 目 运算 符 

System.out.println (parser .parseExpression ("#mylist. size()>3?" 
+ "'myList 长 度 大 于 3': "myList 长 度 不 大 于 3'") 


.getValue (ctx)); 


6. 类 型 运算 符 
SpEL 提供 了 一 个 特殊 的 运算 符 : TO， 这 个 运算 符 用 于 告诉 SpEL 将 该 运算 符 内 字符 串 当成 “类 ” 
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处 理 ， 避 免 Spring 对 其 进行 其 他 解析 。 尤 其 是 调用 某 个 类 的 静态 方法 时 ，TO 运 算 符 尤其 有 用 。 
例如 如 下 代码 : 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser(); 
// 调 用 Math 的 静态 方法 
System.out.println (parser .parseExpression( 
"T(java.lang.Math) .random()") .getValue()); 
// 调 用 Math 的 静态 方法 
System.out.println (parser.parseExpression( 
"T(System) .getProperty('os.name')") .getValue()) 7 


正如 上 面 的 代码 中 看 到 的 ， 在 表达 式 中 使 用 某 个 类 时 ， 推 荐 使 用 该 类 的 全 限定 类 名 。 但 如 果 只 写 
类 名 ， 不 写 包 名 ，SpEL 也 可 以 尝试 处 理 ，SpEL 使 用 StandardTypeLocator 去 定位 这 些 类 ， 它 默认 会 在 
java. 下 找 这 些 类 。 


和 YE ， 入 ”ou 
TO 运算 符 使 用 java.lang 包 下 的 类 时 可 以 省 咯 包 名 ， 但 使 用 其 他 包 下 的 所 有 类 时 应 使 
用 全 限定 类 名 。 


7. 调用 构造 器 
SpEL 允许 在 表达 式 直接 使 用 new 来 调用 构造 器 , 这 种 调用 可 以 创建 一 个 Java 对 象 。 例如 如 下 代码 ， 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser()7 
// 创 建 对 象 
System.out.println (parser.parseExpression 
"new String('HelloWorld') . Ps 4)") 
.getValue ()); 
// 创 建 对 象 
System.out.Println (parser.parseExpression( 
"new javax.swing.JFrame ("测试 ')" 
+ ".setVisible('true')") .getValue()); 
8. 变量 
SpEL 允许 通过 通过 EvaluationContext 来 使 用 变量 ， 该 对 象 包含 了 一 个 setVariable(String name, 
Object value) 方 法 ， 该 方法 用 于 设置 一 个 变量 。 
- 且 在 EvaluationContext 设置 了 变量 ， 就 可 以 在 SpEL 中 通过 #name 来 访问 该 变量 。 前 面 已 经 有 
不 少 在 SpEL 中 使 用 变量 的 例子 ， 故 此 处 不 再 著述 。 
值得 指出 的 是 SpEL 中 有 如 下 两 个 特殊 的 变量 。 
> #this: 引用 SpEL 当前 正在 计算 的 对 象 。 
> 。 帮 oot: 引用 SpEL 的 EvaluationContext 的 root 对 象 。 
9.， 自 定义 函数 


SpEL 人 允许 开发 者 开发 自 定义 函数 。 类 似 于 JSP 2 EL 中 的 自 定义 函数 ， 所 谓 自 定义 函数 ， 也 就 是 
为 Java 方法 重新 起 个 名 字 而 已 。 

通过 StandardEvaluationContext 的 如 下 方法 即 可 在 SpEL 中 注册 自 定义 函数 : 

> registerFunction(String name, Method m): 将 m 方法 注册 成 自 定义 函数 , 该 函数 的 名 称 为 name。 

就 笔者 来 看 SpEL 这 个 自 定义 函数 的 作用 并 不 大 ， 因 为 SpEL 本 身 已 经 允许 在 表达 式 语言 中 调用 
方法 ， 因 此 将 方法 重新 定义 自 定义 函数 的 意义 不 大 。 

10. Elvis 运算 符 

Elvis 运算 符 只 是 三 目 运 算 符 的 特殊 写法 ， 例 如 对 于 如 下 三 目 运算 符 写法 : 


name != null ? name : "newVal" 
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法 


上 面 的 语句 使 用 三 目 运算 符 需要 将 name 变量 写 两 次 ， 因 此 比较 繁琐 。SpEL 允许 将 上 面 写法 简写 
为 如 下 形式 : 


name?: "newVal" 
11， 安 全 导航 操作 
当 我 们 在 SpEL 中 使 用 如 下 语句 时 可 能 导致 NullPointerException: 
foo.bar 
如 果 root 对 象 的 foo 属性 本 身 已 经 是 null, 上 面 表达 式 尝 试 访问 foo 属性 的 bar 属性 自然 就 会 引发 异常 。 
为 了 避免 上 面 的 表达 式 中 的 NullPointerException，SpEL 支持 如 下 用 法 : 
foo? .bar 
上 面 的 表达 式 在 计算 root 对 象 的 foo 属性 时 ， 如 果 foo 属性 为 null 时， 计算 结果 将 直接 返回 null， 
而 不 会 引发 NullPointerException 。 
如 以 下 代码 所 示 : 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 


ExpressionParser parser ~ new SpelExpressionparser(); 
// 使 用 安全 操作 ， 将 输出 null 
System.out.println("-- 一 ”+ parser.parseExpression( 
"#£00?.bar") .getValue()) 7 
// 不 使 用 安全 操作 ， 将 引发 NullPointerException 
System.out.println(parser.parseExpression{ 
"#f00.bar") .getValuet))7 
12， 集 合 选择 
SpEL 人 允许 直接 对 集合 进行 选择 操作 ， 这 种 选择 操作 可 以 根据 指定 表达 式 对 集合 元 素 进行 利 选 ， 
只 有 符合 条 件 的 集合 元 素 才 会 被 选择 出 来 。SpEL 集合 选择 的 语法 格式 如 下 : 
collection.?[condition_expr] 
上 面 的 语法 格式 中 ，condition_expr 是 一 个 根据 集合 元 素 定义 的 表达 式 ， 只 有 当 该 表达 式 返 回 true 
时 ， 对 应 的 集合 元 素 才 会 被 筛选 出 来 。 如 以 下 代码 所 示 : 
// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser() 7 
List<String> list = new ArrayList<string>()» 
list.add ("疯狂 Java 讲义 "); 
list.add ("疯狂 Ajax 讲义 "); 
1list .add(" 疯 狂 XML 讲义 ") 7 
1ist.add(" 经 典 Java EE 企业 应 用 实战 ") ; 
EvaluationContext ctx = new StandardEvaluationContext (); 
ctx.setVariable ("mylist" , list); 
// 判 断 集合 元 素 length () 方法 的 长 度 大 于 7, “疯狂 XML 讲义 ”被 删除 
Expression expr = parser.parseExpression 
("Hmylist.? [length()>7]"); 
System.out.println (expr.getValue (ctx) ); 
Map<Stringy Double> map = new HashMap<String ,Double>()7 
map.put ("Java" , 89.0); 
map.put ("Spring" ,82. 
map.put ("英语 "”，75.0); 
ctx.setVariable ("mymap" ,map) 
// 判 断 Map 集合 的 value 值 大 于 80， 其 保 入 前 面 2 个 Entry 
@xpr = parser.parseExpression 
("mymap. ? [value>80] ") ; 
System.out.Println (expr.getValue (ctx)); 


正如 上 面 的 粗 体 字 代码 所 示 , 这 种 集合 选择 既 可 对 List 集合 进行 筛选 , 也 可 对 Map 集合 进行 筛选 ， 
当 操作 List 集合 时 ，condition_expr 中 访问 的 每 个 属性 、 方 法 都 是 以 集合 元 素 为 主 调 的 ， 当 操作 Map 
集合 时 ， 需 要 显 式 地 用 key 引用 Map Entry 的 key， 用 value 引用 Map Entry 的 value。 
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13. 集合 投影 

SpEL 允许 对 集合 进行 投影 运算 ， 这 种 投影 运算 将 依次 迭代 每 个 集合 元 素 ， 和 迭代 时 将 根据 指定 表 
达 式 对 集合 元 素 进行 计算 得 到 一 个 新 的 结果 ， 依 次 将 每 个 结果 收集 成 新 的 集合 ， 这 个 新 的 集合 将 作为 
投影 运算 的 结果 。 

SPEL 投影 运算 的 语法 格式 为 : 

collection. ! [condition_expr] 

上 面 的 语法 格式 中 ，condition_expr 是 一 个 根据 集合 元 素 定义 的 表达 式 。 上 面 的 SpEL 会 依次 把 
collection 的 集合 中 元 素 依次 传 入 condition_expr 中 ， 每 个 元 素 得 到 一 个 新 的 结果 ， 所 有 计算 出 来 的 结 
果 所 组 成 的 新 结果 就 是 该 表达 式 的 返回 值 。 

如 下 代码 示范 了 集合 投影 运算 : 

7/ 创建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 
ExpressionParser parser = new SpelExpressionParser(); 
List<string> list = new ArrayList<string>(); 
1list .add(" 疯 狂 Java 讲义 ") ; 
list.add ("疯狂 Ajax 讲义 "); 
list.add(" 疯 狂 XML 讲义 "); 
list -add (" 经 典 Java EE 企业 应 用 实战") ; 
EvaluationContext ctx = new StandardEvaluationContext(); 
ctx.setVariable ("mylist" , list); 
// 得 到 的 新 集合 的 元 素 是 原 集合 的 每 个 元 素 length () 方 法 返回 值 
ion expr = parser.parseExpression 
("Hmylist. ! [length()]"); 
System.out.println(expr. getValue (ctx))7 
List<Person> list2 = new ArrayList<Person>(); 
dd (new Person(1, " 孙 情 空 ”，162)); 
id (new Person (1， "猪八戒 "”，182)); 
.add (new Person(1，" 牛 魔王 ” ，195)) 
ctx.setVvariable ("mylist2" , list2); 
// scan name 用 性 值 
@xpr = parser. 
("fmylist2. Me 
System.out ,println(expr.getValue (ctx)); 


上 面 的 程序 用 到 了 一 个 简单 的 Person 类 ， 它 只 是 一 个 非常 简单 的 Java Bean， 关 于 该 类 的 代码 可 
以 参考 光盘 中 codes\07\7.12\collection_projection\src\org\crazyitdomain 目录 下 Personjava 文件 。 
14. 表达 式 模板 
表达 式 模板 有 点 类 似 于 带 占 位 符 的 国际 化 消息 。 例 如 如 下 带 占 位 符 的 国际 化 消息 : 
今天 的 股票 价格 是 : {I) 
上 面 的 消息 可 能 生成 如 下 字符 串 : 
今天 的 股票 价格 是 :123 
上 面 的 字符 串 中 的 123 需要 每 次 动态 改变 。 
这 种 需求 可 以 借助 于 SpEL 的 表达 式 模板 的 支持 。 表 达 式 模板 的 本 质 是 对 “直接 量 表 达 式 ”的 扩 
展 ， 它 允许 在 “直接 量 表达 式 ” 中 插入 一 个 或 多 个 #{expr}，#{expr} 将 会 被 动态 计算 出 来 。 
例如 如 下 程序 示范 了 使 用 表达 式 模 板 : 


// 创 建 一 个 ExpressionParser 对 象 ， 用 于 解析 表达 式 

ExpressionParser parser = new SpelExpressionParser(); 

Person pl = new Person(1, "孙悟空 ”，162); 

Person p2 = new Person(1，" 猿 人 戒 " ，182); 

Expression expr = parser 
“ParseExpression ("我 的 名 字 是 #{name) ,身高 是 #{height}" 
, new TemplateParserContext ()); 

// 将 使 用 pl 对 和 象 name、height 填充 上 面 表达 式 模板 中 的 #T) 

System.out .printin {expr.getValue (p1)); 

// 将 使 用 p2 对 象 name、height 填充 上 面 表 达 式 模板 中 的 #{} 
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System.out.println (expr .getValue (p2)); 
正如 上 面 的 程序 中 可 以 看 到 的 ， 使 用 ExpressionParser 解析 字符 串 模板 时 需要 传 入 一 个 
TemplateParser Context 参数 ， 该 TemplateParserContext 实现 了 ParserContext 接口 ， 它 用 于 为 表达 式 解 
析 传 入 一 些 额外 的 信息 ， 例 如 TemplateParserContext 指定 解析 时 需要 计算 #{ 和 } 之 间 的 值 。 


7.13 ”本 章 小 结 


本 章 简要 介绍 了 Spring 框架 的 相关 方面 ,包括 Spring 框架 的 起 源 、 背 景 及 大 致 情况 ， 详细 介绍 了 
如 何在 实际 开发 中 使 用 Spring 框架 ,以 及 如 何 利用 Eclipse 工具 开发 Spring 应 用 。 本 章 主要 介绍 了 Spring 
框架 的 核心 :IoC 容器 ,详细 介绍 了 Spring 容器 的 种 种 用 法 .在 介绍 Spring 容器 的 同时 ,也 介绍 了 Spring 
容器 中 的 Bean， 介 绍 了 Bean 依赖 的 配置 、 各 种 特殊 配置 等 ， 并 详细 介绍 了 Bean 之 间 的 继承 、 生 命 周 
期 、 作 用 域 等 知识 。 

本 章 也 介绍 了 如 何 利用 XML Schema 来 简化 Spring 的 配置 ， 最 后 还 介绍 了 Spring 3.0 的 一 个 重要 
的 新 特性 : SpPEL〈Spring 表达 式 语言 )，SpEL 既 可 单独 使 用 ， 也 可 以 与 Spring 容器 结合 使 用 、 用 于 扩 
展 Spring 容器 的 功能 。 下 一 章 将 更 深入 地 介绍 Spring 框架 的 使 用 ， 包 括 利用 Spring IoC 容器 扩展 点 ， 
还 将 介绍 Spring 容器 的 另 一 个 核心 机 制 : AOP。 除 此 之 外 ,还 将 重点 介绍 Spring 与 Hibernate、Struts 2 
框架 的 整合 。 
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第 8 章 
深入 使 用 Spring 


本 章 要 点 


节 利 用 后 处 理 器 扩展 Spring 容器 

好 Bean 后 处 理 器 和 容器 后 处 理 器 
3aSpring 3.0 的 “ 零 配置 ”支持 

好 Spring 的 资源 访问 策略 

功 在 ApplicationContext 中 使 用 资源 
和 AOP 的 基本 概念 

他 AspectJ 使 用 入 门 

他 生 成 AOP 代理 和 AOP 代理 的 作用 
节 基 于 Annotation 的 “ 零 配置 ”方式 
他 基 于 XML 配置 文件 的 管理 方式 
芭 Spring 的 事务 策略 

和 Spring 2.X 的 事务 配置 

各 Spring 整合 MVC 框架 的 策略 
SaSpring 整合 Struts 2 

好 Spring 整合 Hibernate 

节 Spring 整合 JPA 
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上 一 章 已 经 介绍 了 Spring 框架 的 基础 内 容 ， 详 细 介绍 了 Spring 容器 的 核心 机 制 : 依赖 注入 ， 并 介 
绍 了 Spring 容器 对 Bean 的 管理 。 实 际 上 ， 上 一 章 介绍 的 内 容 是 大 部 分 项 目 都 需要 使 用 的 基础 部 分 ， 
很 多 时 候 ， 即 使 不 使 用 Spring 框架 ， 实 际 项 目 也 都 会 采用 相同 的 策略 。 

但 Spring 框架 的 功能 绝 不 是 只 有 这 些 部 分 ，Spring 框架 允许 开发 者 使 用 两 种 后 处 理 器 扩展 oC 容 
器 ,这 两 种 后 处 理 器 可 以 后 处 理 IoC 容器 本 身 ， 或 对 容器 中 所 有 的 Bean 进行 后 处 理 。IoC 容器 还 提供 
了 AOP 功能 ， 极 好 地 丰富 了 Spring 容器 的 功能 。 

Spring AOP 是 Spring 框架 男 一 个 吸引 人 的 地 方 ，AOP 本 身 是 一 种 非常 前 沿 的 编程 思想 ， 它 从 动 
态 角度 考虑 程序 运行 过 程 ,专门 用 于 处 理 系统 中 分 布 于 各 个 模块 (不 同方 法 ) 中 的 交叉 关注 点 的 问题 ， 
能 更 好 地 抽 离 出 各 模块 的 交叉 关注 点 。 

Spring 的 声明 式 事务 管理 正 是 通过 AOP 来 实现 的 。 当 然 ， 如 果 我 们 仅仅 想 使 用 Spring 的 声明 式 
事务 管理 ， 其 实 完全 无 须 掌握 AOP， 但 如 果 我 们 希望 开发 出 使 用 结构 更 优雅 的 应 用 ， 例 如 集中 处 理应 
用 的 权限 控制 、 系 统 日 志 等 需求 ， 则 应 该 使 用 AOP 来 处 理 。 

除 此 之 外 ， 本 章 还 将 详细 介绍 Spring 与 Hibernate 和 Struts 2 框架 的 整合 。 


8.1 两 种 后 处 理 器 


Spring 框架 提供 了 很 好 的 扩展 性 ， 除 了 可 以 与 各 种 第 三 方 框架 良好 整合 外 ， 其 IoC 容器 也 允许 开 
发 者 进行 扩展 ， 这 种 扩展 甚至 无 须 实现 BeanFactory 或 ApplicationContext 接口 ， 而 是 允许 通过 两 个 后 
处 理 器 对 IoC 容器 进行 扩展 。Spring 提供 了 两 种 常用 的 后 处 理 器 : 

Bean 后 处 理 器 : 这 种 后 处 理 器 会 对 容器 中 的 Bean 进行 后 处 理 ， 对 Bean 功能 进行 额外 加 强 。 

> ”容器 后 处 理 器 ， 这 种 后 处 理 器 对 loC 容器 进行 后 处 理 ， 用 于 增强 容器 功能 。 

> ”下面 将 介绍 这 两 种 常用 的 后 处 理 器 ， 以 及 两 种 后 处 理 器 的 相关 知识 。 


>》>8.1.1 Bean 后 处 理 器 


Bean 后 处 理 器 是 一 种 特殊 的 Bean， 这 种 特殊 Bean 并 不 对 外 提供 服务 ， 它 甚至 可 以 无 须 id 属性 ， 
它 主要 负责 对 容器 中 的 其 他 Bean 执行 后 处 理 ， 例 如 为 容器 中 的 目标 Bean 生成 代理 等 ， 这 种 Bean 被 
称 为 Bean 后 处 理 器 。 
Bean 后 处 理 器 会 在 Bean 实例 创建 成 功 之 后 ， 对 Bean 实例 进行 进一步 的 增强 处 理 。 
Bean 后 处 理 器 必须 实现 BeanPostProcessor 接口 ，BeanPostProcessor 接口 包含 如 下 两 个 方法 。 
> Object postProcessBeforelnitialization(Object bean , String name)throws BeansException: 
该 方法 第 一 个 参数 ， 是 系统 即将 进行 后 处 理 的 Bean 实例 ， 第 二 个 参数 是 该 Bean 实例 的 名 
字 。 
> Object postProcessAfterlnitialization(Object bean , String name)throws BeansException: 
该 方法 的 第 一 个 参数 ， 是 系统 即将 进行 后 处 理 的 Bean 实例 ， 第 二 个 参数 是 该 Bean 实例 的 
名 字 。 
实现 该 接口 的 Bean 后 处 理 器 必须 实现 这 两 个 方法 ， 这 两 个 方法 会 对 容器 的 Bean 进行 后 处 理 ， 会 
在 目标 Bean 初始 化 之 前 、 初 始 化 之 后 分 别 被 回调 , 这 两 个 方法 用 于 对 容器 中 的 Bean 实例 进行 增强 处 理 。 


Bean 后 处 理 器 是 对 loC 容器 一 种 板 好 的 扩展 ， Bean 后 处 理 器 可 以 对 容器 中 Bean 进 
行 后 处 理 , 而 到 底 要 对 Bean 进行 起 样 的 后 处 理 则 完全 取决 于 开发 者 . Spring 容器 负责 把 
各 Bean 创建 出 来 、 Bean 后 处 理 器 ( 由 开发 者 提供 ) 可 以 依次 对 每 个 Bean 进行 某 种 修改 、 
增强 ， 从 测 可 内 对 客栈 站 Bean 条 中 增加 森 补 功能。 订 
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下 面 将 定义 一 个 简单 的 Bean 后 处 理 器 , 该 Bean 后 处 理 器 将 对 容器 中 其 他 Bean 进行 后 处 理 。 Bean 
后 处 理 器 的 代码 如 下 。 
程序 清单 :codes\08\8.1\BeanPostProcessor\src\org\crazyit\app\util\MyBeanPostProcessorjava 


public class MyBeanPostProcessor 
implements BeanPostProcessor 
{ 
J 
* 对 容器 中 的 Bean 实例 进行 后 处 理 
* @param bean 需要 进行 后 处 理 的 原 Bean 实例 
* 86param beanName 需要 进行 后 处 理 的 Bean 实例 的 名 字 
* 8return 返回 后 处 理 完成 后 的 Bean 
二 人 
public Object postProcessBeforeInitialization 
(Object bean , string beanName) 


System.out.println ("Bean 后 处 理 器 在 初始化 之 前 对 
+ beanName + "进行 增强 处 理 ..."); 

// 返 回 的 处 理 后 的 Bean 实例 

// 该 Bean 实例 就 是 容器 中 到 时 实际 使 用 的 Bean 实例 

// 该 Bean 实例 甚至 可 与 原 Bean 截然 不 同 

return bean; 


{ 


} 
Public Object postProcessAfterInitialization 
(Object bean , String beanName) 


System.out .println ("Bean 后 处 理 器 在 初始 化 之 后 对 " 


+ beanName + "进行 增强 处 理 ..."); 


// 如 果 该 Beati 是 Chinese 类 的 实例 
if (bean instanceof Chinese) 


和 
7/ 修改 其 name 属性 什 
Chinese c = (Chinese)bean; 
c.setName ("Struts 2 权威 指南 ") ; 


{ 


return bean; 
) 
§ 


上 面 的 程序 中 两 行 粗 体 字 代码 实现 了 对 Bean 进行 增强 处 理 的 逻辑 ， 当 Spring 容器 实例 化 Bean 实 
例 之 后 ， 就 会 依次 调用 Bean 后 处 理 器 的 两 个 方法 对 Bean 实例 进行 增强 处 理 。 

下 面 是 Chinese Bean 类 的 代码 ， 该 类 实现 了 InitializingBean 接口 (并 实现 了 该 接口 包含 的 
afterPropertiesSet0 方 法 )， 还 额外 提供 了 一 个 初始 化 方法 (init0 方 法 )， 这 两 个 方法 都 用 于 定制 该 Bean 
实例 的 生命 周期 行为 。 

程序 清单 : codes\08\8.1\BeanPostProcessor\src\org\crazyit\app\service\impl\Chinese.java 


public class Chinese 
implements Person,InitializingBean 
{ 4 
private Axe axe; 
Private String name; 
public Chinese() 
{ 
System.out .println ("Spring 实例 化 主 调 bean: Chinese 实例 ..."); 
} 
public void setAxe (Axe axe) 
{ 
this.axe = axe7 
} 
public void setName (String name) 
{ 
System.out .println ("Spring 执行 依赖 关系 注入 - 


this name = name; 
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public void useAxe() 
{ 
System.out .println (name + axe.chop()); 


} 
// 下 面 是 两 个 生命 周期 方法 
public void init() 


{ 
System.out.println ("正在 执行 初始 化 方法 init..."); 
} 
public void afterPropertiesSet() throws Exception 
{ 


System.out.println ("正在 执行 初始 化 方法 afterPropertiesSet..."); 
} 
! 


在 配置 文件 中 配置 Bean 后 处 理 器 和 配置 普通 Bean 完全 一 样 ， 但 有 一 点 需要 指出 ， 如 果 程 序 无 须 
获取 Bean 后 处 理 器 ， 则 配置 文件 可 以 无 须 为 该 Bean 指定 id 属性 。 下 面 的 配置 文件 因为 需要 手动 注册 
Bean 后 处 理 器 ， 所 以 配置 文件 依然 为 Bean 后 处 理 器 指定 了 id 属性 。 配 置 文 件 如 下 。 

程序 清单 : codes\08\8.1\BeanPostProcessorsrc\bean .xml 


<?xml version="].0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 -> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 2 个 普通 Bean 实例 --> 
<bean id="steelAxe" class="org.crazyit.app.service.impl.SteelAxe"/> 
<bean id="chinese" class="org.crazyit.app.service,impl.Chinese" 
init-method="init"> 
<property name="axe" x ‘eelAxe"/> 
<property name="name”value=" 依 赖 注 入 的 值 "/> 
</bean> 
<!-- 配置 Bean 后 处 理 器 ， 可 以 无 需 指定 id 属性 --> 
<bean id="beanPostProcessor" 
class="org.crazyit.app.util.MyBeanPostProcessor"/> 


</beans> 


上 面 文件 的 粗 体 字 代码 定义 了 一 个 Bean 后 处 理 器 ， 这 个 Bean 后 处 理 器 将 会 对 容器 中 所 有 Bean 
实例 进行 后 处 理 。 为 了 更 好 地 观察 到 Bean 后 处 理 器 的 后 处 理 方 法 的 执行 时 机 ， 程 序 还 为 chinese Bean 
指定 了 如 下 两 个 初始 化 方法 : 

> init-method 指定 初始 化 方法 。 

> ”实现 InitializingBean 接口 ， 提 供 了 afterPropertiesSet 初始 化 方法 。 

二. 


上 面 的 配置 文件 配置 Bean 后 处 理 器 时 , 依然 为 Bean 处 理 器 指定 了 id 属性 ， 指 
属性 为 了 方便 程序 通过 该 i 属性 访问 Bean 后 处 理 器 。 大 部 分 时 候 ， 程 序 无 须 手 动 访问 
Bean 后 处 理 器 ， 因 此 无 须 为 其 指定 id 属性 。 by 


主 程序 如 下 。 

程序 清单 : codes\08\8.1\BeanPostProcessor\src\lee\BeanTest.java 
public class BeanTest 

{ 


public static void main(Stringf] args)throws Exception 

{ 
//CLASSPATH 路 径 下 的 bean .xml 文件 创建 Resource 对 象 
ClassPathResource isr = new ClassPathResource ("bean.xml"); 
// 以 Resource 对 象 作为 参数 ， 创 建 BeanFactory 的 实例 
XmlBeanFactory factory = new XmlBeanFactory (isr); 
// 获 取 Bean 后 处 理 器 实例 
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MyBeanPostProcessor prr = factory.getBean("beanPostProcessor" 
, MyBeanPostProcessor.class); 
// 注 册 BeanPostProcessor 实例 
factory .addBeanPostProcessor (prr) ; 
System.out.printin ("程序 已经 实例 化 BeanFactory..."); 
Person p = factory.getBean("chinese" , Person.class); 
System.out .println ("程序 中 已 经 完成 了 chinese bean 的 实例 化 .."); 
p-useAxe(); 
} 
} 


如 果 使 用 BeanFactory 作为 Spring 容器 , 则 必须 手动 注册 Bean 后 处 理 器 , 因此 程序 中 先 获 取 Bean 
后 处 理 器 实例 ,然后 手动 注册 ， 正 如 程序 中 的 两 行 粗 体 字 代 码 所 示 一 一 这 就 是 在 配置 文件 中 指定 Bean 
后 处 理 器 id 属性 的 原因 ， 使 用 BeanFactory 的 addBeanPostProcessor 即 可 注册 Bean 后 处 理 器 。 

运行 上 面 的 程序 ， 可 看 到 如 下 运行 结果 : 


Spring 执行 依赖 关系 注入 ,. 

Bean 后 处 理 器 在 初始 化 之 前 对 chinese 进行 增强 处 理 . . 
正在 执行 初始 化 方法 afterPropertiesSet... 

正在 执行 初始 化 方法 ”init,.. 

Bean 后 处 理 器 在 初始 化 之 后 对 chinese 进行 增强 处 理 . . - 


struts 2 权威 指南 铀 从 砍 染 丰 忆 

从 上 面 的 执行 结果 可 以 看 出 ,虽然 我 们 在 配置 文件 中 指定 chinese Bean 的 name 为 “依赖 注入 的 值 ” 
但 这 个 属性 值 并 没有 发 生 任 何 作用 ， 该 chinese Bean 的 name 属性 值 为 “Struts 2 权威 指南 ”一 一 这 就 
是 Bean 后 处 理 器 的 作用 。 

容器 中 一 旦 注册 了 Bean 后 处 理 器 , Bean 后 处 理 器 就 会 自动 启动 , 在 容器 中 每 个 Bean 创建 时 自动 


工作 ， 加 入 Bean 后 处 理 器 需要 完成 的 工作 。 从 上 面 执行 过 程 可 以 看 出 ，Bean 后 处 理 器 两 个 方法 的 回 
调 时 机 如 图 8.1 所 示 。 


图 8.1 Bean 后 处 理 器 两 个 方法 的 回调 时 机 


实现 BeanPostProcessor 接口 的 Bean 后 处 理 器 可 对 Bean 进行 任何 操作 ， 包 括 完 全 忽略 这 个 回调 。 
BeanPostProcessor 通常 用 来 检查 标记 接口 ， 或 者 做 如 将 Bean 包装 成 一 个 Proxy 的 事情 ，Spring 的 很 多 
工具 类 ， 就 是 通过 Bean 后 处 理 器 完成 的 。 

从 主 程序 中 看 到 ， 采 用 BeanFactory 作为 Spring 容器 时 ， 必 须 手动 注册 BeanPostProcessor; 如 果 
采用 ApplicationContext 作为 Spring 容器 ， 则 无 须 手动 注册 Bean 后 处 理 器 。ApplicationContext 可 自动 
检测 到 容器 中 的 Bean 后 处 理 器 ， 自 动 注册 。Bean 后 处 理 器 会 在 Bean 实例 创建 时 自动 启动 。 即 主 程序 
采用 如 下 代码 ， 效 果 完 全 一 样 。 

a 


public static void main (String[] args)throws Exception 
{ x 
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ApplicationContext ctx = new 
ClassPathxmlApplicationContext ("bean. xml1"); 
Person p = ctx.getBean("chinese" , Person.class); 
Pp-useAxe(); 
} 


使 用 ApplicationContext 作为 容器 ， 无 须 手动 注册 BeanPostProcessor。 因 此 如 果 需 要 使 用 Bean 后 
处 理 器 ，Spring 容器 建议 使 用 ApplicationContext， 而 不 是 BeanFactory。 


8.1.2 Bean 后 处 理 器 的 用 处 


上 一 节 介绍 了 一 个 简单 的 Bean 后 处 理 器 ， 上 面 的 Bean 后 处 理 器 负责 对 容器 中 的 Chinese Bean 进 
行 后 处 理 ， 不 管 Chinese Bean 如 何 初 始 化 ， 总 是 将 Chinese Bean 的 name 属性 设置 为 “Struts 2 权威 指 
南 ”， 这 种 后 处 理 看 起 来 作用 并 不 是 特别 大 。 

实际 中 Bean 后 处 理 器 完成 的 工作 更 加 实际 , 例如 生成 Proxy。Spring 框架 本 身 提供 了 大 量 的 Bean 
后 处 理 器 ， 这 些 后 处 理 器 负责 对 容器 中 Bean 进行 后 处 理 。 

下 面 是 Spring 提供 的 两 个 常用 的 后 处 理 器 。 

> ”BeanNameAutoProxyCreator: 根据 Bean 实例 的 name 属性， 创建 Bean 实例 的 代理 。 

> ”DefaultAdvisorAutoProxyCreator: 根据 提供 的 Advisor， 对 容器 中 所 有 的 Bean 实例 创建 代 

理 。 

上 面 提供 的 两 个 Bean 后 处 理 器 ， 都 用 于 根据 容器 中 配置 的 拦截 器 ， 创 建 代理 Bean， 代 理 Bean 

就 是 对 目标 Bean 进行 增强 、 在 目标 Bean 的 基础 上 进行 修改 得 到 的 新 Bean。 


提示 
六” “如 果 需 要 对 容器 中 菜 一 批 Bean 进行 通用 的 增强 处 理 , 则 可 以 考虑 使 用 Bean 后 处 理 器 。 | 


>》》8.1.3 容器 后 处 理 器 


除了 上 面 提供 的 Bean 后 处 理 器 外 ，Spring 还 提供 了 一 种 容器 后 处 理 器 。Bean 后 处 理 器 负责 处 理 
容器 中 的 所 有 Bean 实例 ， 而 容器 后 处 理 器 则 负责 处 理 容器 本 身 。 

容器 后 处 理 器 必须 实现 BeanFactoryPostProcessor 接口 。 实 现 该 接口 必须 实现 如 下 一 个 方法 : 

> postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) 

实现 该 方法 的 方法 体 就 是 对 Spring 容器 进行 的 处 理 , 这 种 处 理 可 以 对 Spring 容器 进行 自 定义 扩展 
当然 也 可 以 对 Spring 容器 不 进行 任何 处 理 。 


“由 于 postProcessBeanFactory 方法 只 是 对 Spring 容器 进行 后 处 理 , 它 并 不 需要 完全 赫 换 : 
Spring 容器 ， 因 此 该 方法 无 需 任 何 返 回 值 . | 

类 似 于 BeanPostProcessor，ApplicationContext 可 自动 检测 到 容器 中 的 容器 后 处 理 器 ， 并 且 自 动 注 
册 容 器 后 处 理 器 。 但 若 使 用 BeanFactory 作为 Spring 容器 ， 则 必须 手动 调用 该 容器 后 处 理 器 来 处 理 
BeanFactory 容器 。 

下 面 定义 了 一 个 容器 后 处 理 器 ， 这 个 容器 后 处 理 器 实现 BeanFactoryPostProcessor 接口 ， 但 并 未 对 
Spring 容器 进行 任何 处 理 ， 只 是 打印 出 一 行 简单 的 信息 。 

程序 清单 : codes\08\8.1\BeanFactoryPostProcessor\src\crazyitapp\uti\MyBeanFactoryPostProcessorjava 


public class MyBeanFactoryPostProcessor 
implements BeanFactoryPostProcessor 


{ 
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er 
* 重 写 该 方法 ， 对 Spring 进行 后 处 理 。 
* @param beanFactory Spring 容器 本 身 
< 
Public void postProcessBeanFactory( 
ConfigurableListableBeanFactory beanFactory) 
throws BeansException 


system.out.println ("程序 对 Spring 所 做 的 BeanFactory 的 初始 化 没有 改变 . 
System.out.println ("Spring 容器 是 : ”+ beanFactory); 


{ 


} 
} 
将 容器 后 处 理 器 作为 普通 Bean 部 署 在 容器 中 ， 如 果 使 用 ApplicationContext 作为 容器 ， 容 器 会 自 
动 调用 BeanFactoryPostProcessor 来 处 理 Spring 容器 。 但 如 果 使 用 BeanFactory 作为 Spring 容器 ， 则 必 
须 手动 调用 容器 后 处 理 器 来 处 理 Spring 容器 。 例 如 如 下 主 程序 。 
程序 清单 : codes\08\8.1\BeanFactoryPostProcessor\src\lee\BeanTest.java 
public class BeanTest 
public static void main(String[] args) 
t // 以 ApplicationContex 作为 Spring 容器 
// 它 会 自动 注册 容器 后 处 理 器 、Bean 后 处 理 器 
ApplicationContext ctx = new 
ClassPathxmlApplicationContext ("bean. xml") ; 
Person p = (Person)ctx.getBean("chinese"); 
Pp-useAxe(); 
上 
} 
上 面 的 程序 中 粗 体 字 代码 使 用 了 ApplicationContext 作为 Spring 容器 ， 那 么 该 Spring 容器 会 自动 
搜索 容器 中 所 有 实现 了 BeanPostProcessor 接口 的 类 ， 并 将 它 注册 成 容器 后 处 理 器 ; 它 也 会 自动 搜索 容 
器 中 所 有 实现 了 BeanFactoryPostProcesor 接口 的 类 ， 并 将 它 注册 成 Bean 后 处 理 器 。 
实现 BeanFactoryPostProcessor 接口 的 容器 后 处 理 器 不 仅 可 对 BeanFactory 执行 后 处 理 ， 也 可 以 对 
ApplicationContext 容器 执行 后 处 理 。 容 器 后 处 理 器 还 可 用 来 注册 额外 的 属性 编辑 器 。 
二 
re 注意 :ww 
Spring 没有 提供 ApplicationContextPostProcessor. 也 就 是 说 , 对 于 ApplicationContext 可 


容器 ， 一 样 使 用 BeanFactoryPostProcessor 作为 容器 后 处 理 器 。 


Spring 已 提供 如 下 几 个 常用 的 容器 后 处 理 器 。 

> ”PropertyPlaceholderConfigurer: 属性 占 位 符 配置 器 。 

> ”PropertyOverrideConfigurer: 重 写 占 位 符 配置 器 。 

> CustomAutowireConfigurer: 自 定义 自动 装配 的 配置 器 。 

> CustomScopeConfigurer: 自 定 义 作用 域 的 配置 器 。 

从 上 面 的 介绍 可 以 看 出 ， 容 器 后 处 理 器 通常 用 于 对 Spring 容器 进行 处 理 ， 并 且 总 是 在 容器 实例 化 
任何 其 他 的 Bean 之 前 ， 读 取 配置 文件 的 元 数据 ， 并 有 可 能 修改 这 些 元 数据 。 

如 果 有 和 需要， 程序 可 以 配置 多 个 容器 后 处 理 器 ， 多 个 容器 后 处 理 器 可 设置 order 属性 来 控制 容器 
BS 


和 汪 划 。 “en 
为 了 给 容器 后 处 理 器 指定 order 属性 ， 则 要 求 容器 后 处 理 器 必须 实现 Ordered 接口 ， 
因此 在 实现 EPP OP es 时 ， 就 应 当 考虑 实现 Ordered 接口 。 bd 
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容器 后 处 理 器 的 作用 域 范围 是 容器 级 ， 它 只 是 对 容器 本 身 进 行 处 理 ， 而 不 是 对 容器 中 的 Bean 进 
行 处 理 ; 如 果 需 要 对 容器 中 的 Bean 实例 进行 后 处 理 ， 则 应 该 考虑 使 用 Bean 后 处 理 器 ， 而 不 是 使 用 容 
器 后 处 理 器 。 


》>>8.1.4 属性 占 位 符 配置 器 


Spring 提供 了 PropertyPlaceholderConfigurer， 它 是 一 个 容器 后 处 理 器 ， 负 责 读 取 Properties 属性 文 
件 里 的 属性 值 ， 并 将 这 些 属性 值 设置 成 Spring 配置 文件 的 元 数据 。 

通过 使 用 PropertyPlaceholderConfigurer 后 处 理 器 , 可 以 将 Spring 配置 文件 中 的 部 分 元 数据 放 在 属 
性 文件 中 设置 ， 这 种 配置 方式 当然 有 其 优势 :可 以 将 部 分 相似 的 配置 (比如 说 数据 库 的 URL、 用 户 名 
和 密码 ) 放 在 特定 的 属性 文件 中 ， 如 果 只 需要 修改 这 部 分 配置 ， 则 无 须 修改 Spring 配置 文件 ， 修 改 属 
性 文件 即 可 。 

下 面 的 配置 文件 配置 了 PropertyPlaceholderConfigurer 后 处 理 器 ， 在 配置 数据 源 Bean 时 ， 使 用 了 
属性 文件 中 的 属性 值 。 

程序 清单 :codes\08\8.1\PropertyPlaceholderConfiguren\src\bean.xml 


<?xml version="1,0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0,xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance”" 
xmlns="http://www. springframework. org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- PropertyPlaceholderConfigurer 是 一 个 Bean 后 处 理 器 ， 它 会 读 取 
属性 文件 信息 ， 并 将 这 些 信息 设置 成 Spring 配置 文件 的 元 数据 。 --> 
<bean class= 
"org. springframework.beans. factory.config. PropertyPlaceholderConfigurer"> 
<property name="locations"> 
<list> 
<value>dbconn .properties</value> 
<!-- 如 果 有 多 个 属性 文件 , 依次 在 下 面 列 出 
<!--value>wawa.properties</value-—> 
</list> 
</property> 
</bean> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"> 
<!-- 指定 连接 数据 库 的 驱动 ~-> 
<property nane="driverClass" value="${jdbc.driverclassName}"/> 
ee 指定 连接 数据 库 的 ORL = 
<property name=' 1" value="${jdbe.url}"/> 
二 0 = 
<property name="user" value="${jdbc.username}"/> 
<!-- 指定 连接 数据 库 的 密码 --> 
<property name="password" value="${jdbe.password}"/> 


</bean> 
</beans> 


在 上 面 的 配置 文件 中 ， 配 置 driverClass、jdbcUrl 等 信息 时 ， 并 未 直接 设置 这 些 属性 的 属性 值 ， 而 
是 设置 了 ${jdbe.driverClassName} 和 S${jdbc.url} 属 性 值 , 这 表明 Spring 容器 将 从 propertyConfigurer 指定 
属性 文件 中 搜索 这 些 key 对 应 的 value， 并 为 该 Bean 的 属性 值 设置 这 些 value 值 。 

如 前 所 述 ，ApplicationContext 会 自动 检测 部 署 在 容器 中 的 容器 后 处 理 器 ， 无 须 额外 注册 ， 容 器 会 
自动 检测 并 注册 Spring 中 的 容器 后 处 理 器 。 因 此 ， 只 需 提 供 如 下 Properties 文件 。 

程序 清单 : codes\08\8.1\PropertyPlaceholderConfigurer\src\dbconn.properties 


jdbc.driverclassName=com.mysql. jdbe. Driver 
jdbc.url=jdbc:mysql://localhost:3306/javaee 
jdbc .username=root 
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jdbc.password=32147 

通过 这 种 方法 ,可 从 主 XML 配置 文件 中 分 离 出 部 分 配置 信息 。 如 果 仅 需 要 修改 数据 库 连接 属性 ， 
则 无 须 修改 主 XML 配置 文件 ， 只 需要 修改 该 属性 文件 即 可 。 采 用 属性 占 位 符 的 配置 方式 ， 可 以 支持 
使 用 多 个 属性 文件 ， 通 过 这 种 方式 ， 可 将 配置 文件 分 割 成 多 个 属性 文件 ， 从 而 降低 修改 配置 文件 产生 
错误 的 风险 。 


二 

-本 -注意 : - 
对 于 数据 库 连 接 等 信息 集中 的 配置 ， 可 以 将 其 配置 在 Properties 属性 文件 中 ， 但 不 

要 过 多 地 将 Spring 配置 信息 抽 离 到 Properties 属性 文件 中 ， 这 样 可 能 会 降低 Spring 配置 要 


文件 的 可 


对 于 采用 基于 XML Schema 的 配置 文件 而 言 ， 如 果 导入 了 context Schema， 则 可 采用 如 下 方式 来 


配置 该 属性 占 位 符 。 


<!-- location 指定 Properties 文件 的 位 置 --> 
<context:property-placeholder location="classpath:db.properties"/> 


>>8.1.5 重 写 占 位 符 配 置 器 


PropertyOverrideConfigurer 是 Spring 提供 的 另 一 个 容器 后 处 理 器 ， 这 个 后 处 理 器 的 作用 比 上 面 那 
个 容器 后 处 理 器 的 功能 更 加 强大 :PropertyOverrideConfigurer 的 属性 文件 指定 的 信息 可 以 直接 覆盖 
Spring 配置 文件 中 的 元 数据 , 即 : PropertyOverrideConfigurer 允许 XML 配置 文件 中 有 默认 的 配置 信息 。 

如 果 PropertyOverrideConfigurer 的 属性 文件 指定 了 一 些 配置 的 元 数据 ， 则 这 些 配 置 的 元 数据 将 会 
绪 盖 原 配置 文件 里 相应 的 数据 ;在 这 种 情况 下 ， 我 们 可 以 认为 Spring 配置 信息 是 XML 配置 文件 和 属 
性 文件 的 总 和 ， 当 XML 配置 文件 和 属性 文件 指定 的 元 数据 不 一 致 时 ， 属 性 文件 的 信息 取胜 。 

使 用 PropertyOverrideConfigurer 的 属性 文件 ， 每 条 属性 应 保持 如 下 的 格式 : 


beanName .property™=value 


beanName 是 属性 占 位 符 试图 覆盖 的 Bean 名 ，property 是 试图 覆盖 的 属性 名 。 看 如 下 配置 文件 。 
程序 清单 :codes\08\8.1\PropertyOverrideConfigurer\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 

<!1-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- PropertyOverrideConfigurer 是 一 个 Bean 后 处 理 器 ， 它 会 读 取 
属性 文件 信息 ， 并 用 这 些 信息 设置 币 盖 Spring 配置 文件 的 元 数据 --> 
<bean class= 
"org .springframework.beans .factory.config. PropertyOverrideConfigurer"> 

<property name="locations"> 


<list> 
<value>dboonn .properties</val 
<!-- 如 果 有 多 个 属性 文件 , 依次 在 下 而 列 出 来--> 
</list> 
‘</property> 


</bean> 
“<!-- 定义 数据 源 Bean， 使 用 C3P9 数据 源 实现 ， 
配置 该 Bean 时 没有 指定 任何 信息 ， 但 Properties 文件 里 的 
信息 将 会 直接 覆盖 该 Bean 的 属性 值 -~-> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"/> 
</beans> 


上 面 的 配置 文件 中 配置 数据 源 Bean 时 ， 没 有 指定 任何 属性 值 ， 很 明显 配置 数据 源 Bean 时 不 指定 
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有 效 信息 是 无 法 连接 到 数据 库 服务 的 。 

但 因为 Spring 容器 中 部 署 了 一 个 PropertyOverrideConfigurer 的 容器 后 处 理 器 , 而且 Spring 容器 使 
用 ApplicationContext 作为 容器 , 它 会 自动 检测 容器 中 的 容器 后 处 理 器 , 并 使 用 该 容器 后 处 理 器 来 处 理 
Spring 容器 。 

PropertyOverrideConfigurer 后 处 理 器 读 取 dbconn.properties 文件 中 的 属性 ， 用 于 米 盖 目标 Bean 的 
属性 。 因 此 ， 如 果 属 性 文件 中 有 dataSource Bean 属性 的 设置 ， 则 可 在 配置 文件 中 为 该 Bean 指定 属性 
值 ， 这 些 属性 值 将 会 覆盖 dataSource Bean 的 各 属性 值 。 

dbconn .properties 属性 文件 如 下 。 

程序 清单 :codes\08\8.1\PropertyOverrideConfigurer\src\dbconn.properties 


datasource.driverClass=com.mysql.jdbc.Driver 
datasource. jdbcUrl=jdbc:mysql://localhost:3306/javaee 
dataSource.user=root 

datasource.password=32147 


属性 文件 里 每 条 属性 的 格式 必须 是 : 
beanName .property=value 


也 就 是 说 ，dataSource 必须 是 容器 中 真实 存在 的 bean 名 ， 否 则 程序 将 出 错 。 


-着 - 注意 : 

程序 无 法 知道 BeanFactory 定义 是 否 被 禾 盖 。 仅仅 通过 查看 XML 配置 文件 , 无 法 知 i 
道 配置 文件 的 配置 信息 是 否 被 覆盖 。 如 有 多 个 PorpertyOverrideConfigurer 对 同一 Bean 
属性 进行 了 禾 盖 ， 最 后 一 次 禾 盖 将 会 获胜 . 


采用 基于 XML Schema 的 配置 文件 而 言 ， 
配置 这 种 重 写 占 位 符 ; 


<!-- location 指定 Properties 文件 的 位 置 --> 
<context:property-override location="classpath:db.properties"/> 


8.2 Spring 的 “ 零 配置 ”支持 


在 曾经 的 岁月 里 ，Java 和 XML 是 如 此 “恩爱 ”， 许 多 人 认为 Java 是 跨 平台 的 语言 ， 而 XML 是 跨 
平台 的 数据 交换 格式 ， 所 以 Java 和 XML 应 该 是 天 作 之 合 。 在 这 种 潮流 下 ， 以 前 的 Java 框架 不 约 而 同 
地 选择 了 XML 作为 配置 文件 。 

时 至 今日 ， 也 许 是 受 Rails 框架 的 启发 ， 现 在 的 Java 框架 又 都 开始 对 XML 配置 方式 “弃置 不 顾 ” 
了 ， 儿 乎 所 有 主流 Java 框架 都 打算 支持 “ 零 配置 ”特性 了 ， 包 括 前 面 介绍 的 Struts 2、Hibernate， 以 
及 现在 要 介绍 的 Spring， 都 开始 支持 使 用 Annotation 来 代替 XML 配置 文件 了 。 


>>8.2.1 搜索 Bean 类 


如 果 导 入 了 context Schema， 则 可 采用 如 


既然 我 们 不 再 使 用 Spring 配置 文件 来 配置 任何 Bean 实例 ， 那 么 我 们 只 能 指望 Spring 会 自动 搜索 
某 些 路 径 下 的 Java 类 ， 并 将 这 些 Java 类 注册 成 Bean 实例 。 


提示 :… 一 … 一 … 一 … 一 … 一 … 一 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
Fen Rails 框架 的 处 理 比较 简单 ， 它 采用 一 种 所 谓 的 “约定 优 于 配置 ”的 方式 ， 它 要 求 将 不 同 组 

件 放 在 不 同 路 径 下 ， 而 Rails 框架 中 是 加 载 国定 路 径 下 的 所 有 组 件 。 | 

Spring 没有 采用 “约定 优 于 配置 ”的 策略 , Spring 依然 要 求 程序 员 显 式 指定 搜索 哪些 路 径 下 的 Java 
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类 ，Spring 将 会 把 合适 的 Java 类 全 部 注册 成 Spring Bean。 那 现在 的 问题 是 : Spring 怎么 知道 应 该 把 哪 
些 Java 类 当成 Bean 类 处 理 呢 ? 这 就 需要 使 用 Annotation 了 ，Spring 通过 使 用 一 些 特殊 的 Annotation 
来 标注 Bean 类 。Spring 提供 了 如 下 几 个 Annotation 来 标注 Spring Bean。 

> ”@Component; 标注 一 个 普通 的 Spring Bean 类 。 

> ”@Controller: 标注 一 个 控制 器 组 件 类 。 

> @Service: 标注 一 个 业务 逻辑 组 件 类 。 

> ”@Repository: 标注 一 个 DAO 组 件 类 。 

如 果 我 们 需要 定义 一 个 普通 的 Spring Bean， 则 直接 使 用 @Component 标注 即 可 。 但 如 果 用 
@Repository、@Service 或 @Controller 来 标注 这 些 Bean 类 ， 这 些 Bean 类 将 被 作为 特殊 的 Java EE 组 
件 对 待 ， 也 许 能 更 好 地 被 工具 处 理 ， 或 与 切面 进行 关联 。 例 如 ， 这 些 典 型 化 Annotation 可 以 成 为 理想 
的 切入 点 目标 。 

在 Spring 未 来 的 版 本 中 ，@Controller、@Service 和 @Repository 也 许 还 能 携带 更 多 语义 ， 因 此 ， 
如 果 需 要 在 Java EE 应 用 中 使 用 这 些 标注 时 , 尽量 考虑 使 用 @Controller、@Service 和 @Repository 来 代 
替 通用 的 @Component 标注 。 

指定 了 某 些 类 可 作为 Spring Bean 类 使 用 后 ,最 后 还 需要 让 Spring 搜索 指定 路 径 ,此 时 需要 在 Spring 
配置 文件 中 导入 context Schema， 并 指定 一 个 简单 的 搜索 路 径 。 

下 面 我 们 定义 了 一 系列 Java 类 ， 并 使 用 @Component 来 标注 它们 。 
程序 清单 : codes\08\8.2\Component\src\org\crazyit\app\service\impl\Chinese.java 
@Component 


public class Chinese 
implements Person 


{ 
private Axe axe; 
// 设 值 注入 所 需 的 setter 方法 
public void setAxe (Axe axe) 
{ 
this.axe = axe; 


} 
// 省 略 其 他 方法 
5 


程序 清单 : codes\08\8.2\Component\src\org\crazyit\app\service\impl\SteelAxe.java 


QComponent 

public class SteelAxe 
implements Axe 

{ 
public String chop() 


{ 
return “ 钢 着 砍 此 真 快 "7 
) 
} 


程序 清单 :codes\08\8.2\Component\src\org\crazyit\app\service\impl\StoneAxe.java 
@Component 
public class StoneAxe 

implements Axe 


{ 
public String chop() 


return " 石 逢 砍 柴 好 慢 "; 
} 
} 


这 些 Java 类 与 前 面 介绍 的 Bean 类 没有 太 大 区 别 ， 只 是 每 个 Java 类 都 使 用 了 @Component 标注 ， 
这 表明 这 些 Java 类 都 将 作为 Spring 的 Bean 类 。 
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接 下 来 需要 在 Spring 的 配置 文件 中 指定 搜索 路 径 ，Spring 将 会 自动 搜索 该 路 径 下 的 所 有 Java 类 ， 
并 根据 这 些 Java 类 来 创建 Bean 实例 。 本 应 用 的 配置 文件 如 下 。 
程序 清单 :codes\08\8.2\Component\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:context="http://wmw.springframework.org/schema/context" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd 


http://www. epring?remework. org/schema/context/spring-context-3.0.xsd"> 
<!-- 自动 扫描 指定 包 及 其 子 包 下 的 所 有 Bean 类 -> 
<context:component-scan 
base-package="org. crazyit.app. service"/> 
</beans> 
上 面 的 配置 文件 中 最 后 一 行 粗 体 字 代 码 指定 Spring 将 会 把 org.crazyit.app.service 包 及 其 子 包 的 所 
有 Java 类 都 当成 Spring Bean 来 处 理 , 并 为 每 个 Java 类 创建 对 应 的 Bean 实例 。 经 过 上 面 的 步骤 , Spring 
容器 中 自动 就 会 增加 三 个 Bean 实例 (前 面 定义 的 三 个 类 都 是 位 于 org.crazyit.app.service.impl 包 下 的 )。 
主 程序 如 下 。 
程序 清单 :codes\08\8.2\Component\src\lee\BeanTest.java 


public class BeanTest 
{ 
public static void main(string[] args) 
{ 


// 创 建 Spring 容器 

ApplicationContext ctx = new 
ClassPathXmlApplicationContext ("bean.xml"); 

// 获 取 Spring 容器 中 的 所 有 Bean 实例 的 名 

System.out.println("-------------- 十 
java.util.Arrays.tostring (ctx.getBeanDefinitionNames ())); 

} 
} 


上 面 的 程序 中 粗 体 字 代 码 输出 了 Spring 容器 中 所 有 Bean 实例 的 名 称 ， 运 行 上 面 的 程序 ， 将 看 到 
如 下 输出 结果 : 
-------------- [chinese, steelAxe, stoneAxe, org.springframework.context.annotation 
.internalconfigurationAnnotationProcessor, org.springframework 
.context.annotation.internalAutowiredAnnotationProcessor 
, org.springframework.context.annotation. internalRequiredAnnotationPprocessor 
+ org.springframework.context.annotation. internalCommonAnnotationProcessor] 


从 上 面 的 运行 结果 可 以 看 出 ，Spring 容器 中 三 个 Bean 实例 的 名 称 分 别 为 chinese、steelAxe 和 
stoneAxe， 那 么 这 些 名 称 是 从 哪里 来 的 呢 ? 在 基于 XML 配置 方式 下 ， 每 个 Bean 实例 的 名 称 都 由 其 id 
属性 指定 ; 在 这 种 基于 Annotation 的 方式 下 ，Spring 采用 约定 的 方式 来 为 这 些 Bean 实例 指定 名 称 ， 这 
些 Bean 实例 的 名 称 默 认 是 Bean 类 的 首 字母 小 写 ， 其 他 部 分 不 变 。 

当然 ，Spring 也 允许 在 使 用 @Component 标注 时 指定 Bean 实例 的 名 称 ， 例 如 如 下 代码 片段 ; 

// 指 定 该 类 作为 Spring Bean，Bean 实例 名 为 axe 

component ("axe") 

public class SteelAxe implements Axe 

{ 


) 
上 面 的 程序 中 粗 体 字 代码 指定 该 Bean 实例 的 名 称 为 axe。 
在 默认 情况 下 ，Spring 会 自动 搜索 所 有 以 @Component、@Controller、@Service 和 @Repository 标 
注 的 Java 类 ， 并 将 它们 当成 Spring Bean 来 处 理 。 
除 此 之 外 ， 我 们 还 可 通过 为 <component-scan... 人 > 元 素 添加 <include-filter.. 广 或 <exclude-filter.. 人 > 子 
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元 素来 指定 Spring Bean 类 ， 只 要 位 于 指定 路 径 下 的 Java 类 满足 这 种 规则 ， 即 使 这 些 Java 类 没有 使 用 
任何 Annotation 标注 ，Spring 一 样 会 将 它们 当成 Bean 类 来 处 理 。 

<include-filter.. 人 > 元 素 用 于 指定 满足 该 规则 的 Java 类 会 被 当成 Bean 类 处 理 ，<exclude-filter.…/> 指 
定 满足 该 规则 的 Java 类 不 会 被 当成 Bean 类 处 理 。 使 用 这 两 个 元 素 时 都 要 求 指定 如 下 两 个 属性 。 

> type: 指定 过 滤器 类 型 。 

> ”expression: 指定 过 滤器 所 需要 的 表达 式 。 


Spring 内 建 支持 如 下 4 种 过 滤器 。 
> annotation : Annotation 过 滤器 ， 该 过 滤器 需要 指定 一 个 Annotation 名 ， 如 
lee.AnnotationTest。 


> assignable: 类 名 过 滤器 ， 该 过 滤器 直接 指定 一 个 Java 类 。 
> ”regex: 正则 表达 式 过 滤器 ， 该 过 滤器 指定 一 个 正则 表达 式 ， 匹 配 该 正则 表达 式 的 Java 类 将 
满足 该 过 滤 规 则 ， 如 org\.example\.Default.*。 
> aspectj: AspectJ 过 滤器 ， 如 org.example..*Service+。 
例如 , 下面 配置 文件 指定 所 有 以 Chinese 结尾 的 类 、 以 Axe 结尾 的 类 都 将 被 当成 Spring Bean 处 理 。 
程序 清单 :codes\08\8.2\filter-scan\src\bean.xml 
<?xml version="1.0" encoding="GBK"?> 
<beans xmins="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:context="http://www. springframework.org/schema/context" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://wuu. springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www. springframework.org/schema/context 
http://wuw. springframework.org/schema/context/spring-context-3.0,xsd"> 
<!--~ 自动 扫描 指定 包 及 其 子 包 下 的 所 有 Bean 类 --> 
<context :component-scan 
base-package="org. crazyit .app. service"> 
<!-- 只 包含 以 Chinese、Axe 结尾 的 类 --> 
<context:include-filter type="regex" 
expression=" .*Chinese"/> 
<context:include-filter type="regex" 
expression=". *Axe"/> 
</context:component-scan> 
</beans> 


> >8.2.2 指定 Bean 的 作用 域 


当 使 用 XML 配置 方式 来 配置 Bean 实例 时 ， 可 以 通过 scope 来 指定 Bean 实例 的 作用 域 ， 没 有 指 
定 scope 属性 的 Bean 实例 的 作用 域 默 认 是 singleton。 
当 我 们 采用 零 配置 方式 来 管理 Bean 实例 时 ， 可 使 用 @Scope Annotation， 只 要 在 该 Annotation 中 
提供 作用 域 的 名 称 即 可 。 例 如 ， 我 们 可 以 定义 如 下 Java 类 : 
// 指 定 该 Bean 实例 的 作用 域 为 Prototype 
escope ("prototype") 
// 指 定 该 类 作为 Spring Bean，Bean 实例 名 为 axe 
ecomponenE ("axe") 
public class SteelAxe implements Axe 
{ 


} 

在 一 些 极端 的 情况 下 ， 我 们 不 想 使 用 基于 Annotation 的 方法 来 指定 作用 域 ， 而 是 希望 提供 自 定义 
的 作用 域 解析 器 ， 让 自 定义 的 解析 器 实现 ScopeMetadataResolver 接口 ， 并 提供 自 定义 的 作用 域 解析 策 
略 ， 然 后 在 配置 扫描 器 时 指定 解析 器 的 全 限定 类 名 即 可 。 看 如 下 配置 片段 : 


<beans ...> 
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<context:component-scan base-package="org.crazyit .app" 
scope-resolver="org.craryit.app.util .MyScopeResolver"/> 


</beans> 
>》>8.2.3 使 用 @Resource 配置 依赖 


@Resource 位 于 java.annotation 包 下 ， 是 来 自 Java EE 规范 的 一 个 Annotation，Spring 直接 借鉴 了 
该 Annotation， 通 过 使 用 该 Annotation 为 目标 Bean 指定 协作 者 Bean。 


提示 :一 一 一 一 一 一 一 一 一 
关于 @Resource Annotation 的 详细 用 法 ,读者 可 以 参考 本 书 的 姊妹 篇 《经 典 Java EE 企 
业 应 用 实战 》 那 本 书 中 有 @Resource 及 Java EE 规范 中 依赖 注入 的 介绍 。 | 


@Resource 有 一 个 name 属性 ， 在 默认 情况 下 ，Spring 将 这 个 值 解释 为 需要 被 注入 的 Bean 实例 的 
名 字 。 换 名 话说， 使 用 @Resource 与 <property.…/> 元 素 的 ref 属性 有 相同 的 效果 。 例 如 如 下 的 Bean 类 。 
程序 清单 ，codes\08\8.2\Resource\src\org\crazyit\app\service\impl\Chinese.java 


QComponent 
public class Chinese 
implements Person 
{ 
private Axe axe; 
// 设 值 注入 所 种 的 setter 方法 
Resource (name="stoneAxe") 
public void setAxe (Rxe axe) 
{ 
this.axe = axe; 


} 

// 实 现 Person 接口 的 useAxe 方法 

public void useAxe() 

{ 
// 调 用 axe 的 chop () 方法 ， 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System.out .println (axe.chop()); 

9 


上 面 的 Chinese 类 中 粗 体 字 代 码 定义 了 一 个 @Resource Annotation， 该 Annotation 指定 将 stoneAxe 
注入 该 setAxe0 方 法 ， 也 就 是 将 容器 中 的 stoneAxe Bean 作为 setAxe() 方 法 的 参数 传 入 。 

@Resource 不 仅 可 以 修饰 setter 方法 ， 也 可 以 直接 修饰 Field， 使 用 @Resource 时 还 可 省 略 name 
属性 。 如 果 使 用 @Resource 修饰 Field 将 会 更 加 简单 ， 此 时 Spring 将 会 直接 使 用 Java EE 规范 的 Field 
注入 ， 此 时 连 setter 方法 都 可 以 不 要 。 例 如 将 上 面 Chinese 类 改 为 如 下 : 

ecomponent 
public class Chinese 
implements Person 

BResource (name="stoneAxe") 

private Axe axe; 


// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 


{ 
// 调 用 axe 的 chop () 方 法 ， 
// 表 明 Person 对 象 依赖 于 axe 对 象 


System.out.println(axe.chop()); 
} 


当 使 用 @Resource 修饰 setter 方法 时 ， 如 果 省 略 name 属性 ， 则 name 属性 默认 是 该 setter 方法 去 
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掉 前 面 的 set 子 串 、 首 字母 小 写 后 得 到 的 子 串 。 例 如， 使 用 @Resource 标注 setName() 方 法 ， 则 Spring 
默认 会 注入 容器 中 名 为 name 的 组 件 。 

当 使 用 @Resource 修饰 Field 时 ， 如 果 省 略 name 属性 ， 则 name 属性 默认 与 该 Field 同名 。 例 如 ， 
使 用 @Resource 标注 name Field， 则 Spring 默认 会 注入 容器 中 名 为 name 的 组 件 。 


》>8.2.4 使 用 @PostConstruct 和 @PreDestroy 定制 生命 周期 行为 


@PostConstruct 和 @PreDestroy 同样 位 于 java.annotation 包 下 ， 也 是 来 自 Java EE 规范 的 两 个 
Annotation，Spring 直接 借鉴 了 它们 ， 用 于 定制 Spring 容器 中 Bean 的 生命 周期 行为 。 

前 面 介 绍 Spring 生命 周期 时 提供 了 <bean... 人 > 元 素 可 以 指定 init-method、destroy-method 两 个 属性 : 

> init-method 指定 Bean 的 初始 化 方法 一 一 Spring 容器 将 会 在 Bean 的 依赖 关系 注入 完成 后 回 


调 该 方法 。 
> ”destroy-method 指定 Bean 销毁 之 前 的 方法 一 一 Spring 容器 将 会 在 销毁 该 Bean 之 前 回调 该 
方法 。 


而 @PostConstruct 和 @PreDestroy 两 个 Annotation 的 作用 大 致 与 此 相似 , 它们 都 用 于 修饰 方法 , 无 
需 任何 属性 。 其 中 前 者 修饰 的 方法 是 Bean 的 初始 化 方法 ; 而 后 者 修饰 的 方法 是 Bean 销毁 之 前 的 方法 。 

例如 如 下 Bean 实现 类 。 

程序 清单 :codes\08\8.2\lifecycle\src\org\crazyit\app\service\limpl\Chinese.java 


QComponent 
public class Chinese 
implements Person 
{ 
// 执 行 Field 注 入 
@Resource (name="steelAxe") 
private Axe axe; 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 
{ 


// 调 用 axe 的 chop () 方法 ， 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System.out.println (axe.chop()); 


} 
QPostConstruct 
public void init() 


{ 
System.out .println(" 正 在 执行 初始 化 的 init 方法 . .."); 
} 


@PreDestroy 
public void close() 


{ 
System,out.println(" 正 在 执行 销毁 之 前 的 close 方法 . . ."); 
} 
} 


上 面 Chinese 中 使 用 了 @PostConstruct 修饰 init0 方 法 , 这 就 让 Spring 在 该 Bean 的 依赖 关系 注入 
完成 之 后 回调 该 方法 ; 使 用 了 @PreDestroy 修饰 close0 方 法 ， 这 就 让 Spring 在 销毁 该 Bean 之 前 回调 
该 方法 。 

》>>8.2.5 Spring 3.0 新 增 的 Annotation 


Spring 3.0 再 次 增加 了 两 个 Annotation: @DependsOn 和 @Lazy， 其 中 @DependsOn 用 于 强制 初始 
化 其 他 Bean， 而 @Lazy 则 用 于 指定 该 Bean 是 否 取消 预 初始 化 。 
@DependsOn 可 以 修饰 Bean 类 或 方法 ， 使 用 该 Annotation 时 可 以 指定 一 个 字符 串 数组 作为 参数 ， 
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每 个 数组 元 素 对 应 于 一 个 强制 初始 化 的 Bean。 如 以 下 代码 所 示 : 
epependson ({"steelAxe" , "abc"}) 
@Component 
public class Chinese 
implements Person 
{ 


} 


上 面 的 代码 使 用 了 @DependsOn 修饰 Chinese 类 ， 这 就 指定 在 初始 化 Chinese Bean 之 前 ， 会 强制 
初始 化 steelAxe、abc 两 个 Bean。 
@Lazy 主要 用 于 修饰 Spring Bean 类 ， 用 于 指定 该 Bean 的 预 初始 化 行为 ， 使 用 该 Annotation 时 可 
指定 一 个 boolean 型 的 value 属性 ， 该 属性 决定 是 否 要 预 初始 化 该 Bean。 
例如 如 下 代码 : 


QLazy (true) 

QComponent 

public class Chinese 
implements Person 

{ 


% 
上 面 的 粗 体 字 Annotation 指定 当 Spring 容器 初始 化 时 ， 不 会 预 初始 化 Chinese Bean。 


》》>8.2.6 自动 装配 和 精确 装配 


Spring 提供 了 @Autowired Annotation 来 指定 自动 装配 ， 使 用 @Autowired 可 以 标注 setter 方法 、 普 
通 方法 、Field 和 构造 器 等 。 

例如 下 面 的 代码 : 

@Component 


public class Chinese implements Person 
{ 


// 设 值 注入 所 需 的 setter 方法 
BAutowired 
public void setAxe (Axe axe) 
{ 

this.axe = axe; 
} 


了 

上 面 的 代码 中 使 用 了 @Autowired 指定 对 setAxe( 方 法 进行 自动 装配 ，Spring 将 会 自动 搜索 容器 中 
类 型 为 Axe 的 Bean 实例 ,并 将 该 Bean 实例 作为 setAxe() 方 法 的 参数 传 入 , 由 此 可 见 , 当 使 用 @Autowired 
标注 setter 方法 时 ， 默 认 采 用 的 是 byType 的 自动 装配 策略 。 

Spring 允许 使 用 @Autowired 来 标注 多 个 参数 的 普通 方法 ， 如 下 面 的 代码 所 示 : 


component 
public class Chinese implements Person 
{ 
// 可 接受 多 个 参数 的 普通 方法 
GAutowired 
Public void prepare (Axe axe , Dog dog) 
{ 


this.axe = axe; 


this.dog = dog; 
} 
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@Autowired 也 可 用 于 标注 构造 器 和 Field， 如 下 面 的 代码 所 示 : 


QComponent 
public class Chinese implements Person 


{ 


public Chinese (Axe axe , Dog dog) 
{ 


this.axe = axe; 
this.dog = dog; 
} 
es 
当 使 用 @Autowired 来 标注 一 个 Field 时 ，Spring 将 会 把 容器 中 与 该 Field 类 型 匹配 的 Bean 注入 该 
属性 ， 例 如 程序 中 使 用 @AutoWired 标注 了 private Axe axe， 则 Spring 会 自动 搜索 容器 中 的 Axe 实例 ， 
并 将 该 实例 设置 成 该 axe Field 的 值 ， 如 果 容 器 中 包含 多 于 一 个 的 Axe 实例 ， 则 Spring 容器 会 她 出 一 
个 BeanCreateException 异常 。 
@Autowired 甚至 可 以 用 于 修饰 数组 类 型 的 Field， 如 下 面 的 代码 所 示 : 
ecomponent 
public class Chinese implements Person 
QAutowired 
Private Axe[] axes; 
Re 
正如 在 上 面 的 程序 中 看 到 的 , 被 @Autowired 修饰 的 axes 属性 是 Axe[] 数 组 , 在 这 种 情况 下 , Spring 
会 自动 搜索 容器 中 的 所 有 Axe 实例 ， 并 以 这 些 Axe 实例 作为 数组 元 素来 创建 数组 ， 最 后 将 该 数组 赋 给 
上 面 Chinese 实例 的 axes 属性 。 
与 此 类 似 的 是 ，@Autowired 也 可 标注 集合 Field， 或 标注 形 参 类 型 是 集合 的 方法 ，Spring 对 这 种 
集合 属性 、 集 合 形 参 的 处 理 与 前 面 数 组 类 型 的 处 理 是 完全 相同 的 。 例 如 如 下 代码 : 


ecomponent 
public class Chinese implements Person 
{ 

private Set<Axe> axes; 

BAutowired 

Public void setAxes (Set<Axe> axes) 

{ 


this.axes = axes; 

和 

对 于 这 种 集合 类 型 的 参数 而 言 ， 程 序 代 码 中 必须 使 用 泛 型 ， 正 如 上 面 的 程序 中 粗 体 字 代码 所 示 ， 
程序 指定 了 该 方法 参数 是 Set<Axe> 类 型 ， 这 表明 Spring 会 自动 搜索 容器 中 所 有 Axe 实例 ， 并 将 这 些 
实例 注入 到 axes 属性 中 。 如 果 程 序 没有 使 用 泛 型 来 指明 集合 元 素 的 类 型 ， 则 Spring 将 会 不 知 所 措 。 

正如 上 面 看 到 的 ，@Autowired 总 是 采用 byType 的 自动 装配 策略 ， 在 这 种 策略 下 ， 符 合 自动 装配 
类 型 的 候选 Bean 实例 常常 有 多 个 ， 这 个 时 候 就 可 能 引起 异常 了 〔 对 于 数组 类 型 参数 、 集 合 类 型 参数 
则 不 会 )。 

为 了 实现 精确 的 自动 装配 ，Spring 提供 了 @Qualifier Annotation， 通 过 使 用 @Qualifier， 人 允许 根据 
Bean 标识 来 指定 自动 装配 。 

@Qualifier 通常 可 用 于 修饰 Field， 如 下 面 的 代码 所 示 。 

程序 清单 : codes\08\8.2\Autowire\src\org\crazyit\app\service\impl\Chinese.java 

@Component 
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public class Chinese 
implements Person 
{ 
@Autowired 
QQualifier ("steelAxe") 
private Axe axe; 
// 设 值 注入 所 需 的 setter 方法 
public void setAxe(Axe axe) 
{ 
this.axe = axe; 


} 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 
{ 
// 调 用 axe 的 chop () 方 法 ， 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System.out.println(axe.chop())7 
) 
} 


上 面 的 配置 文件 中 指定 了 axe Field 将 使 用 自动 装配 ， 且 精确 指定 了 被 装配 的 Bean 实例 名 称 是 
steelAxe， 这 意味 着 Spring 将 会 搜索 容器 中 名 为 steelAxe 的 Axe 实例 ， 并 将 该 实例 注入 该 axe Field。 
除 此 之 外 ，Spring 还 允许 使 用 @Qualifier 标注 方法 的 形 参 ， 如 下 面 的 代码 所 示 : 
ecomponent 
public class Chinese 
implements Person 
private Axe axe; 
/7/ 设 值 注入 所 需 的 setter 方法 
QAutowired 
Public void setAxe (QQualifier("steelAxe") Axe axe) 
{ 


this.axe = axe; 


} 
// 实 现 Person 接口 的 useAxe 方法 
public void useAxe() 


{ 
// 调 用 axe 的 chop () 方 法 
// 表 明 Person 对 象 依赖 于 axe 对 象 
System.out .Println(axe.chop{))7 
} 
} 


上 面 的 代码 中 粗 体 字 Annotation 指明 Spring 应 该 搜索 容器 中 名 为 steelAxe 的 Axe 实例 , 并 将 该 实 
例 作为 setAxe0) 方 法 的 参数 传 入 。 


8.3 资源 访问 


正如 前 面 我 们 看 到 的 ， 创 建 Spring 容器 时 通常 需要 访问 XML 配置 文件 ， 除 此 之 外 ， 我 们 可 能 有 
大 量 地 方 需要 访问 各 种 类 型 的 文件 、 二 进 制 流 等 一 Spring 把 这 些 文件 、 二 进 制 流 等 统称 为 资源 。 

在 Sun 所 提供 的 标准 API 里 ， 资 源 访问 通常 由 javaneLURL 和 文件 IO 来 完成 ， 尤 其 是 当 我 们 需 
要 访问 来 自 网 络 的 资源 时 ， 通 常会 选择 URL 类 。 

关于 URL 类 的 用 法 ， 请 参阅 疯狂 Java 体系 的 《疯狂 Java 讲义 》 一 书 。 

URL 类 可 以 处 理 一 些 常规 的 资源 访问 问题 ,但 依然 不 能 很 好 地 满足 所 有 底层 资源 访问 的 需要 ， 比 
如 ， 暂 时 还 无 法 在 类 加 载 路 径 ， 或 相对 于 ServletContext 的 路 径 中 访问 资源 ， 虽 然 Java 允许 使 用 特定 
的 URL 前 缀 注册 新 的 处 理 类 〈 例 如 已 有 的 http: 前 缀 的 处 理 类 ), 但 是 这 样 做 通常 比较 复杂 ,而 且 URL 
接口 还 缺少 一 些 有 用 的 功能 ， 比 如 检查 所 指向 的 资源 是 否 存在 等 。 

Spring 改进 了 Java 资源 访问 的 策略 ，Spring 为 资源 访问 提供 了 一 个 Resource 接口 ， 该 接口 提供 了 
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更 强 的 资源 访问 能 力 ，Spring 框架 本 身 大 量 使 用 了 Resource 来 访问 底层 资源 。 
Resource 本 身 是 一 个 接口 ， 是 具体 资源 访问 策略 的 抽象 ， 也 是 所 有 资源 访问 类 所 实现 的 接口 。 
Resource 接口 主要 提供 了 如 下 几 个 方法 。 
> ”getinputStream(): 定位 并 打开 资源 ， 返 回 资源 对 应 的 输入 流 。 每 次 调用 都 返回 新 的 输入 流 。 
调用 者 必须 负责 关闭 输入 流 。 
> exists(): 返回 Resource 所 指向 的 资源 是 否 存在 。 
> ”isOpen(); 返回 资源 文件 是 否 打开 ， 如 果 资 源 文件 不 能 多 次 读 取 ， 每 次 读 取 结束 时 应 该 显 式 
关闭 ， 以 防止 资源 泄漏 。 
> ”getDescription(): 返回 资源 的 描述 信息 ， 用 于 资源 处 理 出 错时 输出 该 信息 ， 通 常 是 全 限定 文 
件 名 或 实际 URL。 
> ”getFile: 返回 资源 对 应 的 File 对 象 。 
> ”getURL: 返回 资源 对 应 的 URL 对 象 。 
最 后 两 个 方法 通常 无 须 使 用 ， 仅 在 通过 简单 方式 访问 无 法 实现 时 ，Resource 才 提 供 传统 的 资源 访 
问 功能 。 
Resource 接口 本 身 没有 提供 访问 任何 底层 资源 的 实现 逻辑 ， 针 对 不 同 的 底层 资源 ，Spring 将 会 提 
供 不 同 的 Resource 实现 类 ， 不 同 的 实现 类 负责 不 同 的 资源 访问 逻辑 。 


不 : 果 
Spring 的 Resource 设计 是 一 种 典型 的 策略 模式 ， 通 过 使 用 Resource 接口 ， 客 户 端 程序 ， 
在 不 同 的 资源 访问 和 中 之 同和 由 切换 ， 关 于 条 中 模式 主 大 考 本 书 和 9 章 | 
Resource 不 仅 可 在 Spring 的 项 目 中 使 用 ， 也 可 直接 作为 资源 访问 的 工具 类 使 用 。 意 思 是 说 ， 即 使 
不 使 用 Spring 框架 ， 也 可 以 使 用 Resource 作为 工具 类 ， 用 来 代替 URL。 当 然 ， 使 用 Resource 接口 会 
让 代码 与 Spring 的 接口 耦合 在 一 起 ， 但 这 种 耦合 只 是 部 分 工具 集 的 耦合 ， 不 会 造成 太 大 的 代码 污染 。 


>>8.3.1 Resource 实现 类 


Resource 接口 是 Spring 资源 访问 的 接口 ， 具 体 的 资源 访问 由 该 接口 的 实现 类 完成 。Spring 提供 了 
Resource 接口 的 大 量 实现 类 。 

> UrlIResource: 访问 网 络 资源 的 实现 类 。 
ClassPathResource: 访问 类 加 载 路 径 里 资源 的 实现 类 。 
FileSystemResource: 访问 文件 系统 里 资源 的 实现 类 。 
ServletContextResource: 访问 相对 于 ServletContext 路 径 里 的 资源 的 实现 类 。 
InputStreamResource: 访问 输入 流 资源 的 实现 类 。 

> ”ByteArrayResource: 访问 字 节 数组 资源 的 实现 类 。 

这 些 Resource 实现 类 ， 针 对 不 同 的 底层 资源 ， 提 供 了 相应 的 资源 访问 逻辑 ， 并 提供 便捷 的 包装 ， 
以 利于 客户 端 程序 的 资源 访问 。 

1 访问 网 络 资源 

访问 网 络 资源 通过 UrlResource 类 实现 ，UrlResource 是 java.net.URL 类 的 包装 ， 主 要 用 于 访问 之 
前 通过 URL 类 访问 的 资源 对 象 。URL 资源 通常 应 该 提供 标准 的 协议 前 级 。 例如: file: 用 于 访问 文件 系 
统 ，http: 用 于 通过 HTTP 协议 访问 资源 ，ftp: 用 于 通过 FTP 协议 访问 资源 等 。 

UrlResource 类 实现 Resource 接口 ， 对 Resource 全 部 方法 提供 了 实现 ， 完 全 支持 Resource 的 全 部 
API。 下 面 的 代码 示范 了 使 用 UriResource 访问 文件 系统 资源 的 示例 。 

程序 清单 : codes\08\8.3\UrlResource\src\lee\UrlResourceTest.java 


vvvyv 
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public class UrlResourceTest 
{ 
public static void main(string[] args) 
throws Exception 
{ 
7/ 创建 一 个 Resource 对 象 ， 指 定 从 文件 系统 里 读 取 资 源 
UrlResource ur = new UrlResource("file:book.xml1"); 
// 获 取 该 资源 的 简单 信息 
System.out.println (ur.getFilename ()); 
System.out .println (ur.getDescription{()); 
// 创 建 Dom4j 的 解析 器 
SAXReader reader = new SAXReader(); 
Document doc = reader.read(ur.getFile()); 
// 获 取 根 元 素 
Element el = doc.getRootElement (); 
List 1 = el.elements(); 
// 遍 历 根 元 素 的 全 部 子 元 素 
for (Iterator it = 1.iterator();it.hasNext() ; ) 


// 每 个 节点 都 是 < 书 > 节点 
Element book = (Element)it.next(); 
List 11 = book.elements(); 
// 遍 历 < 书 > 节点 的 全 部 子 节点 
for (Iterator it2 = ll.iterator();it2.hasNext() ; ) 
《 
Element eee = (Element)it2.next(); 
System.out .println (eee.getText ()); 
} 


2 
} 


上 面 的 程序 中 粗 体 字 代码 使 用 UrlResource 来 访问 本 地 磁盘 资源 ， 虽 然 UrlResource 是 为 访问 网 络 
资源 而 设计 的 ， 但 通过 使 用 file 前 缀 也 可 访问 本 地 磁盘 资源 。 如 果 需 要 访问 网 络 资源 ， 则 可 以 使 用 如 
下 两 个 常用 前 级 。 

> http: j 问 基于 HTTP 协议 的 网 络 资源 。 

> ”ftp: 一 一 该 前 级 用 于 访问 基于 FTP 协议 的 网 络 资源 。 

由 于 UrlResource 是 对 java.net.URL 的 封装 ,所 以 UrlResource 支持 的 前 组 与 URL 类 所 支持 的 前 缀 
完全 相同 。 

将 应 用 所 需 的 book.xml 访问 放 在 应 用 的 当前 路 径 下 ， 运 行 该 程序 ， 即 可 看 到 使 用 UrlResource 访 
问 本 地 磁盘 资源 的 效果 。 

2. 访问 类 加 载 路 径 下 的 资源 

ClassPathResource 用 来 访问 类 加 载 路 径 下 的 资源 ， 相 对 于 其 他 的 Resource 实现 类 ， 其 主要 优势 是 
方便 访问 类 加 载 路 径 里 的 资源 ， 尤 其 对 于 Web 应 用 ，ClassPathResource 可 自动 搜索 位 于 
WEB-INF/classes 下 的 资源 文件 ， 无 须 使 用 绝对 路 径 访问 。 

下 面 示例 程序 示范 了 将 book.xml 放 在 类 加 载 路 径 下 ， 然 后 使 用 如 下 程序 访问 它 。 


程序 清单 : codes\08\8.3\ClassPathResource\src\lee\ClassPathResourceTest.java 
public class ClassPathResourceTest 
{ 


public static void main(String[] args) 
上 throws Exception 
{ 


// 创 建 一 个 Resource 对 象 ， 从 类 加 载 路 径 里 读 取 资源 } 
ClassPathResource cr = new ClasspathResource ("book.xml"); 
// 获 取 该 资源 的 简单 信息 ” 


System.out.printin(cr.getPilename()); 
System.out.println(cr.getDescription{()}); 
// 创 建 Dom4j 的 解析 器 
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SAXReader reader = new SAXReader(); 
Document doc = reader.read(cr.getFile()); 
// 获 取 根 元 素 

Element el = doc.getRootElement (); 

List 1 = el.elements(); 


// 遍 历 根 元 素 的 全 部 子 元 素 
for (Iterator it = 1.iterator();it.hasNext() ; ) 


{ 

// 每 个 节点 都 是 < 书 > 节 点 

Element book = (Element)it.next(); 

List 11 = book.elements(); 

// 遍 历 < 书 > 节点 的 全 部 子 节点 

for (Iterator it2 = 1l.iterator();it2,hasNext() ; ) 

2 { 

Element eee = (Element)it2.next(): 
System.out.println (eee.getText ()); 

} 


} 
} 


上 面 的 程序 中 粗 体 字 代码 用 于 访问 类 加 载 路 径 下 的 book.xml 文件 , 对 比 前 面 进行 资源 访问 的 两 个 
示例 程序 ， 我 们 发 现 两 个 程序 除了 进行 资源 访问 的 代码 有 所 区 别 之 外 ， 其 他 程序 代码 基本 一 致 ， 这 就 
是 Spring 资源 访问 的 优势 ，Spring 的 资源 访问 消除 了 底层 资源 访问 的 差异 ， 人 允许 程序 以 一 致 的 方式 来 
访问 不 同 的 底层 资源 。 

ClassPathResource 实例 可 使 用 ClassPathResource 构造 器 显 式 地 创建 ， 但 更 多 的 时 候 它 都 是 隐 式 创 
建 的 。 当 执行 Spring 的 某 个 方法 时 ， 该 方法 接受 一 个 代表 资源 路 径 的 字符 串 参数 ， 当 Spring 识别 该 字 
符 串 参 数 中 包含 classpath: 前 绷 后 ， 系 统 将 会 自动 创建 ClassPathResource 对 象 。 

3， 访问 文件 系统 资源 

Spring 提供 的 FileSystemResource 类 用 于 访问 文件 系统 资源 。 使 用 FileSystemResource 来 访问 文件 
系统 资源 并 没有 太 大 的 优势 ， 因 为 Java 提供 的 File 类 也 可 用 于 访问 文件 系统 资源 。 

当然 使 用 FileSystemResource 也 可 消除 底层 资源 访问 的 差异 ， 程 序 通过 统一 的 Resource API 来 进 
行 资源 访问 。 下 面 的 程序 是 使 用 FileSystemResource 来 访问 文件 系统 资源 的 示例 程序 。 

程序 清单 :codes\08\8.3\FileSystemResource\src\lee\FileSystemResourceTest.java 


public class FilesystemResourceTest 
{ 
Public static void main(String[] args) throws Exception 


{ 
/ /默认 从 文件 系统 的 当前 路 径 加 载 book. xml 资源 
FileSystemResource fr = new FileSystemResource("book.xml"); 
// 获 取 该 资源 的 简单 信息 
System.out.println(tr.getEilename())7 
System.out .println (fr.getDescription()); 
// 创 建 Dom4j 的 解析 器 
SAXReader reader = new SAXReader(); 
Document doc = reader.read(fr.getFile()); 
// 获 取 根 元 素 
Element el = doc.getRootElement ()7 
List 1 ~ el.elements(); 
// 遍 历 根 元 素 的 全 部 子 元 素 


for (Iterator it = 1.iterator();it.hasNext() ; ) 


{ 
// 每 个 节点 都 是 < 书 > 节点 
Element book 1 (Element)it.next(); 
List 11 = booK.elements(); 
7/ 遍历 < 书 > 节点 的 全 部 子 节点 
for (Iterator it2 = 1l.iterator() rit2.hasNext() 7 ) 
{ 
Element eee = (Element)it2.next(); 
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System-out.println (eee.getText ()); 
上 


} 

了 

与 前 两 种 使 用 Resource 作 资 源 访问 的 区 别 在 于 : 资源 字符 串 确定 的 资源 ， 位 于 本 地 文件 系统 内 ， 
而 且 无 须 使 用 任何 前 级 。 

FileSystemResource 实例 可 使 用 FileSystemResource 构造 器 显 式 地 创建 , 但 更 多 的 时 候 它 都 是 隐 式 
创建 的 。 执行 Spring 的 某 个 方法 时 ， 该 方法 接受 一 个 代表 资源 路 径 的 字符 串 参数 ， 当 Spring 识别 该 字 
符 串 参 数 中 包含 file: 前 缀 后 ， 系 统 将 会 自动 创建 FileSystemResource 对 象 。 

4. 访问 应 用 相关 资源 

Spring 提供 了 ServletContextResource 类 来 访问 Web Context 下 相对 路 径 下 的 资源 ， 
ServletContextResource 构造 器 接受 一 个 代表 资源 位 置 的 字符 串 参数 , 该 资源 位 置 是 相对 于 Web 应 用 根 
路 径 的 位 置 。 

使 用 ServletContextResource 访问 的 资源 , 也 可 通过 文件 10 访问 或 URL 访问 。 通 过 java.io.File 访 
问 要 求 资源 被 解压 缩 ， 而 且 在 本 地 文件 系统 中 ; 但 使 用 ServletContextResource 进行 访问 时 则 无 须 关心 
资源 是 否 被 解压 缩 出 来 ， 或 者 直接 存放 在 JAR 文件 中 ， 总 可 通过 Servlet 容器 访问 。 

当 程 序 试图 直接 通过 File 来 访问 Web Context 下 相对 路 径 下 的 资源 时 ， 应 该 先 使 用 ServletContext 
的 getRealPath() 方 法 来 取得 资源 绝对 路 径 ， 再 以 该 绝对 路 径 来 创建 File 对 象 。 

下 面 我 们 把 book.xml 文件 放 在 Web 应 用 的 WEB-INF 路 径 下 ， 然 后 通过 JSP 页 面 来 直接 访问 该 
book.xml 文件 。 值 得 指出 的 是 : 在 默认 情况 下 ，JSP 不 能 直接 访问 WEB-INF 路 径 下 的 任何 资源 ， 所 以 
该 应 用 中 的 JSP 页 面 需要 使 用 ServletContextResource 来 访问 该 资源 。 下 面 是 JSP 页 面 代码 。 

程序 清单 :codes\08\8.3\ServletContextResource\test.jsp 

<h3> 测 试 ServletContextResource</h3> 


<% 

// 从 Web Context 下 的 WEB-INF 路 径 下 读 取 book.xml 资源 

ServletContextResource src = new ServletContextResource 
(application ， "WEB-INF/book.xml"); 

// 获 取 该 资源 的 简单 信息 

System.out ,println(src.getFilename ())7 

System.out .println(src.getDescription())7 

7/ 创建 Dom4j 的 解析 器 

SAXReader reader = new SAXReader(); 

Document doc = reader.read(src.getFile()); 

// 获 取 根 元 素 

Element el = doc.getRootElement(); 

List 1 = el.elements(); 

7/ 遍历 根 元 素 的 全 部 子 元 素 

for (Iterator it = 1.iterator();it. hasNext 0) 1 


{ 

// 每 个 节点 都 是 < 书 > 节点 

Element book = (Element)it.next(); 

List 11 = book.elements(); 

// 遍 历 < 书 > 节点 的 全 部 子 节点 

for (Iterator it2 = 11.iterator();it2.hasNext() ; ) 

{ 
Element eee = (Element)it2.next(); 
out.println (eee.getText ()); 
out.println{("<br/>"); 


} 
> 


上 面 的 程序 中 粗 体 字 代码 指定 应 用 从 Web Context 下 的 WEB-INF 路 径 下 读 取 book.xml 资源 ， 而 
我 们 正好 是 将 book.xml 文件 放 在 应 用 的 WEB-INF/ 路 径 下 的 , 通过 使 用 ServletContextResource 就 可 让 
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JSP 页 面 直接 访问 WEB-INF 下 的 资源 了 。 

将 应 用 部 署 在 Tomcat 中 ,然后 启动 Tomcat， 再 打开 浏览 器 访问 该 JSP 页面， 将 看 到 如 图 8.2 所 示 
的 效果 。 

5. 访问 字 节 数组 资源 

Spring 提供 了 InputStreamResource 来 访问 二 进 制 输入 Te 
流 资源 ，InputSteamResource 是 针对 输入 流 的 Resource 实 | gonx 
现 ， 只 有 当 没 有 合适 的 Resource 实现 时 ， 才 考虑 使 用 该 诺 用 
InputSteamResource 。 通 常情 况 下 ， 优 先 考虑 使 用 [sx 
ByteArrayResource， 或 者 基于 文件 的 Resource 实现 。 图 82 用 SerlvetContextResource 的 效果 

与 其 他 Resource 实现 不 同 的 是 ，InputSteamResource 
是 一 个 总 是 被 打开 的 Resource， 所 以 isOpen0 方 法 总 是 返回 tue。 因 此 如 果 需 要 多 次 读 取 某 个 流 ， 就 
不 要 使 用 InputSteamResource， 创 建 mputStreamResource 实例 时 应 提供 一 个 InputStream 参数 。 

在 一 些 个 别 的 情况 下 ，InputStreamResource 是 有 用 的 。 例 如 ， 我 们 从 数据 库 中 读 取得 到 一 个 Blob 
对 象 ， 程 序 需 要 获取 该 Blob 对 象 的 内 容 ， 就 可 先 通过 Blob 的 getBinaryStream() 方 法 获取 二 进 制 输入 
流 ， 再 将 该 二 进 制 输入 流 包装 成 Resource 对 象 ， 然 后 就 可 通过 该 Resource 对 象 来 访问 该 Blob 对 象 所 
包含 的 资源 了 。 


ty 
六 前 :六 


InputStreamResource 虽然 是 适应 性 很 广 的 Resource 实现 ， 但 效率 并 不 好 。 因 此 ， 
量 不 要 使 用 InputStreamResource 作为 参数 ， 尽 量 使 用 ByteArrayResource 或 
FileSystemResource 代替 它 .。 


Spring 提供 的 ByteArrayResouce 用 于 直接 访问 字 节 数组 资源 ， 字 节 数 组 是 一 种 常见 的 信息 传输 方 
式 : 网 络 Socket 之 间 的 信息 交换 ， 或 者 线程 之 间 的 信息 交换 等 ， 字 节 数 组 都 被 作为 信息 载体 。 
ByteArrayResource 可 将 字 节 数组 包装 成 Resource 使 用 。 
如 下 程序 示范 了 如 何 使 用 ByteArrayResouce 来 读 取 字 节 数组 资源 。 出 于 演示 目的 ， 程 序 中 字 节 数 
程序 清单 : codes\08\8.3\ByteArrayResource\src\lee 
public class ByteArrayResourceTest 


{ 
public static void main(String[] args) throws Exception 
{ 


String file = "<?xml version='1.0' encoding='GBK'?>" 
+ "< 计算 机 书籍 列表 >< 书 >< 书 名 > 疯狂 Java 讲义 ” 
+ "</ 书 名 >< 作 者 > 李刚 </ 作 者 ></ 书 >< 书 >< 书 名 >” 
+ " 轻 量 级 Java EE 企业 应 用 实战 </ 书 名 >< 作 者 > 李刚 ” 
+ "</ 作 者 ></ 书 ></ 计 算 机 书籍 列表 >"; 
byte[] fileBytes = file.getBytes(); 
// 以 字 节 数组 作为 资源 来 创建 Resource 对 象 


ByteArrayResource bar = new ByteArrayResource (fileBytes); 
// 获 取 该 资源 的 简单 信息 

System.out .Println(bar.getDescription())7 

7/ 创建 Dom4j 的 解析 器 


SAXReader reader = new SAXReader(); 

Document doc = reader.read(bar.getInputstream()); 
// 获 取 根 元 素 

Element el = doc.getRootElement () 7 

List 1 = el.elements(); 

7/ 遍历 根 元 素 的 全 部 子 元 素 

for (Iterator it = l.iterator();it.hasNext() ; ) 
{ 
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各 


// 每 个 节点 都 是 < 书 > 节点 
Element book = (Element)it.next(); 
List 11 = book.elements(); 
// 遍 历 < 书 > 节点 的 全 部 子 节点 
for (Iterator it2 = 11.iterator()7?it2.hasNext() ; ) 
{ 
Element eee = (Element)it2.next(); 
System-out .Println (eee.getText()) 7 
} 


} 
} 


上 面 的 程序 中 第 一 行 粗 体 字 代码 用 于 根据 字 节 数组 来 创建 InputStreamResource 对 象 ， 接 下 来 就 可 
通过 该 Resource 对 象 来 访问 该 字 节 数 组 资源 了 。 访 问 字 节 数组 资源 时 ，Resource 对 象 的 getFile0 和 
getFilename() 两 个 方法 不 可 用 一 一 这 是 可 想 而 知 的 事情 : 因为 此 时 访问 的 资源 是 字 节 数组 ， 当 然 不 存 
在 对 应 的 File 对 象 和 文件 名 了 。 

在 应 用 中 ， 字 节 数 组 可 能 通过 网 络 传输 获得 ， 也 可 能 通过 管道 流 获得 ， 还 可 能 通过 其 他 方式 
获得 …… 只 要 得 到 了 代表 资源 的 字 节 数组 ， 程 序 就 可 通过 ByteArrayResource 将 字 节 数组 包装 成 
Resource 实例 ， 并 利用 Resource 来 访问 该 资源 。 

对 于 需要 采用 InputStreamResource 访问 的 资源 ， 可 先 从 InputStream 流 中 读 出 字 节 数组 ， 然 后 以 
字 节 数组 来 创建 ByteArrayResource。 这 样 ，InputStreamResource 也 可 被 转换 成 ByteArrayResource， 从 
而 方便 多 次 读 取 。 


> >8.3.2 ResourceLoader 接口 和 ResourceLoaderAware 接口 


Spring 提供 如 下 两 个 标志 性 接口 。 

> ”ResourceLoader: 该 接口 实现 类 的 实例 可 以 获得 一 个 Resource 实例 。 

> ”ResourceLoaderAware: 该 接口 实现 类 的 实例 将 获得 一 个 ResourceLoader 的 引用 。 

在 ResourceLoader 接口 里 有 如 下 方法 。 

> Resource getResource(String location): 该 接口 仅 包含 这 个 方法 ， 该 方法 用 于 返回 一 个 
Resource 实例 。ApplicationContext 的 实现 类 都 实现 ResourceLoader 接口 ， 因 此 
ApplicationContext 可 用 于 直接 获取 Resource 实例 。 

某 个 ApplicationContext 实例 获取 Resource 实例 时 ， 默 认 采 用 与 ApplicationContext 相同 的 资源 访 

问 策略 。 看 如 下 代码 ; 


// 通 过 ApplicationContext 访问 资源 
Resource res = ctx.getResource ("some/resource/path/myTemplate. txt)} 


从 上 面 的 代码 中 无 法 确定 Spring 用 哪个 实现 类 来 访问 指定 资源 ，Spring 将 采用 和 
ApplicationContext 相同 的 策略 来 访问 资源 。 也 就 是 说 ， 如 果 ApplicationContext 是 
FileSystemXmlApplicationContext，res 就 是 FileSystemResource 实例 ; 如果 ApplicationContext 是 
ClassPathXmlApplicationContext ，res 就 是 ClassPathResource 实例 ; 如果 ApplicationContext 是 
XmlWebApplicationContext，res 就 是 ServletContextResource 实例 。 

从 上 面 的 介绍 可 以 看 出 ， 当 Spring 应 用 需要 进行 资源 访问 时 ， 实 际 上 并 不 需要 直接 使 用 Resource 
实现 类 ， 而 是 调用 ResourceLoader 实例 的 getResource() 方 法 来 获得 资源 。ResourceLoader 将 会 负责 选 
择 Resource 的 实现 类 ， 也 就 是 确定 具体 的 资源 访问 策略 ， 从 而 将 应 用 程序 和 具体 的 资源 访问 策略 分 离 
开 来 ， 这 就 是 典型 的 策略 模式 。 

看 如 下 示例 程序 ， 将 使 用 ApplicationContext 来 访问 资源 。 

程序 清单 : codes\08\8.3\ResouceAware\src\lee\ResourceAwareTest.java 

Public class ResourceAwareTest 
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public static void main(String[] args) 
throws Exception 


{ 
// 创 建 ApplicationContext 实例 
ApplicationContext ctx = new 
ClassPathxmlApplicationContext ("bean .xm1") ; 


// ApplicationContext ctx = new 

I/ FileSystemXmlApplicationContext ("bean.xml"); 
Resource res = ctx.getResource("book.xml"); 
// 获 取 该 资源 的 简单 信息 


System.out .println (res.getFilename()); 
System.out.println(res.getDescription())7 
// 创 建 Dom4j 的 解析 器 

SAXReader reader = new SAXReader (); 
Document doc = reader.read(res.getFile()); 
/ /获取 根 元 : 
Element el = doc.getRootElement (); 

List 1 = el.elements(); 

7/ 遍历 根 元 素 的 全 部 子 元 素 

for (Iterator it = 1.iterator();it.hasNext() ; ) 


{ 
// 每 个 节点 都 是 < 书 > 节点 
Element book = (Element)it.next(); 
List 11 = book.elements(); 
7/ 遍历 < 书 > 节点 的 全 部 子 节点 
for (Iterator it2 = 1].iterator();it2.hasNext() ; ) 
{ 


Element eee = (Element)it2.next(); 
System.out.println (eee.getText ()); 


) 


上 面 的 程序 中 第 一 行 粗 体 字 代码 创建 了 一 个 ApplictionContext 对 象 ， 第 二 行 粗 体 字 代码 通过 该 对 
象 来 获取 资源 。 由 于 程序 中 使 用 了 ClassPathApplicationContext 来 获取 资源 , 所 以 Spring 将 会 从 类 加 载 
路 径 下 访问 资源 ， 也 就 是 使 用 ClassPathResource 实现 类 。 

程序 中 ， 并 未 指定 采用 哪 一 种 Resource 实现 类 ， 仅 仅 通过 ApplicactionContext 获得 Resource。 程 
序 执行 结果 如 下 : 
book ,xml 


class path resource {book.xml] 
疯狂 Java 讲义 


李刚 
轻 量 级 Java EE 企业 应 用 实战 
李刚 


从 运行 结果 可 以 看 出 ，Resource 采用 了 ClassPathResource 实现 类 ， 如 果 将 ApplicationContext 改 
为 使 用 FileSystemXmlApplicationContext 实现 类 ， 运 行 上 面 程序 ， 将 看 到 如 下 运行 结果 : 
book. xml 


file [G:\publish\codes\08\8.3\ResouceAware\book.xml] 
疯狂 Java 讲义 


李刚 
Struts 2 权威 指南 
李刚 
从 上 面 的 执行 结果 可 以 看 出 , 程序 的 Resource 实现 类 发 生 了 改变 , 变 为 FileSystemResource 实现 类 。 
为 了 保证 得 到 上 面 的 两 次 运行 结果 ,我 们 应 该 分 别 在 类 加 载 路 径 下 、 当 前 文件 路 径 下 放置 bean.xml 
和 book.xml 两 个 文件 。 
另外 ， 使 用 ApplicationContext 访问 资源 时 ， 也 可 不 理会 ApplicationContext 的 实现 类 ， 强 制 使 
用 指定 的 ClassPathResource、FileSystemResource 等 实现 类 ， 这 可 通过 不 同 前 级 来 指定 ， 如 下 面 的 代 
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码 所 示 。 


// 通 过 classpath: 前 组， 强制 使 用 ClassPathResource 
Resource r = ctx.getResource ("classpath:bean.xml”); 


类 似 地 ， 还 可 以 使 用 标准 的 java.net.URL 前 组 来 强制 使 用 UrlResource， 如 下 所 示 : 
// 通 过 标准 tile 前缀， 强制 使 用 DrlResource 访问 本 地 文件 资源 
Resource r = ctx.getResource ("file:bean.2ml1"); 


// 通 过 标准 http: 前 级 ， 强 制 使 用 UrlResource 访问 基于 BTTP 协议 的 网 络 资源 
Resource r = ctx.getResource("http://localhost:8888/bean.xml"); 


以 下 是 常见 的 前 缀 及 对 应 的 访问 策略 。 

> classpath: 一 一 以 ClassPathResource 实例 来 访问 类 加 载 路 径 下 的 资源 。 

> ”file: 一 一 以 UrlResource 实例 访问 本 地 文件 系统 的 资源 。 

> ”http: 一 一 以 UrlResource 实例 访问 基于 HTTP 协议 的 网 络 资源 。 

> ”无 前 绷 一 一 由 ApplicationContext 的 实现 类 来 决定 访问 策略 。 

ResourceLoaderAware 接口 则 用 于 指定 该 接口 的 实现 类 必须 持 有 一 个 ResourceLoader 实例 。 

类 似 于 Spring 提供 的 BeanFactoryAware、BeanNameAware 接口 ，ResourceLoaderAware 接口 也 提 
供 了 一 个 setResourceLoader0 方 法 ， 该 方法 将 由 Spring 容器 负责 调用 ，Spring 容器 会 将 一 个 
ResourceLoader 对 象 作为 该 方法 的 参数 传 入 。 

当 我 们 把 ResourceLoaderAware 实例 部 署 在 Spring 容器 中 后 ，Spring 容器 会 将 自身 当成 
ResourceLoader 作为 setResourceLoader0 方 法 的 参数 传 入 。 由 于 ApplicationContext 的 实现 类 都 实现 了 
ResourceLoader 接口 ，Spring 容器 自身 完全 可 作为 ResourceLoader 使 用 。 

程序 清单 :，codes\08\8.3\ResouceLoaderAware\src\org\crazyit\app\service\TestBean.java 


public class TestBean 
implements ResourceLoaderAware 
{ 
ResourceLoader rd; 
// 实 现 ResourceLoaderAware 接口 必须 实现 的 方法 
public void setResourceLoader (ResourceLoader resourceLoader) 
{ 
this.rd = resourceLoader; 


} 
// 返 回 ResourceLoader 对 象 的 引用 
public ResourceLoader getResourceLoader() 
{ 
return rd; 
} 
} 


将 该 类 部 署 在 ApplicationContext 中 ， 然 后 使 用 如 下 主 程序 测试 。 
程序 清单 :，codes\08\8.3\ResouceLoaderAware\src\lee\SpringTestjava 


public class SpringTest 
{ 
public static void main(String{] args) 
{ 
// 创 建 ApplicationContext 容器 
ApplicationContext ctx = new 
ClassPathXmlApplicationContext ("bean.xml"); 
// 获 取 容 器 中 名 为 test 的 Bean 实例 
TestBean tb = (TestBean)ctx.getBean("test"); 
// 通 过 tb 实例 来 获取 ResourceLoader 对 象 
ResourceLoader rl = tb.getResourceLoader() 
// 判 断 程序 获得 ResourceLoader 和 容器 是 否 相同 
System.out.println(rl 一 otx); 
} 
} 


上 面 的 程序 中 第 一 行 粗 体 字 代码 通过 TestBean 实例 来 获取 ResourceLoader 对 象 , 第 二 行 粗 体 字 代 
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码 判断 该 对 象 和 Spring 容器 是 否 相 同 ， 这 行 代码 将 输出 tue， 这 表明 Spring 容器 确实 是 将 自身 注入 到 


ResouceLoaderAware Bean 的 。 


》>》>8.3.3 使 用 Resource 作为 属性 


前 面 介绍 了 Spring 提供 的 资源 访问 策略 , 但 这 些 依赖 访问 策略 要 么 使 用 Resource 实现 类 ， 要 么 使 
用 ApplicationContext 来 获取 资源 ， 实 际 上 ， 当 应 用 程序 中 的 Bean 实例 需要 访问 资源 时 ，Spring 有 更 
好 的 解决 方法 ， 直 接 利用 依赖 注入 。 

归纳 起 来 ， 如 果 Bean 实例 需要 访问 资源 ， 则 有 如 下 两 种 解决 方案 。 

> ”代码 中 获取 Resource 实例 。 

> ”使 用 依赖 注入 。 

对 于 第 一 种 方式 的 资源 访问 ， 当 程序 获取 Resource 实例 时 ， 总 需要 提供 Resource 所 在 的 位 置 ， 不 
管 通过 FileSystemResource 创建 实例 ， 还 是 通过 ClassPathResource 创建 实例 ， 或 者 通过 
ApplicationContext 的 getResource() 方 法 获取 实例 ， 都 需要 提供 资源 位 置 。 这 意味 着 ;资源 所 在 的 物理 
位 置 将 被 耦合 到 代码 中 ， 如 果 资 源 位 置 发 生 改 变 ， 则 必须 改写 程序 。 因 此 ,通常 建议 采用 第 二 种 方法 ， 
让 Spring 为 Bean 实例 依赖 注入 资源 。 

看 如 下 TestBean， 它 有 一 个 Resource 类 型 的 res Field， 程 序 为 该 Field 提供 了 对 应 的 setter 方法 ， 
这 就 可 以 利用 Spring 的 依赖 注入 了 。 

程序 清单 : codes\08\8.3\Inject_Resouce\src\org\crazyit\app\service\TestBean.java 

Pe class TestBean 


Pprivate Resource res; 
// 依 赖 注入 Resource 资源 的 setter 方法 
public void setResource (Resource res) 
{ 
this.res = res; 
} 
public void parse()throws Exception 
{ 


// 获 取 该 资 源 的 简单 信息 

System.out .printlin(res.getFilename()); 
System.out.println(res.getDescription()); 
// 创 建 Dom4j 的 解析 器 

SAXReader reader = new SAXReader(); 
Document doc = reader.read(res.getFile()); 
// 获 取 根 元 素 

Element el = doc.getRootElement ()7 

List 1 = el.elements(); 

7/ 遍历 根 元 素 的 全 部 子 元 素 

for (Iterator it = 1.iterator();it.hasNext() ; ) 


| 
// 每 个 节点 都 是 < 书 > 节点 
Element book = (Element)it.next(); 
List 11 = book.elements{(); 
// 遍 历 < 书 > 节点 的 全 部 子 节点 
for (Iterator it2 = ll.iterator();it2.hasNext() 7 ) 
{ 
Element eee = (Element)it2.next(); 
System.out .printin(eee.getText ()); 
} 


了 
} 


上 面 的 程序 中 粗 体 字 代码 定义 了 一 个 Resource 类 型 的 res 属性 ， 该 属性 需要 可 以 接受 Spring 的 依 
赖 注入 。 除 此 之 外 ， 程 序 中 的 parse0 方 法 用 于 解析 res 资源 所 代表 的 XML 文件 。 
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在 容器 中 配置 该 Bean， 并 为 该 Bean 指定 资源 文件 的 位 置 。 配 置 文 件 如 下 。 
程序 清单 : codes\08\8.3\Inject_Resouce\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 -一 > 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://waw. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<bean id="test" class="org.crazyit.app.service.TestBean"> 
<!-- 注入 资源 --> - 
<property name="resource" 
value="classpath:book .xml"/> 
</bean> 
</beans> 


上 面 配置 文件 中 粗 体 字 代码 配置 了 资源 的 位 置 ， 并 使 用 了 classpath: 前 缀 ,这 指明 让 Spring 从 类 加 
载 路 径 下 加 载 book.xml 文件 。 与 前 面 类 似 的 是 ， 此 处 的 前 缀 也 可 采用 http:、ftp: 等 ， 这 些 前 级 将 强制 
Spring 采用 怎样 的 资源 访问 策略 (也 就 是 指定 具体 使 用 哪个 Resource 实现 类 ); 如 果 不 采 用 任何 前 级 ， 
则 Spring 将 采用 与 该 ApplicationContext 相同 的 资源 访问 策略 来 访问 资源 。 

采用 依赖 注入 ， 人 允许 动态 配置 资源 文件 位 置 ， 无 须 将 资源 文件 位 置 写 在 代码 中 ， 当 资源 文件 位 置 
发 生变 化 时 ， 无 须 改写 程序 ， 直 接 修改 配置 文件 即 可 。 


》>>8.3.4 在 ApplicationContext 中 使 用 资源 


不 管 以 怎样 的 方式 创建 ApplicationContext 实 例 , 都 需要 为 ApplicationContext 指 定 配置 文件 , Spring 
允许 使 用 一 份 或 多 份 XML 配置 文件 。 

当 程 序 创建 ApplicationContext 实例 时 ， 通 常 也 是 以 Resource 的 方式 来 访问 配置 文件 的 ， 所 以 
ApplicationContext 完全 支持 ClassPathResource、FileSystemResource、ServletContextResouce 等 资源 访 
问 方式 。ApplicationContext 确定 资源 访问 策略 通常 有 两 个 方法 : 

> ApplicationContext 实现 类 指定 访问 策略 。 

> ”前 级 指定 访问 策略 。 

1.， ApplicationContext 实现 类 指定 访问 策略 

当 我 们 创建 ApplicationContext 对 象 时 ， 通 常 可 以 使 用 如 下 三 个 实现 类 。 

> ClassPathXmlApplicatinContext: 对 应 使 用 ClassPathResource 进行 资源 访问 。 

> ”FileSystemXmlApplicationContext， 对 应 使 用 FileSystemResoure 进行 资源 访问 。 

> XmlWebApplicationContext 对 应 使 用 ServletContextResource 进行 资源 访问 。 

从 上 面 的 说 明 可 以 看 出 ， 当 使 用 ApplicationContext 的 不 同 实现 类 时 ， 就 意味 着 Spring 使 用 相应 
的 资源 访问 策略 。 

当 使 用 如 下 代码 来 创建 Spring 容器 时 ， 则 意味 着 从 本 地 文件 系统 来 加 载 XML 配置 文件 ; 

// 通 过 本 地 文件 系统 加 载 配置 资源 
ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("bean. xml") ; 
程序 将 从 本 地 文件 系统 中 读 取 bean.xml 文件 ， 然 后 加 载 该 资源 ， 并 根据 该 配置 文件 来 创建 
ApplicationContext 实例 .相应 地 ,采用 ClassPathApplicationContext 实现 类 则 从 类 加 载 路 径 中 加 载 XML 
配置 文件 。 
2. 前 缀 指定 访问 策略 


Spring 也 人 允许 前 缀 来 指定 资源 访问 策略 ， 例 如 ， 采 用 如 下 代码 来 创建 ApplicationContext: 


ApplicationContext ctx = new 
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FileSystemXmlApplicationContext ("classpath:bean .xml") 1 

虽然 上 面 的 代码 采用 了 FileSystemXmlApplicationContext 实现 类 ， 但 程序 将 从 类 加 载 路 径 里 搜索 
bean.xml 配置 文件 ， 而 不 是 相对 当前 路 径 搜索 。 相 应 的 ， 还 可 以 使 用 http:、ftp: 等 前 缀 ， 用 来 确定 对 应 
的 资源 访问 策略 。 看 如 下 代码 : 


public class SpringTest 
public static void main(String[] args) throws Exception 


// 通 过 搜索 类 加 载 路 径 中 的 资源 文件 创建 ApplicationContext 
// 并 通过 指定 classpath: 前 级 强制 搜索 类 加 载 路 径 
ApplicationContext ctx = new 
FileSystemknlApplicationContext ("classpath:bean.xm1") ; 
System.out .println (ctx); 
// 使 用 ApplicationContext 的 资源 访问 策略 来 访问 资源 ， 没 有 指定 前 级 
Resource = = ctx.getResource("book.xm1"); 
// 输 出 Resource 描述 
System.out .Println(r.getDescription())7 
} 
) 
Resource 实例 的 输出 结果 是 : 


file [G:\publish\codes\08\8.3\ApplicationContext\book.xml] 


上 面 程序 的 粗 体 字 代 码 创建 Spring 容器 时 ， 系 统 将 从 类 加 载 路 径 来 搜索 bean.xml;， 但 使 用 
ApplicationContext 来 访问 资源 时 ， 依 然 采 用 的 是 FileSystemResource 实现 类 ， 这 与 
FileSystemXmlApplicationContext 的 访问 策略 是 一 致 的 。 这 表明 : 通过 classpath: 前 级 指定 资源 访问 策 
略 仅仅 对 当 次 访问 有 效 , 程序 后 面 进行 资源 访问 时 , 还 是 会 根据 AppliactionContext 的 实现 类 来 选择 对 
应 的 资源 访问 策略 。 

因此 如 果 程序 需要 使 用 ApplicationContext 访问 资源 ， 建 议 显 式 采用 对 应 的 实现 类 来 加 载 配置 文 
件 ， 而 不 是 通过 前 级 来 指定 资源 访问 策略 。 当 然 ， 我 们 也 可 在 每 次 进行 资源 访问 时 都 指定 前 级 ， 让 程 
序 根据 前 级 来 选择 资源 访问 策略 。 

public class SpringTest 
public static void main(String[] args) throws Exception 
// 通 过 搜索 类 加 载 路 径 中 的 资源 文件 创建 ApplicationContext 
// 而 是 通过 指定 classpath: 前 组 强制 搜索 类 加 载 路 径 
ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("classpath:bean. xml"); 


System.out .println(ctx); 
// 使 用 ApplicationContext 加 载 资源 ， 通 过 classpath: 前 组 指定 访问 策略 
Resource r = ctx.getResource("classpath:book.xml"); 
// 输 出 Resource 描述 
System.out.println(r.getDescription()); 
) 
} 


输出 程序 中 的 Resource 实例 ， 看 到 如 下 输出 结果 : 

class path resource [book.xml] 

由 此 可 见 ， 如 果 每 次 进行 资源 访问 时 指定 了 前 级 ， 则 系统 会 采用 前 组 相应 的 资源 访问 策略 。 

3. classpath*: 前 缀 的 用 法 

classpath*: 前 绷 提 供 了 装载 多 个 XML 配置 文件 的 能 力 ， 当 使 用 classpath*: 前 绷 来 指定 XML 配置 
文件 时 ， 系 统 将 搜索 类 加 载 路 径 ， 找 出 所 有 与 文件 名 匹配 的 文件 ， 分 别 装载 文件 中 的 配置 定义 ， 最 后 


合并 成 一 个 ApplicationContext。 看 如 下 代码 ; 


public class SpringTest 
{ 
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public static void main(String[] args) throws Exception 


{ 
// 使 用 classpath*: 装载 多 份 配置 文件 - 
ApplicationContext ctx = new 

FileSystemXmlApplicationContext ("classpath* :bean. xml") ; 

输出 ApplicationContext 实例 。 
System-out.Println (ctx)7 

1 

} 


将 配置 文件 bean.xml 分 别 放 在 应 用 的 classes 路 径 (该 路 径 被 设 为 类 加 载 路 径 之 一 )， 并 将 配置 文 
件 放 在 classes/aa 路 径 下 〈 该 路 径 也 被 设 为 类 加 载 路 径 之 一 )， 程 序 实例 化 ApplicationContext 时 显示 : 

Loading XML bean definitions from URL [file:/G:/publish/codes/ 

08/8.3/ApplicationContext/classes/bean. xml] 

Loading XML bean definitions from URL [file:/6G:/publish/codes/ 

08/8.3/ApplicationContext/classes/aa/bean.xml] 


从 上 面 的 执行 结果 可 以 看 出 ， 当 使 用 classpath*: 前 级 时 ，Spring 将 会 搜索 类 加 载 路 径 下 所 有 满足 
该 规则 的 配置 文件 。 

如 果 不 是 采用 classpath*: 前 级 ， 而 是 改 为 使 用 classpath: 前 级 ，Spring 则 只 加 载 第 一 份 符合 条 件 的 
XML 文件 。 例 如 如 下 代码 : 


ApplicationContext ctx = new 
FileSystemxmlApplicationContext ("classpath:bean.xml™")7 


执行 上 面 的 代码 将 只 看 到 如 下 输出 : 

Loading XML bean definitions from class path resource [bean.xm] 

当 使 用 classpath* :前缀 时 ， 系 统 通过 类 加 载 路 径 搜索 bean.xml 文件 ， 如 果 找到 文件 名 匹配 的 文件 ， 
系统 立即 停止 搜索 ， 装 载 该 文件 ， 即 使 有 多 份 文件 名 匹配 的 文件 ， 系 统 也 只 装载 第 一 份 文件 。 资 源 文 
件 的 搜索 顺序 则 取决 于 类 加 载 路 径 的 顺序 ， 排 在 前 面 的 配置 文件 将 优先 被 加 载 。 


[9 
条 -注意 : 

classpath*: 前 组 仅 对 ApplicationContext 有 效 . 实际 情况 是 : 创建 ApplicationContext 
时 ,分 别 访问 多 个 配置 文件 ( 通过 ClassLoader 的 getResources 方 法 实现 ). 因 此 ,classpathy: e 
前 级 不 可 用 于 Reource， 使 用 classpath*: 前 组 一 次 性 访问 多 个 资源 是 行 不 通 的 。 


另外 ， 还 有 一 种 可 以 一 次 性 装载 多 份 配置 文件 的 方式 : 指定 配置 文件 时 指定 使 用 通配符 ， 例 如 如 
下 代码 : 
ApplicationContext ctx = new 
ClassPathxmlApplicationContext ("bean* .xml"); 


上 面 的 粗 体 字 代 码 指定 从 类 加 载 路 径 搜 索 配 置 文件 ， 且 搜索 所 有 以 bean 开头 的 XML 配置 文件 。 

将 classses 下 的 bean.xml 文件 再 复制 两 份 ， 分 别 重 命名 为 bean1.xml 和 bean2.xml。 执 行 上 面 的 代码 ， 
将 看 到 创建 ApplicationContext 有 如 下 输出 : 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext \classes\bean.xml] 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext\classes\beanl .xml] 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext\classes\bean2.xml] 


从 上 面 的 执行 结果 可 以 看 出 ， 位 于 类 加 载 路 径 下 所 有 以 bean 开头 的 XML 配置 文件 都 将 被 加 载 。 
除 此 之 外 ，Spring 甚至 允许 将 classpath*: 前 缀 和 通配符 结合 使 用 ， 如 下 语句 也 是 合法 的 : 


ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("classpath* :bean* .xml"); 
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上 面 的 语句 创建 ApplicationContext 实例 时 ， 系 统 将 搜索 所 有 的 类 加 载 路 径 下 ， 所 有 文件 名 匹配 
bean*.xml 的 XML 配置 文件 。 运 行 上 面 的 代码 ， 将 看 到 如 下 输出 : 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext\classes\bean.xml] 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext\classes\beanl .xml] 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext\classes\bean2.xml] 

Loading XML bean definitions from file [G:\publish\codes\08\8.3\ 

ApplicationContext\classes\aa\bean.xml] ¢ 

从 上 面 的 运行 结果 来 看 , 采用 这 种 方式 指定 配置 文件 时 ，Spring 不 仅 加 载 了 classes 下 所 有 以 bean 
开头 的 配置 文件 ， 也 会 加 载 位 于 classes\aa 下 所 有 以 bean 开头 的 配置 文件 。 

4. file: 前 缀 的 用 法 


先 看 如 下 的 代码 : 


public class SpringTest 
{ 
public static void main(String[] args) throws Exception 


{ 
ds ei dp 
ApplicationContext ctx 
Tilesye tipplioationcontert ("baan. xn") 
ApplicationContext ctx = new 
FileSystemXnlApplicationContext ("/bean.xml") ; 
System.out.println(ctx) ; 


// 使 用 ApplicationContext | Se 
Resource. r = ctx.getResource ("book.xml" 


// 输 出 Resource 描述 
System.out.printin(r.getDescription()); 
} 
本 
程序 有 两 行 粗 体 字 代码 用 于 创建 ApplicationContext， 第 一 行 粗 体 字 代码 指定 资源 文件 时 采用 了 相 
对 路 径 的 写法 
ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("bean. xm1"); 


第 二 行 粗 体 字 代 码 指定 资源 文件 时 采用 了 绝对 路 径 的 写法 : 
ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("/bean.xml"); 


任意 注释 两 条 语句 的 其 中 之 一 ， 程 序 正常 执行 ， 没 有 任何 区 别 ， 两 句 代码 读 取 了 相同 的 配置 资源 
文件 。 问 题 是 ， 如果 程序 中 明明 采用 的 一 个 是 绝对 路 径 、 一 个 相对 路 径 ， 为 什么 执行 效果 没有 任何 区 
别 呢 ? 

产生 问题 的 原因 : 当 FileSystemXmlApplicationContext 作为 ResourceLoader 使 用 时 ， 它 会 发 生变 
化 ，FileSystemApplicationContext 会 简单 地 让 所 有 绑 定 的 FileSystemResource 实例 把 绝对 路 径 都 当成 
相对 路 径 处 理 ， 而 不 管 是 否 以 斜 杠 开头 ， 所 以 上 面 两 行 代码 的 效果 是 完全 一 样 的 。 

如 果 程 序 中 需要 访问 绝对 路 径 ， 则 不 要 直接 使 用 FileSystemResource 或 FileSystemXml- 
ApplicationContext 来 指定 绝对 路 径 。 建 议 强 制 使 用 file: 前 缀 来 区 分 相对 路 径 和 绝对 路 径 ， 例 如 如 下 两 
行 代码 : 


ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("file:bean. xml"); 

ApplicationContext ctx = new 
FileSystemXmlApplicationContext ("file:/bean. xml"); 


上 面 第 一 条 语句 访问 相对 路 径 下 的 bean.xml， 第 二 条 语句 访问 绝对 路 径 下 的 bean.xml。 相 对 路 径 
以 当前 工作 路 径 为 路 径 起 点 ， 而 绝对 路 径 以 文件 系统 根 路 径 为 路 径 起 点 。 
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8.4 Spring 的 AOP 


AOP (Aspect Orient Programming)， 也 就 是 面向 切面 编程 ， 作 为 面向 对 象 编程 的 一 种 补充 ， 当 前 
已 经 成 为 一 种 比较 成 熟 的 编程 思想 ,其 实 AOP 问世 的 时 间 并 不 太 长 ,甚至 在 国内 的 翻译 还 不 太 统一 有 
些 书 翻译 成 “面向 方面 编程 ”)。AOP 和 OOP 互 为 补充 ， 面 向 对 象 编程 将 程序 分 解 成 各 个 层次 的 对 象 ， 
而 面向 切面 编程 将 程序 运行 过 程 分 解 成 各 个 切面 。 可 以 这 样 理 解 ， 面 向 对 象 编程 是 从 静态 角度 考虑 程 
序 结构 ， 面 向 切面 编程 是 从 动态 角度 考虑 程序 运行 过 程 。 


>>8.4.1 为 什么 需要 AOP 


在 传统 OOP 编程 里 以 对 象 为 核心 , 整个 软件 系统 由 系列 相互 依赖 的 对 象 所 组 成 , 而 这 些 对 象 将 被 
抽象 成 一 个 一 个 的 类 , 并 允许 使 用 类 继承 来 管理 类 与 类 之 间 一 般 到 特殊 的 关系 。 随 着 软件 规模 的 增 大 ， 
应 用 的 逐渐 升级 ， 慢 慢 出 现 了 一 些 OOP 很 难 解决 的 问题 。 

我 们 可 以 通过 分 析 、 抽 象 出 一 系列 具有 一 定 属性 与 行为 的 对 象 ， 并 通过 这 些 对 象 之 间 的 协作 来 形 
成 一 个 完整 的 软件 功能 。 由 于 对 象 可 以 继承 ， 因 此 我 们 可 以 把 具有 相同 功能 或 相同 特性 的 属性 抽象 到 

-个 层次 分 明 的 类 结构 体系 中 。 随 着 软件 规范 的 不 断 扩大 ， 专 业 化 分 工 越 来 越 系列 ,以 及 OOP 应 用 实 
战 的 不 断 增多 ， 随 之 也 暴露 出 了 一 些 OOP 无 法 很 好 解决 的 问题 。 

现在 假设 系统 中 有 三 段 完全 相似 的 代码 ， 这 些 代码 通常 会 采用 “复制 “粘贴 ”方式 来 完成 ， 通 

过 这 种 “复制 “粘贴 ”方式 开发 出 来 的 软件 如 图 8.3 所 示 。 


方 
法 
1 


局 萨 站 


通过 复制 
相 央 的 部 分 


避 苹 直 


图 83 多 个 地 方 包含 相同 代码 的 软件 


看 到 如 图 8.3 所 示 的 示意 图 ， 可 能 有 的 读者 已 经 发 现 了 这 种 做 法 的 不 足 之 处 : 如果 有 一 天 ， 图 8.3 
中 的 深 色 代码 段 需要 修改 ， 那 是 不 是 要 打开 三 个 地 方 的 代码 进行 修改 ? 如 果 不 是 三 个 地 方 包含 这 段 代 
码 ， 而 是 100 个 地 方 ， 甚 至 是 1000 个 地 方 包含 这 段 代码 段 ， 那 会 是 什么 后 果 ? 

为 了 解决 这 个 问题 ， 我 们 通常 会 采用 将 如 图 8.3 所 示 的 深 色 代码 部 分 定义 成 一 个 方法 ， 然 后 在 三 
个 代码 段 中 分 别 调用 该 方法 即 可 。 在 这 种 方式 下 ， 软 件 系统 的 结构 如 图 8.4 所 示 。 

对 于 如 图 8.4 所 示 的 软件 系统 ， 如 果 需 要 修改 深 色 部 分 的 代码 ， 只 要 修改 一 个 地 方 即 可 ， 不 管束 
个 系统 中 有 多 少 地 方 调用 了 该 方法 ， 程 序 无 须 修改 这 些 地 方 ， 只 需 修改 被 调用 的 方法 即 可 一 一 通过 这 
种 方式 ， 大 大 降低 了 软件 后 期 维护 的 复杂 度 。 

对 于 如 图 8.4 所 示 的 方法 1、 方 法 2、 方 法 3 依然 需要 显 式 调用 深 色 方法 ， 这 样 做 能 够 解决 大 部 分 
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应 用 场景 。 但 对 于 一 些 更 特殊 的 情况 : 应 用 需要 方法 1、 方 法 2、 方 法 3 彻底 与 深 色 方法 分 离 一 一 方法 
1、 方法 2、 方 法 3 无 须 直接 调用 深 色 方法 ， 那 如 何 解决 ? 


广 
法 
下 请 用 方法 


图 8.4 通过 方法 调用 实现 系统 功能 


因为 软件 系统 需求 变更 是 很 频繁 的 事情 ， 系 统 前 期 设计 方法 1、 方 法 2、 方法 3 时 只 实现 了 核心 业 
务 功能 ， 过 了 一 段 时 间 ， 我 们 需要 为 方法 1 、 方 法 2、 方 法 3 都 增加 事务 控制 ， 又 过 了 一 段 时 间 ， 客 户 
提出 方法 1、 方法 2、 方 法 3 需要 进行 用 户 合法 性 验证 ， 只 有 合法 的 用 户 才能 执行 这 些 方法 ; 又 过 了 一 
段 时 间 ， 客 户 又 提出 方法 1、 方 法 2、 方 法 3 应 该 增加 日 志 记录 ; 又 过 了 一 段 时 间 ,客户 又 提出 …… 面 
对 这 样 的 情况 ， 我 们 怎么 办 ? 通常 有 两 种 做 法 ， 

> ”根据 需求 说 明 书 ， 直 接 拒绝 客户 要 求 。 

> ”拥抱 需求 ， 满 足 客户 的 需求 。 

第 一 种 做 法 显然 不 好 ， 客 户 是 上 帝 ， 我 们 应 该 尽量 满足 客户 的 需求 。 通 常会 采用 第 二 种 做 法 ， 那 
如 何 解决 呢 ? 是 不 是 每 次 先 定义 一 个 新 方法 ， 然 后 修改 方法 1、 方 法 2、 方 法 3， 增加 调用 新 方法 ? 这 
样 做 的 工作 量 也 不 小 啊 ! 我 们 希望 有 一 种 特殊 的 方法 ， 我 们 只 要 定义 该 方法 ， 无 须 在 方法 1、 方 法 2、 
方法 3 中 显 式 调用 它 ， 系 统 会 “自动 ”执行 该 特殊 方法 。 

Fo “上 面 的 自动 执行 的 自动 被 加 上 了 引号 ， 因为 在 编程 过 程 中 ， 没 有 所 谓 自动 的 事情 ， 任 : 
何事 情 都 是 代码 驱动 的 这 里 的 自动 是 指 无 须 开发 者 关心 ， 由 系统 来 驱 动 。 | 


上 面 想法 听 起 来 很 神奇 ， 甚 至 有 一 些 不 切实 际 ， 但 其 实 是 完全 可 以 实现 的 ， 实 现 这 个 需求 的 技术 
就 是 AOP, AOP 专门 用 于 处 理 系统 中 分 布 于 各 个 模块 (不 同方 法 ) 中 的 交叉 关注 点 的 问题 , 在 Java EE 
应 用 中 ， 常 常 通过 AOP 来 处 理 一 些 具有 横 切 性 质 的 系统 级 服务 ， 如 事务 管理 、 安 全 检查 、 缓 在、 对 象 
池 管 理 等 ，AOP 已 经 成 为 一 种 非常 常用 的 解决 方案 。 


>>8.4.2 使 用 AspectJ 实现 AOP 


Aspect 是 一 个 基于 Java 语言 的 AOP 框架 ， 提 供 了 强大 的 AOP 功能 ， 其 他 很 多 AOP 框架 都 借鉴 
或 采纳 其 中 的 一 些 思想 。 由 于 Spring 3.0 的 AOP 与 Aspect 进行 了 很 好 的 集成 , 因此 掌握 Aspect] 是 学 
习 Spring AOP 的 基础 。 

Aspect 是 Java 语言 的 一 个 AOP 实现 ， 其 主要 包括 两 个 部 分 : 第 一 个 部 分 定义 了 如 何 表达 、 定 义 
AOP 编程 中 的 语法 规范 ， 通 过 这 套 语 言 规范 ， 我 们 可 以 方便 地 用 AOP 来 解决 Java 语言 中 存在 的 交叉 
关注 点 问题 ， 另 一 个 部 分 是 工具 部 分 ， 包 括 编译 器 、 调 试 工具 等 。 
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Aspect 是 最 早 、 功 能 比较 强大 的 AOP 实现 之 一 , 对 整套 AOP 机 制 都 有 较 好 的 实现 , 很 多 其 他 语 
言 的 AOP 实现 ， 也 借鉴 或 采纳 了 Aspect 中 很 多 设计 。 在 Java 领域 ，Aspect 中 的 很 多 语法 结构 基本 
上 已 成 为 AOP 领域 的 标准 。 

从 Spring 2.0 开始 ,Spring AOP 已 经 引入 了 对 Aspect 的 支持 ,并 人 允许 直接 使 用 Aspect 进行 AOP 
编程 ， 而 Spring 自身 的 AOP API 也 努力 与 Aspect 保持 一 致 。 ， 学 习 Spring AOP 就 必然 需要 从 
Aspect 开始 ， 因 为 它 是 Java 领域 最 流行 的 AOP 解决 方案 。 即 使 不 用 Spring 框架 ， 我 们 甚至 也 可 以 直 
接 使 用 Aspect 进行 AOP 编程 。 

Aspect 是 Eclipse 下 面 的 一 个 开源 子 项 目 ， 其 最 新 的 1.6.10 版 于 2010 年 10 月 22 日 发 布 , 这 也 是 
本 书 所 使 用 的 Aspecty 版 本 。 


1. 下载 和 安装 AspectJ 
下 载 和 安装 Aspect 请 按 如 下 步骤 进行 。 
人 登录 http://www.eclipse.org/aspectj/downloads.php#stable_release 站 点 , 下载 Aspect 的 最 新 稳定 
版 本 ， 本 书 下 载 Aspect 1.6.10 版 。 
人 下 载 完成 后 得 到 一 个 aspectj-1.6.10jar 文件 ， 该 文件 名 中 1.6.10 表示 Aspect 的 版 本 号 。 
@ 启动 命令 行 窗口 ， 进 入 aspectj-1.6.10jar 文件 所 在 路 径 ， 输 入 如 下 命令 : 
java -jar aspectj-1.6.1.jar 


人 @ 运行 上 面 的 命令 ， 将 看 到 如 图 8.5 所 示 的 对 话 框 。 


nstaller for AspecU 6 Developement Kie™ 
ee L410 bea oe Prewy oa 22. 2010 


Ts asaals he comrpite Anpecl 6 Deviiopemeet KE (AIDK) Gipson wth bm campaer 2apect 
raps, seme Woener 加 ni docapeomon amd etampes Ti upmeen cored ny ow 
Eee paste Lowe (we bop wow ee ai bo) 


Fer IDE meeg tome oe toacr cote we Oe popet home page ap tcpoe rp epeey 
Copyrighe (€) 1998.2001 Xerox Corporzton, 2001 Ps An Reasearch Cemtet, Iacorporated, 2003 -20 


oareors A rhe eed 
rs Cr] [ee 

图 8.5 Aspect 的 安装 界面 
外 单 击 如 图 8.5 所 示 对 话 框 中 的 “Next” 按 钮 ， 系 统 将 出 现 如 图 8.6 所 示 的 对 话 框 ， 该 对 话 框 用 


于 选择 JDK 安装 路 径 。 
aspect] 


Te eaaaer bas secceoafeay ferad toe pets ye Ja beam CDSE 14 or Benet) Ts path wl te 


图 8.6 选择 JDK 安装 路 径 
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人 @ 如 果 如 图 8.6 所 示 对 话 框 中 的 JDK 安装 路 径 正确 ， 则 直接 单 击 “Next” 按 钮 即 可 ， 否 则 应 该 
通过 右边 的 “Browse” 按 钮 来 选择 JDK 安装 路 径 。 正 确 选 择 了 JDK 安装 路 径 后 单 击 “Next” 按 钮 ， 
系统 将 出 现 如 图 8.7 所 示 的 对 话 框 ， 该 对 话 框 用 于 选择 Aspect 的 安装 路 径 。 

正如 图 8.7 所 看 到 的 ， 笔 者 没有 将 Aspecty 安装 在 C 盘 ， 甚 至 没有 安装 在 D 盘 ， 这 是 因为 Aspect 
是 “ 纯 绿色 ”软件 ， 安 装 Aspect 的 实质 是 解压 缩 了 一 个 压缩 包 ， 并 不 需要 向 Windows 注册 表 、 系 统 
路 径 里 添加 任何 “垃圾 ”信息 , 因此 保留 Aspect 安装 后 的 文件 夹 , 即使 以 后 重 装 Windows 系统 , AspectJ 


也 不 会 受到 任何 影响 。 
aspect 
克 丘 Aspect 的 家 六 相公 EC: Cea 


图 8.7 选择 Aspect 的 安装 路 径 
人 @ 选择 了 合适 的 安装 路 径 后 ， 单 击 “Install” 按 钮 ， 程 序 开始 安装 AspecU， 安 装 结束 后 出 现 一 
个 对 话 框 ， 单 击 该 对 话 框 中 的 “Next” 按 钮 ， 将 弹出 安装 完成 的 对 话 框 ， 如 图 8.8 所 示 。 


图 8.8 Aspect 安装 完成 


@ 正如 图 8.8 中 提示 的 ， 安 装 了 Aspect] 之 后 ， 系 统 还 应 该 将 E:Java\AOP\aspectj1.6\bin 路 径 添 
加 到 PATH 环境 变量 中 ， 将 E:Java\AOP\aspectj1.6\iblaspectjrtjar 添加 到 CLASSPATH 环境 变量 中 。 

Aspect 提供 了 编译 、 运 行 Aspect 的 一 些 工 具 命 令 ， 这 些 工具 命令 放 在 Aspect] 的 bin 路 径 下 ， 
而 lib 路 径 下 的 aspectjrtjar 则 是 Aspect 的 运行 时 环境 , 所 以 我 们 需要 分 别 添加 这 两 个 环境 变量 一 一 就 
像 安装 了 JDK 也 需要 添加 环境 变量 一 样 。 关 于 如 何 添加 环境 变量 , 请 参阅 疯狂 Java 体系 的 《疯狂 Java 
讲义 》 一 书 。 

2. AspectJ 使 用 入 门 

成 功 安装 了 Aspect] 之 后 ， 将 会 在 EJava\AOP\aspectj1.6 路 径 下 〔Aspect 的 安装 路 径 ) 看 到 如 下 
文件 结构 。 

> bin: 该 路 径 下 存放 了 aj、aj5、ajc、ajdoc、ajbrowser 等 命令 ， 其 中 ajc 命令 最 常用 ， 它 的 

作用 类 似 于 javac， 用 于 对 普通 Java 类 进行 编译 时 增强 。 
> docs: 该 路 径 下 存放 了 AspectJ 的 使 用 说 明 、 参 考 手册 、API 文档 等 文档 。 
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> “lib: 该 路 径 下 的 4 个 JAR 文件 是 AspectJ 的 核心 类 库 。 


> ”相关 授权 文件 。 
- 些 文档 、Aspect 入 门 书籍 ， 一 谈 到 使 用 AspecU， 就 认为 必须 使 用 Eclipse 工具 ， 似 乎 离开 了 该 


下 生计 下 二 全 Aspect 了 - 


-三 注 理 : # 
虽然 Aspect 是 Eclipse 基金 组 织 的 开源 项 目 ， 而 且 提 供 了 Eclipse 的 AJDT 插件 


(Aspect Development Tools ) 来 开发 Aspect] 应 用 ， 但 Aspect 绝对 无 须 依赖 于 Eclipse Ed 


工具 


实 Aspect] 的 用 法 非常 简单 ， 就 像 我 们 使 用 JDK 编译 、 
简单 的 程序 来 示范 Aspecty 的 用 法 。 
首先 编写 一 个 简单 的 Java 类 ， 这 个 Java 类 用 于 模拟 一 个 业务 组 件 。 
程序 清单 :codes\08\8.4\AspectJQs\Hello.java 
public class Hello 
{ 


// 定 义 一 个 简单 方法 ， 0 
Voi void sayHello() 


System.out.println("Hello AspectJ!"); 
} 
// 主 方法 ， 程 序 的 入 口 


public static void main(String[] args) 
{ 


Hello h = new Hello(); 
h.sayHello(); 
名 


上 面 的 Hello 类 模拟 了 一 个 业务 逻辑 组 件 , 编译 、 运 行 该 Java 程序 ， 这 个 结果 是 没有 任何 悬念 的 ， 
程序 将 在 控制 台 打印 “Hello AspecU ”字符 串 。 
假设 现在 客户 需要 在 执行 sayHello0) 方 法 之 前 启动 事务 ， 当 该 方法 执行 结束 时 关闭 事务 , 在 传统 编 
程 模式 下 ， 我 们 必须 手动 修改 sayHello0 方 法 一 一 如 果 改 为 使 用 AspecU， 则 可 以 无 须 修改 上 面 的 
sayHello0 方 法 。 下 面 我 们 定义 一 个 特殊 的 Java 类 。 
程序 清单 : codes\08\8.4\AspectJQs\TxAspectjava 
Public aspect TxAspect 


// 指 定 执行 Hello. sayHello() 方 法 时 执行 下 面 代码 块 
void around() :call (void Hello.sayHello()) 


tpeiatin(m 事 务 凡 家 1")7 MW 
i i 
是 可 能 读者 已 经 发 现 了 ， 上 面 的 类 文件 中 不 是 使 用 class、interface、enum 在 定义 Java 类 ,而 是 使 用 
了 aspect 一 一 难道 Java 语言 又 新 增 了 关键 字 ? 没有 ! 上 面 的 TxAspect 根本 不 是 一 个 Java 类 ,所 以 aspect 
也 不 是 Java 支持 的 关键 字 ， 它 只 是 Aspect 才能 识别 的 关键 字 。 
上 面 的 粗 体 字 代码 也 不 是 方法 ， 它 只 是 指定 当 程序 执行 Hello 对 象 的 sayHello0 方 法 时 ， 系 统 将 改 
为 执行 粗 体 字 代码 的 花 括号 代码 块 ， 其 中 proceed0 代 表 调 用 原来 的 sayHello0 方 法 。 
正如 前 面 提 到 的 ，Java 无 法 识别 TxAspectjava 文件 的 内 容 ， 所 以 我 们 要 使 用 ajc.exe 命令 来 编译 
上 面 的 Java 程序 。 
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ajc -d . Hello.java TxAspect.java 


我 们 可 以 把 ajc.exe 理解 成 javac.exe 命令 ,都 用 于 编译 Java 程序, 区 别 是 ajc.exe 命令 可 识别 AspectJ 
的 语法 ， 从 这 个 意义 上 看 ， 我 们 可 以 将 ajc.exe 当成 一 个 增强 版 的 javac.exe 命令 。 

运行 该 Hello 类 依然 无 须 任何 改变 , 因为 Hello 类 位 于 lee 包 下 。 程序 使 用 如 下 命令 运行 Hello 类 : 

java lee.Hello 

运行 该 程序 ， 将 看 到 一 个 令 人 惊喜 的 结果 : 


开始 事务 .. 
Hello AspectJ! 
事务 结束 
从 上 面 的 运行 结果 来 看 ， 我 们 完全 可 以 不 对 Hellojava 类 进行 任何 修改 ， 同 时 又 可 以 满足 客户 的 
需求 ， 上面 的 程序 只 是 在 控制 台 打 印 “ 开 始 事务 ...”、“ 结 束 事务 ...” 来 模拟 了 事务 操作 ， 实 际 上 我 们 可 
用 实际 的 事务 操作 代码 来 代替 这 两 行 简单 的 语句 ， 这 就 可 以 满足 客户 需求 了 。 
如 果 客 户 再 次 提出 新 需求 ， 需 要 在 sayHello0 方 法 后 增加 记录 日 志 的 功能 ， 那 也 很 简单 ， 我 们 再 定 
义 一 个 LogAspect， 程 序 如 下 。 
程序 清单 : codes\08\8.4\AspectJQs\LogAspect.java 
public aspect LogAspect 
{ 
// 定 义 一 个 Pointcut， 其 名 为 logPointcut 
// 访 PointCut 对 应 于 指定 Hello 对 象 的 sayHello 方法 
pointcut logPointcut() 
:execution (void Hello.sayHello()); 
// 在 logPointcut 之 后 执行 下 面 代码 块 
after () :logPointcut () 
{ 
System.out.println ("记录 日 志 . . .") 7 
) 


上 面 程序 的 粗 体 字 代码 定义 了 一 个 Pointcut logPointcut 一 一 等 同 于 执行 Hello 对 象 的 sayHello0 
方法 ， 并 指定 在 logPointcut 之 后 执行 简单 的 代码 块 ， 也 就 是 说 ， 在 sayHello0 方 法 之 后 执行 指定 代码 
块 。 使 用 如 下 命令 来 编译 上 面 的 Java 程序 : 

ajc -d . *.java 
再 次 运行 Hello 类 ， 将 看 到 如 下 运行 结果 : 


开始 事务 .. . 
Hello AspectJ! 


由 此 可 见 ， 通 过 使 用 Aspect 提供 的 AOP 支持 ， 我 们 可 以 为 sayHello0 方 法 不 断 增 加 新 功能 。 

如 果 读 者 安装 过 Java 的 反 编译 工具 ， 可 以 反 编 译 前 面 程序 生成 的 Hello.class 文件 ， 我 们 将 发 现 该 
Hello.class 文件 不 是 由 Hellojava 文件 编译 得 到 的 ,该 Hello.class 里 新 增 了 很 多 内 容 一 一 这 表明 AspectJ 
在 编译 时 已 增强 了 Hello.class 类 的 功能 ， 因 此 Aspect] 通常 被 称 为 编译 时 增强 的 AOP 框架 。 

SS 与 Aspect 相对 的 还 有 另外 一 种 AOP 框架 ， 它 们 不 需要 在 编译 时 对 目标 类 进行 增强 ， | 
”而 是 运行 时 生成 目标 类 的 代理 类 ， 该 代理 类 要 么 与 目标 类 实现 相同 的 接口 ， 要 么 是 目标 类 : 
| ”的 子 类 一 一 总 之 ， 代 理 类 都 对 目标 类 进行 了 增强 处 理 ， 前 者 是 JDK 动态 代理 的 处 理 策略 ， | 
: 后 者 是 CGLIB 代理 的 处 理 策略 .Spring AOP 以 创建 动态 代理 的 方式 来 生成 代理 类 ， 底 层 
| 。 晤 可 使 用 JDK 动态 代理 ， 也 可 采用 CGLIB 代理 .关于 创建 JDK 动态 代理 的 方式 ， 可 地 考 | 
: 疯狂 Java 体系 的 《疯狂 Java 讲义 》 的 第 18 章 。 一般 来 说 ， 编 译 时 增强 的 AOP 框架 在 性 | 
| 。 能 上 更 有 优势 一 因为 运行 时 动态 增强 的 AOP 框架 需要 每 次 运行 时 都 进行 动态 增强 
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实际 上 ，Aspect] 允许 同时 为 多 个 方法 添加 新 功能 ， 只 要 我 们 定义 Pointcut 时 指定 匹配 更 多 的 方法 
即 可 。 如 如 下 片段 : 


pointcut xxxPointcut{) 
sexecution(void H*.say* ()); 


上 面 程序 中 的 xxxPointcut 将 可 以 匹配 所 有 以 H 开头 的 类 中 、 所 有 以 say 开头 的 方法 , 但 该 方法 返 
回 的 必须 是 void; 如 果 不 想 匹 配 任意 的 返回 值 类 型 ， 则 可 将 代码 改 为 如 下 形式 : 


pointcut xxxPointcut() 
:execution(* H*.say*()); 
关于 如 何 定义 Aspect 中 的 Aspect、Pointcut 等 ， 读 者 可 以 参考 Aspect] 安装 路 径 下 的 doc 目录 里 
的 quick5,pdf 文件 。 
实际 上 ， 本 书 更 喜欢 使 用 Ant 来 管理 Aspect 应 用 ， 此 时 只 要 使 用 iajc task 来 编译 Aspect Java 程 
序 即 可 。 为 了 能 正常 使 用 iajc task， 应 该 先 使 用 taskdef 来 定义 该 task， 本 应 用 所 使 用 的 build.xml 文件 
中 有 如 下 两 段 : 
<!-- 定义 iajc task --> 
<taskdef resource= 
worg/aspectj/tools/ant/taskdefs/aspectjTaskdefs-Ppropertiesn"> 
<classpath refid="classpath"/> 
</taskdef> 
<!-- 使 用 iajc 编译 包含 AspecJ 的 Java 程序 --> 
<iajc destdir="${dest}" debug="true" 
deprecation="false" failonerror="true"> 
<src path="$ {src}"/> 
<classpath refid="classpath"/> 
</iajc> 


需要 指出 的 是 ， 如 果 开发 者 希望 在 Ant 中 使 用 上 面 的 iaje task， 则 应 该 将 Aspect 安装 目录 下 
aspectjtools.jar 文件 添加 的 系统 的 类 加 载 路 径 中 。 


>>8.4.3 AOP 的 基本 概念 


AOP 从 程序 运行 角度 考虑 程序 的 流程 , 提取 业务 处 理 过 程 的 切面 。AOP 面向 的 是 程序 运行 中 各 个 
步骤 ， 希 望 以 更 好 的 方式 来 组 合 业 务 处 理 的 各 个 步骤 。 
AOP 框架 并 不 与 特定 的 代码 耦合 ，AOP 框架 能 处 理 程序 执行 中 特定 切入 点 〈Pointcut)， 而 不 与 具 
体 某 个 具体 类 耦合 。AOP 框架 具有 如 下 两 个 特征 : 
> 各 步骤 之 间 的 良好 隔离 性 。 
> ” 源 代码 无 关 性 。 
下 面 是 关于 面向 切面 编程 的 一 些 术语 。 
> 切面 (Aspect) : 业务 流程 运行 的 某 个 特定 步骤 ， 也 就 是 应 用 运行 过 程 的 关注 点 ， 关 注 点 可 
能 横 切 多 个 对 象 ， 所 以 常常 也 称 为 横 切 关注 点 。 
> ”连接 点 (Joinpoint) : 程序 执行 过 程 中 明确 的 点 , 如 方法 的 调用 , 或 者 异常 的 抛 出 。 Spring AOP 
中 ， 连 接点 总 是 方法 的 调用 。 
> “增强 处 理 (Advice) : AOP 框架 在 特定 的 切入 点 执行 的 增强 处 理 。 处 理 有 “around”、“before” 
和 “after” 等 类 型 。 
> 切入 点 (Pointcut) : 可 以 插入 增强 处 理 的 连接 点 。 简 而 言 之 ， 当 某 个 连接 点 满足 指定 要 求 
时 ， 该 连接 点 将 被 添加 增强 处 理 ， 该 连接 点 也 就 变 成 了 切入 点 。 例 如 如 下 代码 : 


pointcut xxxPointcat () 
:execution (void H*.say*()) 


每 个 方法 被 调用 都 只 是 连接 点 ， 但 如 果 该 方法 属于 H 开头 的 类 ， 且 方法 名 以 say 开头 ， 按 该 方法 的 
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执行 将 变 成 切入 点 。 如何 使 用 表达 式 来 定义 切入 点 是 AOP 的 核心 , Spring 默认 使 用 Aspect 切入 点 语法 。 
> ”引入 : 将 方法 或 字段 添加 到 被 处 理 的 类 中 。Spring 允许 引入 新 的 接口 到 任何 被 处 理 的 对 象 。 
例如 ， 你 可 以 使 用 一 个 引入 ， 使 任何 对 象 实现 IsModified 接口 ， 以 此 来 简化 缓存 。 
> 目标 对 象 : 被 AOP 框架 进行 增强 处 理 的 对 象 ， 也 被 称 为 被 增强 的 对 象 。 如 果 AOP 框架 是 通 
过 运行 时 代理 来 实现 的 ， 那 么 这 个 对 象 将 是 一 个 被 代理 的 对 象 。 
> AOP 代理 : AOP 框架 创建 的 对 象 , 简单 地 说 , 代理 就 是 对 目标 对 象 的 加 强 。 Spring 中 的 AOP 
代理 可 以 是 JDK 动态 代理 ， 也 可 以 是 CGLIB 代理 。 前 者 为 实现 接口 的 目标 对 象 的 代理 ， 后 
者 为 不 实现 接口 的 目标 对 象 的 代理 。 
> 织 入 (Weaving) : 将 增强 处 理 添加 到 目标 对 象 中 ， 并 创建 一 个 被 增强 的 对 象 (AOP 代理 ) 
的 过 程 就 是 织 入 。 织 入 有 两 种 实现 方式 : 编译 时 增强 (例如 AspectJ) 和 运行 时 增强 〈 例 如 
CGLIB) 。Spring 和 其 他 纯 Java AOP 框架 一 样 ， 在 运行 时 完成 织 入 。 


面向 切面 编程 是 比较 前 沿 的 知识 ， 而 大 部 分 国内 翻译 人 士 翻译 计算 机 文献 时 ， 总 是 
一 边 看 着 各 种 词典 、 翻 译 软件 ， 一 边 逐 词 去 看 文献 ， 不 是 先 从 总 体 上 把 握 知识 的 架构 。 
因此 难免 导致 一 些 术语 的 翻译 词 不 达意 ， 例 如 Socket 被 翻译 成 “ 套 接 字 ” 等 。 在 面向 切 
面 编程 的 各 术语 翻译 上 ， 也 存在 较 大 的 差异 。 对 于 Advice 一 词 ， 有 翻译 为 “通知 ”的 ， 
有 翻译 为 “建议 ”的 ， 如 此 种 种 ， 不 一 而 足 。 实 际 上 ，Advice 指 AOP 框架 在 特定 切面 
所 加 入 的 某 种 处 理 ,笔者 以 前 翻译 为 处 理 , 现在 翻译 为 增强 处 理 , 希望 可 以 表达 出 Advice 本 


的 真正 含义 


| 
| 
| 
| 
bs 


Te 


由 前 面 的 介绍 知道 : AOP 代理 其 实 是 由 AOP 框架 动态 生成 的 一 个 
AOP 棋 架 织 A 的 坊 鸡 | 理 | 对象， 该 对 象 可 作为 目标 对 象 使 用 。AOP 代理 包含 了 目标 对 象 的 全 前 
方法 ,但 AOP 代理 中 的 方法 与 目标 对 象 的 方法 存在 差异 : AOP 方法 在 
特定 切入 点 添加 了 增强 处 理 ， 并 回调 了 目标 对 象 的 方法 。 
AOP 代理 所 包含 的 方法 与 目标 对 象 的 方法 示意 图 如 图 8.9 所 示 。 


AOPIERRNla 理 | 为 8.4.4 Spring 的 AOP 支持 


生生 一 er， 


图 8.9 AOP 代理 的 方法 与 Spring 中 AOP 代理 由 Spring 的 IoC 容器 负责 生成 、 管 理 ， 其 依赖 

目标 对 象 的 方法 关系 也 由 IoC 容器 负责 管理 。 因 此 ，AOP 代理 可 以 直接 使 用 容器 中 的 

其 他 Bean 实例 作为 目标 ， 这 种 关系 可 由 IoC 容器 的 依赖 注入 提供 。Spring 默认 使 用 Java 动态 代理 来 
创建 AOP 代理 ， 这 样 就 可 以 为 任何 接口 实例 创建 代理 了 。 

Spring 也 可 以 使 用 CGLIB 代理 , 在 需要 代理 类 而 不 是 代理 接口 的 时 候 ，Spring 自动 会 切换 为 使 用 
CGLIB 代理 。 但 Spring 推荐 使 用 面向 接口 编程 ， 因 此 业务 对 象 通常 都 会 实现 一 个 或 多 个 接口 ， 此 时 默 
认 将 使 用 JDK 动态 代理 ， 但 也 可 强制 使 用 CGLIB。 

Spring AOP 使 用 纯 Java 实现 。 它 不 需要 专门 的 编译 过 程 。Spring AOP 不 需要 控制 类 装载 器 层次 ， 
因此 它 可 以 在 所 有 Java Web 容器 或 应 用 服务 器 中 运行 良好 。 

Spring 目前 仅 支持 将 方法 调用 作为 连接 点 (Joinpoint)， 如 果 需 要 把 对 Field 的 访问 和 更 新 也 作为 
增强 处 理 的 连接 点 ， 则 可 以 考 虚 使 用 AspecU 。 

Spring 实现 AOP 的 方法 跟 其 他 的 框架 不 同 . Spring 并 不 是 要 提供 最 完整 的 AOP 实现 (尽管 Spring 
AOP 有 这 个 能 力 )，Spring 侧重 于 AOP 实现 和 Spring IoC 容器 之 间 的 整合 ， 用 于 帮助 解决 在 企业 级 开 
发 中 的 常见 问题 。 

因此 , Spring 的 AOP 通常 和 Spring IoC 容器 一 起 使 用 , Spring AOP 从 来 没有 打算 通过 提供 一 种 全 
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面 的 AOP 解决 方案 来 与 Aspect 竞争 。Spring AOP 采用 基于 代理 的 AOP 实现 方案 ,而 Aspect] 则 采用 
编译 时 增强 的 解决 方案 。 

Spring 2.0 可 以 无 颖 地 整合 Spring AOP、IoC 和 AspectJ, 使 得 所 有 的 AOP 应 用 完全 融入 基于 Spring 
的 框架 ,这 样 的 集成 不 会 影响 Spring AOPAPI 或 者 AOP Alliance API，Spring AOP 保持 了 向 下 兼容 性 ， 
依然 允许 直接 使 用 Spring AOP API 来 完成 AOP 编程 。 

- 旦 我 们 掌握 了 上 面 AOP 的 相关 概念 ， 不 难 发 现 进行 AOP 编程 其 实 是 很 简单 的 事情 。 纵 观 AOP 

编程 ， 其 中 需要 程序 员 参 与 的 只 有 三 个 部 分 : 

> ”定义 普通 业务 组 件 。 

> ”定义 切入 点 ， 一 个 切入 点 可 能 横 切 多 个 业务 组 件 。 

> ”定义 增强 处 理 ， 增 强 处 理 就 是 在 AOP 框架 为 普通 业务 组 件 织 入 的 处 理 动作 。 

上 面 三 个 部 分 的 第 一 个 部 分 是 最 平常 不 过 的 事情 , 所 以 无 须 额外 说 明 。 那么 进行 AOP 编程 的 关键 
就 是 定义 切入 点 和 定义 增强 处 理 。 一旦 定义 了 合适 的 切入 点 和 增强 处 理 , AOP 框架 将 会 自动 生成 AOP 
代理 ， 而 AOP 代理 的 方法 大 致 有 如 下 公式 : 

代理 对 象 的 方法 = 增强 处 理 + 被 代理 对 象 的 方法 

Spring 1. X 采用 自身 提供 的 AOP API 来 定义 切入 点 和 增强 处 理 ， 这 种 方式 似乎 有 些 过 时 了 。 现 在 
通常 建议 使 用 Aspect 方式 来 定义 切入 点 和 增强 处 理 ， 在 这 种 方式 下 ，Spring 依然 有 如 下 两 种 选择 来 
定义 切入 点 和 增强 处 理 。 

> ”基于 Annotation 的 “ 零 配 置 ”方式 : 使 用 @Aspect、@Pointcut 等 Annotation 来 标注 切入 点 

和 增强 处 理 。 

> 基于 XML 配置 文件 的 管理 方式 :使 用 Spring 配置 文件 来 定义 切入 点 和 增强 处 理 。 

Spring 1.X 系列 提供 了 自己 的 AOPAPI 实现 ， 程 序 也 可 直接 使 用 Spring AOP API 来 定义 切入 点 和 
增强 处 理 ， 完 全 无 须 Aspect 支持 。 本 书 不 打算 介绍 Spring AOP API 的 用 法 ， 如 果 读 者 对 它们 感 兴趣 ， 
请 选择 参考 本 书 第 一 版 ， 或 直接 阅读 Spring 官方 提供 的 参考 手册 。 


>>8.4.5 基于 Annotation 的 “ 零 配置 ”方式 


Aspect 允许 使 用 Annotation 用 于 定义 切面 、 切 入 点 和 增强 处 理 ， 而 Spring 框架 则 可 识别 并 根据 
这 些 Annotation 来 生成 AOP 代理 。Spring 只 是 使 用 了 和 Aspect 5 一 样 的 注解 , 但 并 没有 Aspect 的 编 
译 器 或 者 织 入 器 ， 底 层 依然 使 用 的 是 Spring AOP， 依 然 是 在 运行 时 动态 生成 AOP 代理 ， 并 不 依赖 于 
Aspect] 的 编译 器 或 者 织 入 器 。 

站. 简单 地 说 ，Spring 依然 采用 运行 时 生成 动态 代理 的 方式 来 增强 目标 对 象 ， 所 以 它 不 需 ， 
要 增加 额外 的 编译 ， 也 不 需要 Aspect 的 织 入 器 支持 ; 而 Aspect 在 采用 编译 时 增强 ， 所 以 | 
| 。 Aspecty 需要 使 用 自己 的 编译 器 来 编译 Java 文件 ， 还 需要 织 入 器 。 j 


为 了 启用 Spring 对 @Aspect 切面 配置 的 支持 , 并 保证 Spring 容器 中 的 目标 Bean 被 一 个 或 多 个 切 
面 自动 增强 ， 必 须 在 Spring 配置 文件 中 配置 如 下 片段 : 


<?xml version="1.0" encoding="GBK"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

mlns:aop="http://w™w. springframework .org/schema/aop" 

xsi:schemaLocation="http://wuw.springframework.org/schema/beans 

http://www. springframework.org/schema/beans/spring-beans-3.0.xsd 
:// nm. springframework.org/schema/aop 

ww. springframework.org/schema/aop/spring-aop-3.0.xsd"> 

!-- 启动 EAspectJ 支持 --> 

<aop:aspecti-autoproxy/> 
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</beans> 
当然 ， 如 果 我 们 希望 完全 启动 Spring 的 “ 零 配置 ”功能 ， 则 还 需要 采用 如 82 节 所 示 的 方式 进行 
配置 。 
人 = 
6 所 谓 自动 增强 ， 指 的 是 Spring 会 判断 一 个 或 多 个 切面 是 否 需要 对 指定 Bean 进行 增强 ， 
并 所 此 自动 生成 应 的 代理 ， 从 而 全 得 增强 处 理 在 合 过 的 时 候补 调用 | 
如 果 不 打算 使 用 Spring 的 XML Schema 配置 方式 , 则 应 该 在 Spring 配置 文件 中 增加 如 下 片段 来 启 


用 @Aspect 支持 。 


<!-- 启动 eAspectJ 支 持 --> 
<bean class="org.springframework.aop.aspectj.annotation. 
MnnotationAwareAspectJAutoProxyCreator"/> 


上 面 的 配置 文件 中 的 AnnotationAwareAspectJAutoProxyCreator 是 一 个 Bean 后 处 理 器 , 该 Bean 后 
处 理 器 将 会 为 容器 中 Bean 生成 AOP 代理 ， 

为 了 在 Spring 应 用 中 启动 @Aspect] 支持 ， 还 需要 在 应 用 的 类 加 载 路 径 中 增加 两 个 Aspect] 库 : 
aspectjweaverjar 和 aspectjrtjar， 直 接 使 用 Aspect 安装 路 径 的 lib 目录 下 的 两 个 JAR 文件 即 可 。 当 然 ， 
a Spring 解压 缩 文 件 夹 的 lib/aspectj 路 径 下 找到 它们 。 

， 定 义 切 面 Bean 
TAN 支持 后 ， 只 要 我 们 在 Spring 容器 中 配置 一 个 带 @Aspect 注释 的 Bean，Spring 


提示 : 
在 Spring 容器 中 配置 切面 Bean ( 即 带 @Aspect 注释 的 Bean )， 与 配置 普通 Bean 没有 : 
任何 区 别 ， 一 样 使 用 <bean..…/> 元 素 进行 配置 ， 一 样 支持 使 用 依赖 注入 来 配置 属性 值 ， 如 果 | 


使 用 @Aspect 标注 一 个 Java 类 ， 该 Java 类 将 会 作为 切面 Bean， 如 下 面 的 代码 片段 所 示 。 
// 使 用 &Aspect 定义 一 个 切面 类 
QAspect 
public class LogAspect 
// 定 义 该 类 的 其 他 内 容 
ee > 
切面 类 (用 @Aspect 修饰 的 类 ) 和 其 他 类 一 样 可 以 有 方法 、 属 性 定义 ， 还 可 能 包括 切入 点 、 增 强 
处 理 定义 。 
当 我 们 使 用 @Aspect 来 修饰 一 个 Java 类 之 后 ，Spring 将 不 会 把 该 Bean 当成 组 件 Bean 处 理 ， 因 此 
负责 自动 增强 的 后 处 理 Bean 将 会 略 过 该 Bean， 不 会 对 该 Bean 进行 任何 增强 处 理 。 
开发 时 无 须 担心 使 用 @Aspect 定义 的 切面 类 被 增强 处 理 ， 当 Spring 容器 检测 到 某 个 Bean 类 使 用 
了 @Aspect 标注 之 后 ，Spring 容器 不 会 对 该 Bean 类 进行 增强 。 
2. 定义 Before 增强 处 理 
当 我 们 在 一 个 切面 类 里 使 用 @Before 来 标注 一 个 方法 时 ， 该 方法 将 作为 Before 增强 处 理 。 使 用 
@Before 标注 时 ， 通 常 需 要 指定 一 个 value 属性 值 ， 该 属性 值 指定 一 个 切入 点 表达 式 〈 既 可 以 是 一 个 
已 有 的 切入 点 ， 也 可 以 直接 定义 切入 点 表达 式 )， 用 于 指定 该 增强 处 理 将 被 织 入 哪些 切入 点 。 
下 面 的 Java 类 里 使 用 @Before 定义 了 一 个 Before 增强 处 理 。 
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程序 清单 : codes\08\8.4\Before\src\org\crazyit\app\advice\BeforeAdviceTest.java 
// 定 义 一 个 切面 


Rspect 
public class BeforehdviceTest 


{ 
// 区 配 org.crazyit.app.service.impl 包 下 所 有 类 的 、 
// 所 有 方法 的 执行 作为 切入 点 
QBefore("execution(* org.crazyit.app. service. impl.*.4(..))") 
public void authority() 1 


{ 
System.out .println ("模拟 执行 权限 检查 ") ; 
1 
} 


上 面 的 程序 使 用 @Aspect 修饰 了 BeforeAdviceTest 类 ， 这 表明 该 类 是 一 个 切面 类 ， 在 该 切面 里 定 
义 了 一 个 authority() 方 法 一 一 这 个 方法 本 来 没有 任何 特殊 之 处 ， 但 因为 使 用 了 @Before 来 标注 该 方法 ， 
这 就 将 该 方法 转换 成 一 个 Before 增强 处 理 。 
上 面 的 程序 中 使 用 @Before Annotation 时 ， 直 接 指 定 了 切入 点 表达 式 ， 指 定 匹 配 
org.crazyit.app.service.impl 包 下 所 有 类 的 所 有 方法 的 执行 作为 切入 点 。 
本 应 用 在 org.crazyit.app.service.impl 包 下 定义 了 一 个 Chinese 类 ， 该 类 使 用 了 @Component 
Annotation 进行 标注 。 下 面 是 Chinese 类 的 代码 。 
程序 清单 : codes\08\8.4\Before\src\org\crazyit\app\service\impl\Chinese.java 
QComponent 
public class Chinese 
implements Person 
{ 


// 实 现 Person 接口 的 sayHello() 方法 
public String sayHello(String name) 


// 返 回 简单 的 字符 串 
return name + " Hello , Spring AOP"; 


} 

7/ 定义 一 个 eat () 方 法 

Public void eat (String food) 

{ 

system.out.printin(" 我 正在 吃 :" 
+ foo0d); 
} 
} 


从 上 面 的 Chinese 类 代码 来 看 ， 它 是 一 个 如 此 “纯净 ”的 Java 类 ， 它 丝毫 不 知道 它 将 被 谁 来 进行 
增强 ， 也 不 知道 将 被 进行 怎样 的 增强 一 一 但 正 因为 Chinese 类 这 种 “无 知 "， 才 是 AOP 的 最 大 魅力 : 
目标 类 可 以 被 无 限 地 增强 。 

在 Spring 配置 文件 中 配置 自动 搜索 Bean 组 件 ， 配 置 自动 搜索 切面 类 ，Spring AOP 自动 对 Bean 
组 件 进行 增强 。 下 面 是 Spring 配置 文件 代码 。 

程序 清单 : codes\08\8.4\Before\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> wr 

<beans xmlns="http://wuw.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance” 
xmlns:context="http://www. springframework.org/schema/context" 

aop="http://www. springframework.org/schema/aop" 

:schemaLocation="http://www.springframework.org/schema/beans 

http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 

http://www.springframework.org/schema/context 

http://waw. springframework.org/schema/context/spring-context-3.0.xsd 

http://www. springframework.org/schema/aop 

://www. springframework.org/schema/aop/spring-aop-3.0.xsd"> 

<!-- 指定 自动 搜索 Bean 组 件 、 自 动 搜 索 切面 类 --> 


<context: component-scan base-package="org.crazyit.app. service 
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,org.crazyit.app.advice"> 
<context:include-filter type="annotation" 
expression="org.aspectj.lang.annotation.Aspect"/> 
</context:component-scan> 
<!-- 户 动 EAspectJ 支 持 --> 
<aop:aspectj-autoproxy/> 
</beans> 


主 程序 非常 简单 ， 通 过 Spring 容器 获取 chinese Bean， 并 调用 了 该 Bean 的 sayHello0 和 eat0 两 个 
方法 。 执 行 主 程序 ， 将 看 到 如 图 8.10 所 示 的 效果 。 


ello ,Spring AOP 


一 一 


图 8.10 使 用 Before 增强 处 理 的 效果 


- 交 - 注意 :w 


ER 
使 用 Before 增强 处 理 只 能 在 目标 方法 执行 之 前 织 入 增强 ， 使 用 Before 增强 处 理 无 须 


理会 目标 方法 的 执行 ， 所 以 Before 处 理 无 法 阻止 目标 方法 的 执行 Before 增强 处 理 执行 < 
时 ， 目 标 方法 还 未 获得 执行 的 机 会 ， 所 以 Before 增强 处 理 无 法 访问 目标 方法 的 返回 值 。 by 


3. 定义 AfterReturning 增强 处 理 
类 似 于 使 用 @Before Annotation 可 标注 Before 增强 处 理 ， 使 用 @AfterReturning 来 标注 一 个 
AfterReturning 增强 处 理 ，AfterRetuming 增强 处 理 将 在 目标 方法 正常 完成 后 被 织 入 。 
使 用 @AfterReturning Annotation 时 可 指定 如 下 两 个 常用 属性 。 
> ”pointcutvalue: 这 两 个 属性 的 作用 是 一 样 的 ， 它 们 都 用 于 指定 该 切入 点 对 应 的 切入 表达 式 。 
- 样 既 可 是 一 个 已 有 的 切入 点 ， 也 可 直接 定义 切入 点 表达 式 。 当 指定 了 pointcut 属性 值 后 ， 

value 属性 值 将 会 被 覆盖 。 

> returning: 指定 一 个 返回 值 形 参 名 ， 增 强 处 理 定义 的 方法 可 通过 该 形 参 名 来 访问 目标 方法 的 
返回 值 。 

下 面 的 程序 定义 了 一 个 AfterReturning 增强 处 理 。 

程序 清单 :codes\08\8.4\AfterReturning\src\org\crazyit\app\advice\AfterReturningAdviceTest.java 

// 定 义 一 个 切面 


@Aspect 
Public class AfterReturningAdviceTest 


71/ 匹配 org:crazyit.app.service.impl 包 下 所 有 类 的 、 


// 所 有 方法 的 执行 作为 切入 点 
QAfterReturning (returning="rvt" 
, pointcut="execution(* org.crazyit.app.service.impl.*.*(..))") 


public void log (Object rvt) 
{ 
System.out .println ("获取 目标 方法 返回 值 :" + rvt); 
System.out .println(" 模 拟 记 录 日 志 功 能 . .."); 
| 
} 
正如 上 面 的 程序 中 看 到 的 , 程序 中 使 用 @AfterReturning Annotation 时 , 指定 了 一 个 returing 属性 ， 
该 属性 值 为 vt， 这 表明 允许 在 增强 处 理 方法 〈log 方法 ) 中 使 用 名 为 rvt 的 形 参 ， 该 形 参 代表 目标 方法 


的 返回 值 。 
该 应 用 的 目标 Bean 类 依然 是 一 个 简单 的 Java 类 ， 只 是 对 上 一 个 Java 类 进行 了 简单 改写 ， 此 处 不 
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再 给 出 该 Java 类 的 代码 。 
运行 该 应 用 的 主 程序 ， 将 看 到 如 图 8.11 所 示 的 效果 。 


图 8.11 使 用 AfterRetuming 增强 处 理 的 效果 


@AfterRetuming Annotation 的 retuming 属性 所 指定 的 形 参 名 必须 对 应 于 增强 处 理 中 的 一 个 形 参 
名 ， A 返回 值 作为 相应 的 参数 值 传 入 增强 处 理 方法 。 


re 过 二 Ra ee 
使 用 returning 属性 还 有 一 - 个 额外 的 作用: 它 可 用 于 限定 切入 


值 类 型 的 方法 一 一 假如 在 上 面 的 log0) 方 法 中 定义 rvt 形 参 的 类 型 是 String, 则 该 切入 点 只 


匹配 具有 对 应 返回 


i 
| 匹配 lee 包 下 返回 值 类 型 为 String 的 所 有 方法 . 当然， 上面 log0 方 法 的 rvt 形 参 的 类 型 是 。 | 
| 
上 


的 返回 值 . 


增强 处 理 可 以 访问 到 目 的 返回 值 ， 但 它 不 可 以 改变 目 


Object， 这 表明 该 切入 点 可 匹配 任何 返回 值 类 型 的 方法 。 除 此 之 外 ， 虽 然 AfterReturning 


4. 定义 AfterThrowing 增强 处 理 
使 用 @AfterThrowing Annotation 可 用 于 标注 一 个 AfterThrowing 增强 处 理 ，AfterThrowing 增强 处 
理 主要 用 于 处 理 程序 中 未 处 理 的 异常 。 
使 用 @ AfterThrowing Annotation 时 可 指定 如 下 两 个 常用 属性 。 
> ”pointcut/value: 这 两 个 属性 的 作用 是 一 样 的 ， 它 们 都 用 于 指定 该 切入 点 对 应 的 切入 表达 式 。 
- 样 既 可 是 一 个 已 有 的 切入 点 ， 也 可 直接 定义 切入 点 表达 式 。 当 指定 了 pointcut 属性 值 后 ， 
value 属性 值 将 会 被 覆盖 。 
> ”throwing: 指定 一 个 返回 值 形 参 名 ， 增 强 处 理 定义 的 方法 可 通过 该 形 参 名 来 访问 目标 方法 中 
所 抛 出 的 异常 对 象 。 
下 面 的 程序 定义 了 一 个 AfterThrowing 增强 处 理 。 
程序 清单 :codes\08\8.4\AfterThrowing\src\org\crazyit\app\advice\AfterThrowingAdviceTestjava 
// 定 义 一 个 切面 


@Aspect 
public class AfterThrowingAdviceTest 


{ 有 
// 匹 配 org,crazyit .app.service.impl 包 下 所 有 类 的 、 
// 所 有 方法 的 执行 作为 切入 点 3 
BAfterThrowing (throwing="ex" 诈 
+ pointcut="execution(* org.crazyit.app.service.impl.*.*(. ))") 
public void doRecoveryActions (Throwable ex) 
{ 
System.out .println(" 目 标 方法 中 抛 出 的 异常 :”+ 人 
和光 out ee sk ni 
} 
} 


正如 上 面 的 程序 中 看 到 的 , 程序 中 使 用 @AfterThrowing Annotation 时 , 指定 了 一 个 throwing 属性 ， 
该 属性 值 为 ex， 这 人 允许 在 增强 处 理 方法 (doRecoveryActions 方法 ) 中 使 用 名 为 ex 的 形 参 ， 该 形 参 代 
表 目 标 方法 所 抛 出 的 异常 。 
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该 示例 程序 中 目标 类 的 程序 如 下 。 

程序 清单 : codes\08\8.4\AfterThrowing\src\org\crazyit\app\service\impl\Chinese.java 
ecomponent 
public class Chinese implements Person 


{ 
// 实 现 Person 接口 的 sayHello() 方 法 
public string sayHello(String name) 


{ 
// 该 方法 体内 虽然 抛 出 了 异常 ， 但 该 方法 
// 自 己 处 理 了 该 异常 ， 所 以 AOP 不 会 对 该 异常 进行 处 理 
try 
{ 
system.out .printin ("sayHello 方法 开始 被 执行 . . .”) 


new java.io.FileInputstrean("a. txt") 7 
F ' 
catch (Exception ex) 
{ 


System.out.println(" 目 标 类 的 异常 处 理 " 
+ ex.getMessage()); 


} 
// 返 回 简单 的 字符 趾 
return name + " Hello , Spring AOP"; 


} 
// 定 义 一 个 divide () 方 法 
public void divide () 
{ 
int a=5/0; 
System.out .println ("divide 执行 完成 ! "); 
} 
) 


上 面 的 程序 中 的 sayHello0 和 divide0 两 个 方法 都 会 抛 出 异常 , 但 sayHello0 方 法 中 异常 将 由 该 方法 
显 式 捕捉 ， 所 以 Spring AOP 不 会 处 理 该 异常 ， 而 divide() 方 法 将 抛 出 一 个 ArithmeticException 异常 ， 
且 该 异常 没有 被 任何 程序 所 处 理 ， 故 Spring AOP 会 对 该 异常 进行 处 理 。 

该 示例 程序 的 主 程序 没有 任何 改变 ， en a 8.12 关于 


[java] Exception in thread "nain” java lang.ArithaeticException: / by ze 
at lee. Chinese. divide(Chinese. java:39) 
ad i 
1 fava] at sun. reflect. NativeMethodAccessorIapl. pencil i 


图 8.12 使 用 AfterThrowing 增强 处 理 的 效果 
正如 在 图 8.12 中 所 看 到 的 , @AfterThrowing Annotation 的 throwing 属性 中 指定 的 参数 名 必须 与 增 
强 处 理 方法 内 的 一 个 形 参 对 应 。 当 目标 方法 抛 出 一 个 未 处 理 的 异常 时 ， 该 异常 将 会 作为 对 应 的 参数 传 
给 增强 处 理 方法 的 方法 。 


人 
-六 -注意 :w … 

使 用 throwing 属性 还 有 一 个 额外 的 作用 : 它 可 用 于 限定 切入 点 只 匹配 指定 类 型 的 异 
常 一 假如 在 上 面 的 doRecoveryActions0 方 法 中 定义 了 ex 形 参 的 类 型 是 NullPointer- 
Exception， 则 该 切入 点 只 匹配 抛 出 NullPointerException 异常 的 情况 。 上 面 doRecovery- < 
Actions() 方 法 的 ex 形 参 类 型 是 Throwable， db 攻取 相册 任何 并 全 四 精 4 


从 图 8.12 还 可 看 出 ，AOP 的 AfterThrowing 处 理 虽然 可 以 对 目标 方法 的 异常 进行 处 理 ， 但 这 种 处 
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理 与 直接 使 用 catch 捕捉 不 同 ，catch 捕捉 意味 着 完全 处 理 该 异常 ， 如 果 catch 块 中 没有 重新 抛 出 新 异 
常 ， 则 该 方法 可 以 正常 结束 : 而 AfterThrowing 处 理 虽 然 处 理 了 该 异常 ， 但 它 不 能 完全 处 理 该 异常 ， 
该 异常 依然 会 传播 到 上 一 级 调用 者 〈 本 示例 程序 中 直接 传播 到 JVM， 故 导致 程序 中 止 )。 

5， After 增强 处 理 

Spring 还 提供 了 一 个 After 增强 处 理 ， 它 与 AfterReturning 增强 处 理 有 点 相似 ， 但 也 有 区 别 : 

> ”AfterReturning 增强 处 理 只 有 在 目标 方法 成 功 完成 后 才 会 被 织 入 。 

> ”After 增强 处 理 不 管 目标 方法 如 何 结束 (包括 成 功 完成 和 遇 到 异常 中 止 两 种 情况 ) ， 它 都 会 被 

织 入 。 

因为 不 论 一 个 方法 是 如 何 结束 的 ，After 增强 处 理 都 会 被 织 入 ， 因 此 After 增强 处 理 必须 准备 处 理 
正常 返回 和 异常 返回 两 种 情况 ， 这 种 增强 处 理 通常 用 于 释放 资源 。 

使 用 @After Annotation 标注 一 个 方法 ， 即 可 将 该 方法 转 成 After 增强 处 理 。 使 用 @After Annotation 
时 需要 指定 一 个 value 属性 ， 该 属性 值 用 于 指定 该 增强 处 理 被 织 入 的 切入 点 ， 既 可 是 一 个 已 有 的 切入 
点 ， 也 可 直接 指定 切入 点 表达 式 。 

下 面 的 程序 将 定义 一 个 After 增强 处 理 。 

程序 清单 : codes\08\8.4\After\src\org\crazyit\app\advice\AfterAdviceTest.java 


// 定 义 一 个 切面 
@Aspect 
Public class AfterAdviceTest 
{ 
// 匹 配 org.crazyit,app.service 包 下 所 有 类 的 、 
// 所 有 方法 的 执行 作为 切入 点 
QAfter ("execution(* org.crazyit.app.service.*#.*#(..))") 
Public void release() 


{ 
System,out.Println{(" 模 拟 方法 结束 后 的 释放 资源 . . .") ; 
} 
} 


上 面 的 程序 中 粗 体 字 代 码 定 义 了 一 个 After 增强 处 理 ， 不 管 切入 点 的 目标 方法 如 何 结束 ， 该 增强 
处 理 都 会 被 织 入 。 该 示例 程序 的 目标 对 象 依然 使 用 Chinese 类 ，Chinese 类 中 sayHello0 方 法 可 以 正常 
结束 ， 但 divide0 方 法 将 因为 抛 出 异常 而 结束 。 

主 程序 执行 Chinese 对 象 的 两 个 方法 ， 将 可 以 看 到 如 图 8.13 所 示 的 效果 。 


javaj sayHello 方 法 开 | 本 
[java] 目标 闫 的 异常 处 理 a txt (系统 找 不 到 指定 的 文件 。) 


avaj 张 三 Hello 。 Spring AOP 


[java] Bxception in thread “nain” java lang. ArithaeticBxception: / by ze 
[java] at lee. Chinese. divide(Chinese. java:39) 
[java] 。 at sun reflect.NativellethodAccessorInpl. invcke0 (Native rae 


图 8.13 使 用 After 增强 处 理 的 效果 


从 图 8.13 中 可 以 看 出 ， 虽 然 divide 方法 因为 ArithemeticException 异常 结束 ， 但 After 增强 处 理 依 
然 被 正常 织 入 。 由 此 可 见 , After 增强 处 理 的 作用 非常 类 似 于 异常 处 理 中 finally 块 的 作用 一 一 无 论 如 何 ， 
它 总 会 在 方法 执行 结束 之 后 被 织 入 ， 因 此 特别 适用 于 进行 资源 回收 。 

6. Around 增强 处 理 

@Around Annotation 用 于 标注 Around 增强 处 理 ，Around 增强 处 理 是 功能 比较 强大 的 增强 处 理 ， 
它 近 似 等 于 Before 增强 处 理 和 AfterRetuming 增强 处 理 的 总 和 ，Around 增强 处 理 既 可 在 执行 目标 方法 
之 前 织 入 增强 动作 ， 也 可 在 执行 目标 方法 之 后 织 入 增强 动作 。 
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与 Before 增强 处 理 、AfterRetuming 增强 处 理 不 同 的 是 ，Around 增强 处 理 甚至 可 以 决定 目标 方法 
在 什么 时 候 执 行 ， 如 何 执行 ， 甚 至 可 以 完全 阻止 目标 方法 的 执行 。 

Around 增强 处 理 可 以 改变 执行 目标 方法 的 参数 值 ， 也 可 改变 执行 目标 方法 之 后 的 返回 值 。 

Around 增强 处 理 的 功能 虽然 强大 ,但 通常 需要 在 线程 安全 的 环境 下 使 用 。 因 此 ， 如 果 使 用 普通 的 
Before 增强 处 理 、AfterRetuming 增强 处 理 就 能 解决 的 问题 ， 就 没有 必要 使 用 Around 增强 处 理 了 。 如 
果 需 要 目标 方法 执行 之 前 和 之 后 共享 某 种 状态 数据 ， 则 应 该 考虑 使 用 Around 增强 处 理 ， 尤 其 是 需要 
使 用 增强 处 理 阻止 目标 的 执行 ， 或 需要 改变 目标 方法 返回 值 时 ， 则 只 能 使 用 Around 增强 处 理 了 。 

Around 增强 处 理 方法 应 该 使 用 @Around 来 标注 ， 使 用 @Around Annotation 时 需要 指定 一 个 value 
属性 ， 该 属性 指定 该 增强 处 理 被 织 入 的 切入 点 。 

当 定义 一 个 Around 增强 处 理 方法 时 ， 该 方法 的 第 一 个 形 参 必须 是 ProceedingJoinPoint 类 型 (至少 
包含 一 个 形 参 )， 在 增强 处 理 方法 体内 ， 调 用 ProceedingJoinPoint 的 proceed() 方 法 才 会 执行 目标 方法 
这 就 是 Around 增强 处 理 可 以 完全 控制 目标 方法 执行 时 机 、 如 何 执行 的 关键 ， 如果 程序 没有 调用 
ProceedingJoinPoint 的 proceed0 方 法 ， 则 目标 方法 不 会 被 执行 。 

调用 ProceedingJoinPoint 的 proceed() 方 法 时 , 还 可 以 传 入 一 个 Object 对 象 ， 该 数组 中 的 值 将 被 传 
入 目标 方法 作为 执行 方法 的 实 参 。 

下 面 的 程序 定义 了 一 个 Around 增强 处 理 。 

程序 清单 : codes\08\8.4\Around\src\org\crazyit\app\advice\AroundAdviceTestjava 


// 定 义 一 个 切面 
BRspect 
public class AroundAdviceTest 


{ 
// 区 卫 org.crazyit .app.service.impl 包 下 所 有 类 的 、 
// 所 有 方法 的 执行 作为 切入 点 
@Rround ("execution(* org.crazyit.app.service.impl.*.*(,.))") 
public Object processTx (ProceedingJoinPoint jp) 
throws java.lang.Throwable 


1 
System.out.println{" 执 行 目标 方法 之 前 ， 模 拟 开 始 事务 . . .") ; 
// 执 行 目标 方法 ， 并 保存 目标 方法 执行 后 的 返回 值 
object rvt = jp.proceed (new String[]{" 被 改变 的 参数 ")) ; 
System.out ,printInt" 执 行 目标 方法 之 后 ， 模 拟 结束 事务 . ..") 7 
return rvt + "新 增 的 内 容 "; 

} 

1 


上 面 的 程序 定义 了 一 个 AroundAdviceTest 切面 , 该 切面 里 包含 一 个 Around 增强 处 理 : processTx() 
方法 ， 该 方法 中 第 一 行 粗 体 字 代码 用 于 执行 目标 方法 ， 执 行 目标 方法 时 传 入 了 一 个 String[] 数 组 ， 用 于 
改变 调用 目标 方法 的 参数 ， 第 二 行 粗 体 字 代码 用 于 改变 目标 方法 的 返回 值 。 

本 示例 程序 中 的 Chinese 类 里 包含 三 个 方法 , 主 程序 调用 了 Chinese 类 的 三 个 方法 , 执行 主 程序 将 
看 到 如 图 8.14 所 示 的 效果 。 


[java] sayHel10 方 法 被 请 用 。 


模拟 结束 事务 
[java] 被 改变 的 参数 Hello ，Spring AOP 同村 
[java] 执行 目标 方 开始 Ma 
[java] 我 正在 吃 : FESO 
[java] 执行 目标 后 ， 式 镍 结束 事务 
[java] 执行 目标 方法 之 前 ， 模 拟 开始 事务 .- 
[java] Exception in thread “saain” java lang IllegalArgunentException: Expec 
lting 0 arguments to proceed, but was passed 1 arguaents J 


图 8.14 ”使 用 Around 增强 处 理 的 效果 


从 图 8.14 中 可 以 看 出 ， 使 用 Around 增强 处 理 可 以 取得 对 目标 方法 最 大 的 控制 权 ， 既 可 完全 控制 
目标 方法 的 执行 ， 也 可 改变 执行 目标 方法 的 参数 ， 还 可 以 改变 目标 方法 的 返回 值 。 
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当 调用 ProceedingJoinPoint 的 proceed( 方 法 时 , 传 入 的 Object] 参 数值 将 作为 目标 方法 的 参数 ， 如 
果 传 入 的 Object 数组 长 度 与 目标 方法 所 需要 参数 的 个 数 不 相 等 , 或 者 Object 数组 元 素 与 目标 方法 所 
需 参数 的 类 型 不 匹配 ， 程 序 就 会 出 现 异 常 。 

为 了 能 获取 目标 方法 的 参数 的 个 数 和 类 型 ， 需 要 增强 处 理 方法 能 访问 执行 目标 方法 的 参数 了 。 

7. 访问 目标 方法 的 参数 

访问 目标 方法 最 简单 的 做 法 是 定义 增强 处 理 方法 时 将 第 一 个 参数 定义 为 JoinPoint 类 型 , 当 该 增强 
处 理 方法 被 调用 时 ， 该 JoinPoint 参数 就 代表 了 织 入 增强 处 理 的 连接 点 。JoinPoint 里 包含 了 如 下 几 个 常 
用 的 方法 。 

> ”Object[] getArgs(): 返回 执行 目标 方法 时 的 参数 。 

> ”Signature getSignature(): 返回 被 增强 的 方法 的 相关 信息 。 

> ”Object getTarget(): 返回 被 织 入 增强 处 理 的 目标 对 象 。 

> ”Object getThis(): 返回 AOP 框架 为 目标 对 象 生成 的 代理 对 象 。 

通过 使 用 这 些 方法 就 可 访问 到 目标 方法 的 相关 信息 。 


提示 : 
当 使 用 Around 处 理 时 ， 我 们 需要 将 第 一 个 参数 定义 为 ProceedingJoinPoint 类 型 ， 该 类 ， 
型 是 JoinPoint 类 型 的 子 类 | 


下 面 的 切面 类 中 定义 了 Before、Around、AfterReturning、After 4 种 增强 处 理 ， 并 分 别 在 4 种 增强 
处 理 中 访问 被 织 入 增强 处 理 的 目标 方法 、 执 行 目标 方法 的 参数 、 被 织 入 增强 处 理 的 目标 对 象 等 。 
下 面 是 该 切面 类 的 代码 。 
程序 清单 : codes\08\8.4\JoinPoint\src\org\crazyit\app\advice\FourAdviceTest.java 
// 定 义 一 个 切面 


QAspect 
public class FourAdviceTest 


{ 
// 定 义 Around 增强 处 理 执行 
QAround ("execution(* org.crazyit.app.service. impl.*.*(..))") 
public Object processTx (ProceedingJoinPoint jp) 
throws java.langvThrowable 
{ 


System.out .println ("Around 增强 ,执行 目标 方法 之 前 ， 模 拟 开 始 事务 . . ") ; 
// 访 问 执行 目标 方法 的 参数 
object[] args = jp.getArgs(); 
// 当 执行 目标 方法 的 参数 存在 ， 
// 且 第 一 个 参数 是 字符 串 参 数 
if (args {= null 56 args.length > 0 
66 args[0] -getClass{) == String.class) 


// 改 变 第 一 个 目标 方法 的 第 一 个 参数 
args[0] = "被 改变 的 参数 "; 


} 

// 执 行 目标 方法 ， 并 保存 目标 方法 执行 后 的 返回 值 

Object rvt = jp.proceed(args); 

System.out .println ("Around 增强 ; 执行 目标 方法 之 后 ， 模 拟 结束 事务 . . 
return rvt + "新 增 的 内 容 "; 


/ /定义 Before 增强 处 理 执行 

QBefore ("execution(* org.crazyit.app. service.impl.*.*#(..))") 
public void authority (JoinPoint jp) 

{ 


{ 


System.out .println ("Before 增强 ， 模拟 执行 权限 检查 ") ; 

// 返 回 被 织 入 增强 处 理 的 目标 方法 

Se println ("Before 增强 : 被 织 入 增强 处 理 的 目标 方法 为 :" 
Ip.getsignature() .getName () ) ; 

/访问 目标 方法 的 参数 
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System.out .println ("Before 增强 : 目标 方法 的 参数 为 :" 
+ Arrays.toString (jp.getArgs ())); 

7/ 访问 被 增强 处 理 的 目标 对 象 

System.out .println("Before 增强 : 被 织 入 增强 处 理 的 目标 对 象 为 : " 
+ jp.getTarget()); 


上 

// 定 义 AfterReturning 增强 处 理 执行 

@AfterReturning (pointcut="execution(* org.crazyit.app.seryice.impl.*.*(..)) 
， returning="rvt") 

public void log(JoinPoint jp , Object rvt) 

局 


+ 


System.out .println("AfterReturning 增强 ， 获取 目标 方法 返回 值 :" 
+ rvt); 
System.out .println ("AfterReturning 增强 ,模拟 记录 日 志 功能 . . .") ; 
// 返 回 被 织 入 增强 处 理 的 目标 方法 
ne 和 println("AfterReturning 增强 ， 被 织 入 增强 处 理 的 目标 方法 为 :" 
getsignature () .getName ()); 
// 沪 问 执着 时 放 守 允 
System,out .println ("AfterReturning 增强 ， 目标 方法 的 参数 为 ，" 
+ Arrays.tostring (jp.getArgs())); 
// 访 问 被 增强 处 理 的 目标 对 象 
System.out ,println ("AfterReturning 增强 ， 被 织 入 增强 处 理 的 目标 对 象 为 ，" 
+ jp-getTarget()) 7 
} 


// 定 义 After 增强 处 理 执行 
QAfter ("execution{(* org.crazyit.app.service.impl.*.*(..))") 
public void release(JoinPoint jp) 


{ 
System.out .println("After 增强 ， 模拟 方 法 结束 后 的 释放 资源 . . .") ; 

// 返 回 被 织 入 增强 处 理 的 目标 方法 

Ed ee Println("After 增强 : pi Ww 

Ip.getsignature() .getName ()) 
/ /访问 所 大寺 半生 多 交 
evo out ,println ("After 增强 ， 目 标 方法 的 参数 为 ，" 
+ Arrays.toString (jp.getArgs ())); 
// 访 问 被 增强 处 理 的 目标 对 象 
System.out.println ("After 增强 : et te 
+ jp-getTarget()) 7 

} 


从 上 面 的 粗 体 字 代码 可 以 看 出 ， 在 Before、Around、AfterRetuming、After 4 种 增强 处 理 中 ， 其 实 
都 可 通过 相同 的 代码 来 访问 被 增强 的 目标 对 象 、 目 标 方法 和 方法 的 参数 ， 但 只 有 Around 增强 处 理 可 
以 改变 方法 参数 ， 如 上 面 程序 中 斜体 字 代码 所 示 。 

被 上 面 切面 类 处 理 的 目标 类 还 是 一 个 简单 Chinese 类 ， 主 程序 获取 Chinese 实例 ， 并 执行 它 的 
sayHello0 和 eat0 两 个 方法 ， 执 行 结束 将 看 到 如 图 8.15 所 示 的 执行 效果 。 


[java] 被 改变 的 参数 Hello ，Spring AP 新 二 的 内 容 
javal Around 增 强 ， 执 行 上 村 方法 之 前 ， 杭 报 开始 事务 J 


图 8.15 Spring 为 目标 方法 织 入 各 种 增强 处 理 的 效果 
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从 图 8.15 还 可 以 看 出 一 个 特征 : 当 Spring 框架 为 目标 方法 织 入 各 种 增强 处 理 时 , 在 进入 目标 方法 
时 , 先 织 入 Around 增强 处 理 , 再 织 入 Before 增强 处 理 ; 在 退出 目标 方法 时 ， 先 织 入 Around 增强 处 理 ， 
再 织 入 AfterReturning 增强 处 理 ， 最 后 才 织 入 After 增强 处 理 。 

Spring AOP 采用 和 Aspect 一 样 的 优先 顺序 来 织 入 增强 处 理 : 在 “进入 ”连接 点 时 ， 最 高 优先 级 
的 增强 处 理 将 先 被 织 入 (所 以 给 定 的 两 个 Before 增强 处 理 中 , 优先 级 高 的 那个 会 先 执行 )。 在 “退出 ” 
连接 点 时 ， 最 高 优先 级 的 增强 处 理会 最 后 被 织 入 《所 以 给 定 的 两 个 After 增强 处 理 中 ， 优 先 级 高 的 那 
个 会 第 二 个 执行 )。 

由 此 可 见 ，Before、Around、AfterReturning、After 增强 处 理 的 优先 级 如 图 8.16 所 示 。 


低 , 高 
图 8.16 4 种 增强 处 理 的 优先 级 


当 不 同 的 切面 里 的 两 个 增强 处 理 需要 在 同一 个 连接 点 被 织 入 时 ，Spring AOP 将 以 随机 的 顺序 来 织 
入 这 两 个 增强 处 理 。 如 果 应 用 需要 指定 不 同 切面 类 里 增强 处 理 的 优先 级 ，Spring 提供 了 如 下 两 种 解决 
方案 : 

> 让 切面 类 实现 org.springframework.core.Ordered 接口 ， 实 现 该 接口 只 需 实现 一 个 int 

getOrder() 方 法 ， 该 方法 返回 值 越 小 ， 则 优先 级 越 高 。 

> ”直接 使 用 @Order Annotation 来 修饰 一 个 切面 类 ， 使 用 @Order Annotation 时 可 指定 一 个 int 

型 的 value 属性 ， 该 属性 值 越 小 ， 则 优先 级 越 高 。 

优先 级 高 的 切面 类 里 的 增强 处 理 的 优先 级 总 是 比 优先 级 低 的 切面 类 里 的 增强 处 理 的 优先 级 更 好 。 
例如 优先 级 为 1 的 A 切面 Bean 包含 了 abc Before Advice, 优先 级 为 2 的 B 切面 Bean 包含 了 xyzAround 
Advice, 虽然 Around Advice 的 优先 级 高 于 Before Advice, 但 由 于 abc Advice 位 于 优先 级 为 1 的 Advice 
中 ， 央 此 abe Advice 的 优先 级 比 xyzAdvice 的 优先 级 更 高 。 

同一 个 切面 类 里 的 两 个 相同 类 型 的 增强 处 理 在 同一 个 连接 点 被 织 入 时 ，Spring AOP 将 以 随机 的 顺 
序 来 织 入 这 两 个 增强 处 理 ， 没 有 办 法 指定 它们 的 织 入 顺序 。 如 果 确实 需要 保证 它们 以 固有 的 顺序 被 织 
入 ， 则 可 考虑 将 多 个 增强 处 理 压 缩 成 一 个 增强 处 理 ， 或 者 将 不 同 增强 处 理 重 构 到 不 同 切面 类 中 ， 通 过 
在 切面 类 级 别 上 进行 排序 。 

如 果 只 要 访问 目标 方法 的 参数 ，Spring 还 提供 了 一 种 更 简单 的 方法 ， 我 们 可 以 在 程序 中 使 用 args 
来 绑 定 目标 方法 的 参数 。 如 果 在 一 个 args 表达 式 中 指定 了 一 个 或 多 个 参数 ， 则 该 切入 点 将 只 匹配 具有 
对 应 形 参 的 方法 ， 且 目标 方法 的 参数 值 将 被 传 入 增强 处 理 方法 一 一 这 段 文字 确实 有 点 绕 口 ， 下 面 使 用 

-个 示例 可 能 更 加 清晰 。 
下 面 定义 一 个 切面 类 。 
程序 清单 : codes\08\8.4\Args\src\org\crazyit\app\advice\AccessArgAspect.java 


@Aspect 
public class AccessArgAspect 
{ // 下 面 的 args (msg, time) 保证 该 切入 点 只 匹配 
// 具 有 第 一 个 参数 是 字符 串 ， 第 二 个 参数 是 Date 的 方法 
QAfterReturning (pointcut="execution(* org.crazyit.app.service. im 
+ "(1)) Eh args(fo0d , time)" 
, returning="retVal") 
public void access(Date time , String food ， 
Object retVal) 
{ 
System.out .println ("目标 方法 中 String 参数 为 : ”+ food); 
System.out .printin ("目标 方法 中 Date 参数 为 : ”+ time); 
System.out ,println ("模拟 记录 日 志 - -.."); 
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上 面 的 程序 中 粗 体 字 代 码 用 于 定义 切入 点 表达 式 ， 但 该 切入 点 表达 式 增加 了 &&args(food ， time) 
部 分 ， 这 意味 着 可 以 在 增强 处 理 方法 (access0 方 法 ) 中 定义 food、time 两 个 形 参 一 一 定义 这 两 个 形 参 
时 ， 形 参 类 型 可 以 随意 指定 ， 但 一 旦 指定 了 这 两 个 形 参 类 型 ， 则 两 个 形 参 类 型 将 用 于 限制 该 切入 点 只 
匹配 第 一 个 参数 类 型 是 String、 第 二 个 参数 类 型 是 Date 的 方法 。 

本 示例 程序 的 目标 类 Chinese 类 里 定义 了 两 个 方法 ，Chinese 类 代码 如 下 。 

程序 清单 :codes\08\8.4\Args\src\org\crazyit\app\service\impl\Chinese.java 


@Component 
public class Chinese 
implements Person 


// 实 现 Person 接口 的 sayHello () 方 法 
public String sayHello(String name) 


// 返 回 简单 的 字符 趾 
return name + " Hello , Spring AOP"; 


{ 


} 
Public void eat(string food 
+ Date time) 
{ 
System.out .println ("我 正在 吃 ”+ food 
+ ", 现 在 时 间 是 :" + time); 
} 
下 


在 上 面 的 Chinese 类 中 包含 两 个 方法 , 但 只 有 eat0 方 法 第 一 个 参数 类 型 是 String、 第 二 个 参数 类 型 
是 Date， 所 以 Spring AOP 将 只 对 该 方法 织 入 access0 增 强 处 理 。 

主 程序 获取 Chinese 实例 ， 并 调用 Chinese 实例 的 sayHello0 和 eat0 两 个 方法 ,将 看 到 如 图 8.17 所 
示 的 效果 。 


图 8.17 通过 args 表达 式 来 访问 方法 参数 


从 图 8.17 中 可 以 看 出 ， 使 用 args 表达 式 有 如 下 两 个 作用 : 

> ”提供 了 一 种 简单 的 方式 来 访问 目标 方法 的 参数 。 

> ”可 用 于 对 切入 表达 式 增加 额外 的 限制 。 

除 此 之 外 ， 使 用 args 表达 式 时 还 可 使 用 如 下 形式 ，args(name , age , ..)， 这 表明 增强 处 理 方法 中 可 
通过 name、age 来 访问 目标 方法 的 参数 。 注意 上 面 args 表达 式 括号 中 的 2 点 ， 它 表示 可 匹配 更 多 参数 
一 一 如 果 该 args 表达 式 对 应 的 增强 处 理 方法 签名 为 : 

QAfterReturning (pointcut="execution(* org. et -app. service. impl” 


public void dosomething (String name , int age) 0 


这 意味 着 只 要 目标 方法 第 一 个 参数 是 String 类 型 、 第 二 个 参数 是 int 类 型 , 则 该 方法 就 可 匹配 该 切 
入 点 。 


8. 定义 切入 点 


正如 在 前 面 的 FourAdviceTestjava 程序 中 看 到 的 ， 这 个 切面 类 中 定义 了 4 个 增强 处 理 ， 定 义 4 个 
增强 处 理 时 分 别 指定 了 相同 的 切入 点 表达 式 ， 这 种 做 法 显然 不 太 符合 软件 设计 的 原则 : 我 们 居然 将 那 
个 切入 点 表达 式 重复 了 4 次 ! 如 果 有 一 天 需要 修改 该 切入 点 表达 式 ， 那 不 是 要 修改 4 个 地 方 ? 


662 


http://52pdf.taobao.com 


Sie8 


为 了 解决 这 个 问题 ，AspecU 和 Spring 都 允许 定义 切入 点 。 所 谓 定义 切入 点 ， 其 实质 就 是 为 一 个 
切入 点 表达 式 起 一 个 名 称 ， 从 而 允许 在 多 个 增强 处 理 中 重用 该 名 称 。 

Spring AOP 只 支持 以 Spring Bean 的 方法 执行 组 作为 连接 点 ， 所 以 可 以 把 切入 点 看 成 所 有 能 和 切 
入 表达 式 匹 配 的 Bean 方法 。 

切入 点 定义 包含 两 个 部 分 : 

> 一 个 切入 点 表达 式 。 

> 一 个 包含 名 字 和 任意 参数 的 方法 签名 。 

其 中 切入 点 表达 式 用 于 指定 该 切入 点 和 哪些 方法 进行 匹配 ， 包 含 名 字 和 任意 参数 的 方法 签名 将 作 
为 该 切入 点 的 名 称 。 

在 @Aspect 风格 的 AOP 中 ， 切 入 点 签名 采用 一 个 普通 的 方法 定义 方法 体 通常 为 空 ) 来 提供 ， 
且 该 方法 的 返回 值 必 须 为 void; 切入 点 表达 式 需 使 用 @Pointcut Annotation 来 标注 。 

下 面 的 代码 片段 定义 了 一 个 切入 点 : anyOldTransfer， 这 个 切入 点 将 匹配 任何 名 为 transfer 的 方法 


的 执行 。 
// 使 用 8Pointcut Annotation 时 指定 切入 点 表达 式 
QPointcut ("execution(* transfer(..))") 


// 使 用 一 个 返回 值 为 void， 方 法 体 为 空 的 方法 来 命名 切入 点 
Private void anyOldTransfer(){)} 


切入 点 表达 式 ， 也 就 是 组 成 @Pointcut 注解 的 值 ， 是 正规 的 Aspect 5 切入 点 表达 式 。 如 果 想 要 更 
多 了 解 Aspect 的 切入 点 语言 ， 请 参见 Aspect 编程 指南 。 

- 旦 采用 上 面 的 代码 片段 定义 了 名 为 anyOldTransfer 的 切入 点 之 后 ， 程 序 就 可 多 次 重复 使 用 该 切 
入 点 了 ， 甚 至 可 以 在 其 他 切面 类 、 其 他 包 的 切面 类 里 使 用 该 切入 点 ， 至 于 是 否 可 以 在 其 他 切面 类 、 其 
他 包 的 切面 类 里 访问 该 切入 点 ， 则 取决 于 该 方法 签名 前 的 访问 控制 符 一 一 例如 ， 本 示例 中 
anyOldTransfer( 方 法 使 用 private 访问 控制 符 ， 则 意味 着 仅 能 在 当前 切面 类 中 使 用 该 切入 点 。 

如 果 需 要 使 用 本 切面 类 中 的 切入 点 ， 则 可 在 使 用 @Pointcut Annotation 时 ， 指 定 value 属性 值 为 已 
有 的 切入 点 。 如 下 面 的 代码 片段 所 示 。 


6RfterReturning (pointcut="myPointcut ()" 
,returning="retVal") 

public void writeLog(String msg, Object retVal) 
{ 


} 

从 粗 体 字 代 码 可 以 看 出 , 指定 切入 点 时 非常 像 调用 Java 方法 的 语法 一 一 只 是 该 方法 代表 一 个 切入 
点 ， 其 实质 是 为 该 增强 处 理 定义 一 个 切入 点 表达 式 。 

如 果 需 要 使 用 其 他 切面 类 中 的 切入 点 ， 则 其 他 切面 类 中 的 切入 点 不 能 使 用 private 修饰 。 下 面 程序 
的 切面 类 里 仅 定义 了 一 个 切入 点 。 

程序 清单 ，codes\08\8.4\ReusePointcut\src\org\crazyit\app\advice\\SystemArchitecture.java 


QAspect 
public class SystemArchitecture 
{ 
GPointcut ("execution(* org.crazyit.app. service" 
+ ".impl.Chin*.say*(..))") 
Public void myPointcut() 
{ 


} 


} 
下 面 的 切面 类 中 将 直接 使 用 上 面 定义 的 myPointcut 切入 点 。 
程序 清单 :codes\08\8.4\ReusePointcut\src\org\crazyit\app\advice\LogAspectjava 
QAspect 
public class LogAspect 
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// 直 接 使 用 SystemArchitecture 切面 类 的 myPointcut 切入 点 

//args (msg) 保证 该 切入 点 只 匹配 只 有 一 个 字符 此 参数 的 方法 

@AfterReturning (Pointcut="SystemRrchitecture myPointcut()" 
+ "66args (msg)” , returning="retVal") 

public void writeLog(String msg, Object retVal) 

{ 
System.out.println (msg)7 
System.out .println(retVal); 
System.out .println ("模拟 记录 日 志 ....") 

} 


上 面 的 程序 中 粗 体 字 代码 就 是 直接 使 用 SystemArchitecture 类 中 切入 点 的 代码 。 从 上 面 粗 体 字 代码 
可 以 看 出 ， 当 使 用 其 他 切面 类 中 的 切入 点 时 ， 应 该 使 用 切面 类 作为 前 级 来 限制 切入 点 。 

正如 从 上 面 的 LogAspectjava 中 看 到 的 ,该 类 可 以 直接 使 用 SystemArchitecture 类 中 定义 的 切入 点 ， 
这 意味 着 其 他 切面 类 也 可 自由 使 用 SystemArchitecture 类 中 定义 的 切入 点 , 这 就 很 好 地 复 用 了 切入 点 所 
包含 的 切入 点 表达 式 。 

9. 切入 点 指示 符 

前 面 定义 切入 点 表达 式 时 大 量 使 用 了 execution 表达 式 ， 其 中 execution 就 是 一 个 切入 点 指示 符 。 
Spring AOP 仅 支 持 部 分 Aspect 的 切入 点 指示 符 ， 但 Spring AOP 还 额外 支持 一 个 bean 切入 点 指示 符 。 

不 仅 如 此 ， 因 为 Spring AOP 只 支持 使 用 方法 调用 作为 连接 点 ， 所 以 Spring AOP 的 切入 点 指示 符 
仅 匹 配方 法 执行 的 连接 点 。 


三 入 村 首 me 

完整 的 Aspect 切入 点 言 支持 大 量 切 入 。 示 符 , 但 是 Spring 并 不 支持 它们 . Spring 
AOP 不 支持 的 切入 点 指示 符 有 call、 get、 set、preinitialization, staticinitialization ,initialization、 
handler、adviceexecution、withincode、cflow、cflowbelow、if、@this 和 @withincode. 要 


旦 在 Spring AOP 中 使 用 这 些 指示 ， 将 会 导 政 所 出 legalArgument Exception 异常 。 


Spring AOP 一 共 支持 如 下 几 种 切入 点 指示 答 。 
> ”execution: 用 于 匹配 执行 方法 的 连接 点 ， 这 是 Spring AOP 中 最 主要 的 切入 点 指示 符 。 该 切 
入 点 的 用 法 也 相对 复杂 ，execution 表达 式 的 格式 如 下 : 


execution (modifiers-pattern? ret-type-pattern declaring-type-pattern? 
name-pattern(param-pattern) throws-pattern?) 


上 面 的 格式 中 execution 是 不 变 的 ， 用 于 作为 execution 表达 式 的 开头 ， 整 个 表达 式 中 各 部 分 的 解 
释 如 下 。 

> ”modifiers-pattern: 指定 方法 的 修饰 符 ， 支 持 通配符 ， 该 部 分 可 省 略 。 

> “ret-type-pattern: 指定 方法 返回 值 类 型 ， 支 持 通配符 ， 可 以 使 用 “” 通 配 符 来 匹配 所 有 返回 
值 类 型 。 

> ”declaring-type-pattern: 指定 方法 所 属 的 类 ， 支 持 通配符 ， 该 部 分 可 省 略 。 

> ”name-pattern: 指定 匹配 指定 方法 名 ， 支 持 通配符 ， 可 以 使 用 “” 通 配 符 来 匹配 所 有 方法 。 

> ”param-pattern: 指定 方法 声明 中 的 形 参 列表 ， 支 持 两 个 通配符 : “” 和 “.…"， 其 中 “” 代 表 
一 个 任意 类 型 的 参数 ， 而 “… 代 表 零 个 或 多 个 任意 类 型 的 参数 。 例 如 ，() 匹 配 了 一 个 不 接受 
任何 参数 的 方法 ， 而 (..) 匹 配 了 一 个 接受 任意 数量 参数 的 方法 〈 零 个 或 更 多 ) ，(*) 匹 配 了 一 个 
接受 一 个 任何 类 型 参数 的 方法 。(*,String) 匹 配 了 一 个 接受 两 个 参数 的 方法 ， 第 一 个 可 以 是 任 
意 类 型 ， 第 二 个 则 必须 是 String 类 型 。 

> throws-pattern: 指定 方法 声明 抛 出 的 异常 ， 支 持 通配符 ， 该 部 分 可 省 略 。 
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例如 ， 如 下 几 个 execution 表达 式 : 


// 匹 配 任意 public 2 

execution (public * * (..)) 

7/ 匹配 任何 方法 名 以 “set” 开始 的 方法 的 执行 

execution(* set* (..)) 

// 匹 配 AccountService 里 定义 的 任意 方法 的 执行 

execution (* org.crazyit.app.service.AccountService.* (..)) 
// 匹 配 service 包 中 任意 类 的 任意 方法 的 执行 


execution(* org.crazyit.app.service.*.*(. 
> ”within: 限定 匹配 特定 类 型 的 连接 点 ， 村 Spring AOP 的 时 候 ， 只 能 匹配 方法 执行 的 连 
例如 ， 如 下 几 个 within 表达 式 : 
// 在 service 包 中 的 任意 连接 点 〈 在 Spring AOP 中 只 是 方法 执行 ) 
within(org.crazyit.app.service.*) 
// 在 service 包 或 其 子 包 中 的 任意 连接 点 (在 Spring AOP 中 只 是 方法 执行) 
within(org.crazyit,app.service,..*) 
> ”this: 用 于 限定 AOP 代理 必须 是 指定 类 型 的 实例 ， 用 于 匹配 该 对 象 的 所 有 连接 点 。 当 使 用 
Spring AOP 的 时 候 ， 只 能 匹配 方法 执行 的 连接 点 。 
例如 ， 如 下 this 表达 式 : 
// 匹 配 实现 了 AccountService 接口 的 代理 对 象 的 所 有 连接 点 
// 在 Spring AOP 中 只 是 方法 执行 的 连接 点 
this(org.crazyit.app.service.AccountService) 
> ”target; 用 于 限定 目标 对 象 必 须 是 指定 类 型 的 实例 ， 用 于 匹配 该 对 象 的 所 有 连接 点 。 当 使 用 
Spring AOP 的 时 候 ， 只 能 匹配 方法 执行 的 连接 点 。 
例如 ， 如 下 target 表达 式 : 
7/ 匹配 实 现 了 AccountService 接口 的 目标 对 象 的 所 有 连接 点 
// 在 Spring AOP 中 只 是 方法 执行 的 连接 点 
target (org.crazyit.app.service.AccountService) 
> ”args: 用 于 对 连接 点 的 参数 类 型 进行 限制 ， 要 求 参数 类 型 是 指定 类 型 的 实例 。 当 使 用 Spring 
AOP 的 时 候 ， 只 能 匹配 方法 执行 的 连接 点 。 
例如 ， 如 下 args 表达 式 : 


// 匹 配 只 接受 一 个 参数 ， 且 传 入 的 参数 类 型 是 Serializable 的 所 有 连接 点 
// 在 Spring AOP 中 只 是 方法 执行 的 连接 点 
args (java,io.Serializable) 


args 版 本 只 下 
配 动态 运行 时 传 入 参数 值 是 Serializable 类 型 的 情形 ， 而 execution 版 本 则 匹配 方法 签名 
只 包含 一 个 Serializable 类 型 的 形 参 的 方法 


另外 ，Spring AOP 还 提供 了 一 个 名 为 bean 的 切入 点 指示 符 ， 它 用 于 限制 只 匹配 指定 Bean 实例 内 
的 连接 点 。 当 然 ，Spring AOP 中 只 能 使 用 方法 执行 作为 连接 点 。 
> ”bean: 用 于 指定 只 匹配 指定 Bean 实例 内 的 连接 点 ， 实 际 上 只 能 使 用 方法 执行 作为 连接 点 。 
定义 bean 表达 式 时 需要 传 入 Bean 的 id 或 name, 表示 只 匹配 该 Bean 实例 内 的 连接 点 。 支 
持 使 用 “*” 通 配 符 。 
例如 ， 如 下 几 个 bean 表达 式 : 


// 匹 配 tradeService Bean 实例 内 方法 执行 的 连接 点 
bean (tradeService) 
// 匹 配 名 字 以 Service 结尾 的 Bean 实例 内 方法 执行 的 连接 点 


bean (*Service) 
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bean 切入 点 表达 式 是 Spring AOP 额外 支持 的 ， 并 不 是 Aspect 所 支持 的 切入 点 指示 
符 。 这 个 指示 符 对 Spring 框架 来 说 非常 实用 : 它 可 以 明确 指定 为 Spring 的 哪个 Bean 织 
入 增强 处 理 


10. 组 合 切 入 点 表达 式 

Spring 支持 使 用 如 上 三 个 逻辑 运算 符 来 组 合 切入 点 表达 式 。 

> ”&&: 要 求 连接 点 同时 匹配 两 个 切入 点 表达 式 。 

> 1， 只 要 连接 点 匹配 任意 一 个 切入 点 表达 式 。 

> !: 要 求 连接 点 不 匹配 指定 切入 点 表达 式 。 

回忆 前 面 定义 切入 点 表达 式 时 使 用 了 如 下 片段 : 

pointcut="execution(* org.crazyit.app. service. impl.*.*{.:))S&args (food , time)" 

上 面 pointeut 属性 指定 的 切入 点 表达 式 需要 匹配 如 下 两 个 条 件 : 

> ”匹配 org.crazyit.app.service.impl 包 下 任意 类 中 任意 方法 的 执行 。 

> ”被 匹配 该 方法 的 第 一 个 参数 类 型 必须 food 类 型 、 第 二 个 参数 类 型 必须 是 time 类 型 (food、 

time 类 型 由 增强 处 理 方法 来 决定 ) 。 

实际 上 ， 上 面 的 pointcut 切入 点 表达 式 由 两 个 表达 式 组 成 ， 而 且 使 用 && 来 组 合 这 两 个 表达 式 ， 所 

以 要 求 同 时 满足 这 两 个 切入 点 表达 式 的 要 求 。 


>>8.4.6 基于 XML 配置 文件 的 管理 方式 


除了 前 面 介绍 的 基于 JDK 1.5 的 Annotation 方式 来 定义 切面 、 切 入 点 和 增强 处 理 外 ，Spring AOP 
也 允许 直接 使 用 XML 配置 文件 来 定义 管理 它们 。 
如 果 应 用 中 没有 使 用 JDK 1.5， 那 我 们 只 能 选择 使 用 XML 配置 方式 了 ，Spring 2.X 提供 了 一 个 新 
的 “aop” 命 名 空间 来 定义 切面 、 切 入 点 和 增强 处 理 。 
实际 上 ， 使 用 XML 配置 方式 与 前 面 介绍 的 @Aspect 方式 的 实质 是 一 样 的， 同样 需要 指定 相关 数 
据 : 配置 切面 、 切 入 点 、 增 强 处 理 所 需 要 的 信息 完全 一 样 ， 只 是 提供 这 些 信息 的 位 置 不 同 而 已 。 使 用 
XML 配置 方式 时 是 通过 XML 文件 来 提供 这 些 信息 的 ;但 使 用 @Aspect 方式 则 通过 Annotation 来 提 
相 比 之 下 ， 使 用 XML 配置 方式 有 如 下 几 个 优点 : 
> ”如 果 应 用 没有 使 用 1.5 以 上 版 本 的 JDK， 那 么 应 用 只 能 使 用 XML 配置 方式 来 管理 切面 、 切 
入 点 和 增强 处 理 等 。 
> 采用 XML 配置 方式 时 对 早期 的 Spring 用 户 来 说 更 加 习惯 ， 而 且 这 种 方式 允许 使 用 纯粹 的 
POJO 来 支持 AOP。 当 使 用 AOP 作为 工具 来 配置 企业 服务 时 ，XML 会 是 一 个 很 好 的 选择 。 
当 使 用 XML 风格 时 ， 我 们 可 以 在 配置 文件 中 清晰 地 看 出 系统 中 存在 哪些 切面 。 
使 用 XML 配置 方式 ， 则 存在 如 下 几 个 缺点 。 
> 使 用 XML 配置 方式 不 能 将 切面 、 切 入 点 、 增 强 处 理 等 封装 到 一 个 地 方 。 当 我 们 需要 查看 切 
面 \ 切 入 点 .增强 处 理 时 , 必须 同时 结合 Java 文件 和 XML 配置 文件 来 查看 ; 但 使 用 @AspectJ 
时 ， 则 只 需 一 个 单独 的 类 文件 即 可 看 到 切面 、 切 入 点 和 增强 处 理 的 全 部 信息 。 
> XML 配置 方式 比 @AspectJ 方式 有 更 多 的 限制 : 仅 支持 “singleton” 切面 Bean, 不 能 在 XML 
中 组 合 多 个 命名 连接 点 的 声明 。 
除 此 之 外 ，@Aspect 切面 还 有 一 个 优点 就 是 能 被 Spring AOP 和 Aspect 同时 支持 , 如 果 有 一 天 我 
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们 需要 将 应 用 改 为 使 用 Aspect 来 实现 AOP， 使 用 @Aspect] 将 非常 容易 迁移 到 基于 Aspect] 的 AOP 
实现 。 相 比 之 下 ， 选 择 使 用 @Aspect 风格 会 有 更 大 的 吸引 力 。 

在 Spring 的 配置 文件 中 ， 所 有 切面 、 切 入 点 和 增强 处 理 都 必须 定义 在 <aop:config.… 人 > 元 素 内 部 。 
<beans... 人 > 元 素 下 可 以 包含 多 个 <aop:config... 信 元素， 一 个 <aop:config> 可 以 包含 pointcut、advisor 和 
aspect 元 素 ， 且 这 三 个 元 素 必须 按照 此 顺序 来 定义 。 关 于 <aop:config.…. 人 > 元 素 所 包含 的 子 元 素 如 图 8.18 
所 示 。 

图 8.18 已 经 非常 清楚 地 绘制 了 <aop:cofig.… 人 > 元 素 下 能 包含 三 个 有 序 子 元 素 : pointcut、advisor 和 
aspect， 其 中 aspect 下 可 以 包含 多 个 子 元 素 一 一 通过 使 用 这 些 元 素 就 可 在 XML 文件 中 配置 切面 、 切 入 
MN 


pe 往生 ， * 
当 我 们 使 用 <aop:config. 人 方式 进行 配置 时 ， 可 能 与 的 和 动人 方式 本 


突 ， 例 如 我 们 使 用 了 <aop:aspectj-autoproxy/> 或 类 似 方式 显 式 启用 了 自动 代理 ， 则 它 可 能 
会 导致 问题 ( 例如 有 些 增强 处 理 没 有 被 织 入 )， 因 此 建议 : RN y 


配置 方式 ， 要 么 全 部 使 用 自动 代理 方式 ， 不 要 把 两 者 混合 使 用 


图 8.18 ”<aop:config... 人 > 各 子 元 素 的 关系 


1. 配置 切面 
定义 切面 使 用 图 8.18 中 所 示 的 <aop:aspect... 亿 元素， 使 用 该 元 素来 定义 切面 时 ， 其 实质 是 将 一 个 
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已 有 的 Spring Bean 转换 成 切面 Bean， 所 以 需要 先 定义 一 个 普通 的 Spring Bean。 
因为 切面 Bean 可 以 当成 一 个 普通 的 Spring Bean 来 配置 ， 所 以 我 们 完全 可 以 为 该 切面 Bean 配置 
依赖 注入 。 当 切面 Bean 定义 完成 后 ， 通 过 在 <aop:aspect.. 人 > 元 素 中 使 用 ref 属性 来 引用 该 Bean， 就 可 
将 该 Bean 转换 成 一 个 切面 Bean 了 。 
配置 <aop:aspect.. 人 > 元 素 时 可 以 指定 如 下 三 个 属性 。 
> ”id: 定义 该 切面 的 标识 名 。 
> ref， 指定 以 指定 ref 属性 所 引用 的 普通 Bean 作为 切面 Bean。 
> ”order: 指定 该 切面 Bean 的 优先 级 ， 该 属性 的 作用 与 前 面 @AspectJ 中 @Order Annotation 、 
Ordered 接口 的 作用 完全 一 样 ，order 属性 值 越 小 ， 该 切面 对 应 的 优先 级 越 高 。 
如 下 配置 片段 定义 了 一 个 切面 : 
<aop:config> 
<!-- 将 容器 中 的 afterAdviceBean 转换 成 切面 Bean 


切面 Bean 的 新 名 称 为 afterAdviceAspect --> 
<aop:aspect id="afterAdviceAspect" ref="afterAdviceBean"> 
</aopiaspect> 9 

</aop: config> 


<!-- 定义 一 个 普通 Bean 实例 ， 该 Bean 实例 将 作为 Aspect Bean --> 
<bean id="afterAdviceBean" class™"lee.AfterAdviceTest"/> 


上 面 的 配置 文件 中 粗 体 字 代码 将 Spring 容器 中 的 afterAdviceBean Bean 转换 为 一 个 切面 Bean， 该 
切面 Bean 的 id 为 afterAdviceAspect。 

因为 Spring 支持 将 切面 Bean 当成 普通 Bean 来 管理 , 所 以 我 们 完全 可 以 利用 依赖 注入 来 管理 切面 
Bean， 管 理 切面 Bean 的 属性 值 、 依 赖 关系 等 。 

2. 配置 增强 处 理 

与 使 用 @Aspect 完全 一 样 , 使 用 XML 一 样 可 以 配置 Before、 After、 AfterReturning、 AfterThrowing 
和 Around 5 种 增强 处 理 ， 而 且 完 全 支持 和 @Aspect 完全 一 样 的 语义 。 

正如 图 8.18 所 示 ， 使 用 XML 配置 增强 处 理 分 别 依赖 于 如 下 几 个 元 素 。 

> ”<aop:before.../>: 配置 Before 增强 处 理 。 

> ”<aop:after..…/> : 配置 After 增强 处 理 。 

> ”<aop:after-returning.../> : 配置 AfterReturning 增强 处 理 。 

> ”<aop:after-throwing..…/> : 配置 AfterThrowing 增强 处 理 。 

> ”<aop:around.../> : 配置 Around 增强 处 理 。 

上 


pointcut: 该 属性 指定 一 个 切入 表达 式 ，Spring 将 在 匹配 该 表达 式 的 连接 点 时 织 入 该 增强 处 理 。 
pointcut-ref: 该 属性 指定 一 个 已 经 存在 的 切入 点 名 称 , 通常 pointcut 和 pointcut-ref 两 个 属性 
只 需 使 用 其 中 之 一 。 
> ”method: 该 属性 指定 一 个 方法 名 ， 指 定 切 面 Bean 的 该 方法 将 作为 增强 处 理 。 
> ”throwing: 该 属性 只 对 <after-throwing.../> 元 素 有 效 ， 用 于 指定 一 个 形 参 名 ，AfteThrowing 增 
强 处 理 方法 可 通过 该 形 参 访问 目标 方法 所 抛 出 的 异常 。 
> returning: 该 属性 只 对 <after-returning.../> 元 素 有 效 ， 用 于 指定 一 个 形 参 名 ，AfterReturning 
增强 处 理 方法 可 通过 该 形 参 访问 目标 方法 的 返回 值 。 
既然 应 用 选择 使 用 XML 配置 方式 来 配置 增强 处 理 ， 所 以 切面 类 里 定义 切面 、 切 入 点 和 增强 处 理 
的 Annotation 全 都 可 删除 了 。 
当 定义 切入 点 表达 式 时 ，XML 配置 方式 和 @AspecU Annotation 方式 支持 完全 相同 的 切入 点 指示 
符 ， 一 样 可 以 支持 execution、within、args、this、target 和 bean 等 切入 点 指示 符 。 
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XML 配置 方式 和 @Aspect Annotation 方式 一 样 支持 组 合 切 入 点 表达 式 , 但 XML 配置 方式 不 再 使 
用 简单 的 &&&、|| 和 ! 作为 组 合 运算 符 〈 因 为 直接 在 XML 文件 中 需要 使 用 实体 引用 来 表示 它们 )， 而 
是 使 用 如 下 三 个 组 合 运算 符 : and (相当 于 &&)、or〔 相 当 于 ||) 和 not (相当 于 !)。 

下 面 的 程序 定义 了 一 个 简单 的 切面 类 ， 该 切面 类 只 是 将 前 面 @Aspect] 示例 中 切面 类 的 全 部 
Annotation 删除 后 的 结果 。 

程序 清单 : codes\08\8.4\XML-config\src\crazyit\app\advice\FourAdviceTestjava 


public class FourAdviceTest 
{ 
Public Object processTx (ProceedingJoinPoint jp) 
throws java.lang.Throwable 


System.out .println ("Around 增强 : 执行 目标 方法 之 前 ， 模 拟 开始 事务 . . .")， 
// 访 问 执行 目标 方法 的 参数 
Object[] args = jp.getArgs(); 
/7 当 执行 目标 方法 的 参数 存在 ， 
7/ 且 第 一 个 参数 是 字符 让 参数 
if (args != null && args-length > 0 
5&6 args[0] .getClass() == String.class) 


// 改 变 第 一 个 目标 方法 的 第 一 个 参数 
args[0] = "被 改变 的 参数 "; 


} 
/7 执行 目标 方法 ， 并 保存 目标 方法 执行 后 的 返回 值 
Object rvt = jp.proceed(args); 
System.out.println ("Around 增强 ;执行 目标 方法 之 后 ， 模 拟 结束 事务 . . . ") 
return rvt + ”新 增 的 内 容 "; 

} 


Public void authority (Joinpoint jp) 
{ 


System.out .println("@Before 增强 ， 模拟 执行 权限 检查 ") ; 

// 返 回 被 织 入 增强 处 理 的 目标 方法 

System,out .println("@Before 增强 ， 被 织 入 增强 处 理 的 目标 方法 为 :" 
+ jp.getsignature() .getName ()); 

// 访 问 执行 目标 方法 的 参数 

System.out .println("@Before 增强 ， 目 标 方法 的 参数 为 :" 
+ Arrays.tostring (jp.getArgs())); 

// 访 问 被 增强 处 理 的 目标 对 象 

System.out .Println ("@Before 增强 : 被 织 入 增强 处 理 的 目标 对 象 为 :，" 
+ jp.getTarget ()); 


上 
publia void log(Joinpoint jp , Object rvt) 
{ 


System.out.println ("AfterReturning 增强 获取 目标 方法 返回 值 :" 
+ rvt); 

System.out .println("AfterReturning 增强 : 模拟 记录 日 志 功 能 和 

/7 返回 被 织 入 增强 处 理 的 目标 方法 

System.out .println("afterReturning 增强 : 被 织 入 者 处 理 的 目标 方法 为 ，" 
+ jp.getSignature() .getName() )7 

7/ 访问 执行 目标 方法 的 参数 

System.out .println("afterReturning 增强 : 目标 方法 的 参数 为: “ 
+ Arrays. tostring (jp.getArgs())); 

// 访 问 被 增强 处 理 的 目标 对 象 

System.out .println ("AfterReturning 增强 ， 被 织 入 增强 处 理 的 目标 对 象 为 :" 
+ jp.getTarget()); 


{ 


{ 


} 
Public void release (JoinPoint jp) 
{ 


System.out .println ("After 增强 : 模拟 方法 结束 后 的 释放 资源 . ..") ; 

7/ 返回 被 织 入 增强 处 理 的 目标 方法 

System-out .println("After 增强 ， 被 织 入 增强 处 理 的 目标 方法 为 :" 
+ jp.getSignature() .getName()); 

/访问 执行 目标 方法 的 参数 

System.out .println {"Rfter 增强 ， 目标 方法 的 参数 为 ; ” 
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+ Arrays.tostring (jp.getArgs())); 
// 访 问 被 增强 处 理 的 目标 对 象 
System-out .println("After 增强 ， 被 织 入 增强 处 理 的 目标 对 象 为 ，" 
+ jp.getTarget ()); 
} 
} 


上 面 的 FourAdviceTestjava 几乎 是 一 个 POJO 类 ， 除 了 该 Java 类 的 4 个 方法 的 第 一 个 参数 都 是 
JoinPoint 类 型 之 外 ,如 程序 中 粗 体 字 代码 所 示 一 一 当然 ,我 们 将 4 个 方法 的 第 一 个 参数 定义 为 JoinPoint 
类 型 是 为 了 访问 连接 点 的 相关 信息 ， 当 然 Spring AOP 只 支持 使 用 方法 执行 作为 连接 点 ， 所 以 使 用 
JoinPoint 只 是 为 了 获取 目标 方法 的 方法 名 、 参 数值 等 信息 。 

除 此 之 外 ， 本 示例 程序 中 还 定义 了 如 下 一 个 简单 的 切面 类 。 
程序 清单 : codes\08\8.4\XML-config\src\crazyit\app\advice\SecondAdviceTest.java 
class SecondAdviceTest 


// 定 义 Before 增强 处 理 
public void authority(String aa) 
{ 
System.out.println ("目标 方法 的 参数 为 : ”+ aa) ; 
system.out .println ("号 Before 增强 ， 模 拟 执行 权限 检查 ") ; 
} 
} 


上 面 切 面 类 的 authority0 方 法 里 多 了 一 个 String aa 的 形 参 ， 应 用 试图 通过 该 形 参 来 访问 目标 方法 
的 参数 值 ， 这 需要 配置 该 切面 Bean 时 使 用 args 切入 点 指示 符 。 

本 应 用 中 的 Spring 配置 文件 如 下 。 

程序 清单 : codes\08\8.4\XML-config\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance”" 
xmlns:aop="http://www:springframework.org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www. springframework.org/schema/aop 
http://www. springframework.org/schema/aop/spring-aop-3.0.xsd"> 
<aop:config> 
<!-- 将 fourAdviceBean 转换 成 切面 Bean 
切面 Bean 的 新 名 称 为 ，fourAdviceAspect 
指定 该 切面 的 优先 级 为 2 -~-> 
<aop:aspect id="fourAdviceAspect" ref="fourAdviceBean" 


order="2"> 
<!-- 定义 一 个 After 增强 处 理 ， 
直接 指定 切入 点 表达 式 


以 切面 Bean 中 的 release () 方 法 作为 增强 处 理 方法 --> 
<aop:after pointcut="execution(* org.craryit.app. service. impl.*.#(..))" 
method="release"/> 
<!-- 定义 一 个 Before 增强 处 理 ， 
直接 指定 切入 ， 


点 表达 式 
以 切面 Bean 中 的 authority() 方法 作为 增强 处 理 方法 --> 
<aop:before pointcut="execution(* org.crazyit.app. service. impl.*.*(..))" 


<!-- 定义 一 个 AfterReturning 增强 处 理 ， 
直接 指定 切入 点 表达 式 
以 切面 Bean 中 的 1og () 方法 作为 增强 处 理 方法 --> 
<aop:after-returning pointcut="execution(* org.craryit.app. service. impl. 


method="log" returning="rvt"/> 
<!-- 定义 一 个 Around 增强 处 理 ， 
直接 指定 切入 点 表达 式 
以 切面 Bean 中 的 processTx() 方 法 作为 增强 处 理 方法 --> 
<acp:around pointout="execution(* org.craryit.app. service. impl.*.*(..)) 
method="processTx"/> 
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</aop:aspect> 
<!-- 将 secondadviceBean 转换 成 切面 Bean 
切面 Bean 的 新 名 称 为 ; secondhdviceRspect 
指定 该 切面 的 优先 级 为 1， 该 切面 里 的 增强 处 理 将 被 优先 织 入 --> 


<aop:aspect id="secondAdviceAspect" ref="secondAdviceBean" 


order="1"> 
<!-- 定义 一 个 Before 增强 处 理 , 
直接 指定 切入 点 表达 式 


以 切面 Bean 中 的 authority() 方 法 作为 增强 处 理 方法 
且 该 参数 必须 为 String 类 型 (由 authority 方法 声明 中 msg 参数 的 类 型 决定 ) --> 
<aop:before Pointcut="execution (* org.crazyit.app.service. impl.*.* (..)) 
and args (aa)" 
method="authority"/> 
</aop:aspect> 
</aop:config> 
<!-- 定义 一 个 普通 组 件 Bean -> 
<bean id="chinese" 
class="org. crazyit.app. service.impl.Chinese"/> 
<!-- 定义 一 个 普通 Bean 实例 ， 该 Bean 实例 将 被 作为 Aspect Bean --> 
<bean id="fourAdviceBean" 
class="org.crazyit .app.advice. FourAdviceTest"/> 
<!-- 再 定义 一 个 普通 Bean 实例 ， 该 Bean 实例 将 被 作为 Aspect Bean --> 
<bean id="secondAdviceBean" 
class="org.crazyit.app.advice.SecondhdviceTest"/> 
</beans> 


上 面 的 配置 文件 中 依次 配置 了 chinese、fourAdviceBean 和 secondAdviceBean 三 个 Bean， 它 们 没 
有 丝毫 特别 之 处 ， 完 全 可 以 像 管理 普通 Bean 一 样 管理 它们 。 

上 面 的 配置 文件 中 第 一 段 粗 体 字 代 码 用 于 将 fourAdviceBean 转换 成 一 个 切面 Bean， 并 将 该 Bean 
里 包含 的 4 个 方法 转换 成 4 个 增强 处 理 。 当 配置 fourAdviceAspect 切面 时 ， 为 其 指定 了 order="2"， 这 
将 意味 该 切面 里 的 增强 处 理 的 织 入 顺序 为 2; 而 配置 secondAdviceAspect 切面 时 , 为 其 指定 了 order="1"， 
表示 Spring AOP 将 优先 织 入 secondAdviceAspect 里 的 增强 处 理 ,再 织 入 fourAdviceAspect 里 的 增强 处 理 。 

完成 上 面 的 定义 之 后 ， 运 行 上 面 的 示例 程序 ， 将 看 到 使 用 XML 配置 文件 来 管理 切面 、 增 强 处 理 
的 效果 。 至 于 使 用 XML 配置 方式 管理 增强 处 理 的 各 种 细节 ， 读 者 都 可 从 该 示例 中 找到 示范 ， 笔 者 就 
不 再 著述 了 。 

3. 配置 切入 点 

类 似 于 @Aspect 方式 ， 允 许 定义 切入 点 来 重用 切入 点 表达 式 ，XML 配置 方式 也 可 通过 定义 切入 
点 来 重用 切入 点 表达 式 ， 如 图 8.18 所 示 ，Spring 提供 了 <aop:pointcut../> 元 素来 定义 切入 点 。 当 把 
<aop:pointcut.../> 元 素 作为 <aop:config... 人 > 的 子 元 素 定义 时 ， 表 明 该 切入 点 可 被 多 个 切面 共享 ; 当 把 
<aop:pointcut... 记 元 素 作为 <aop:aspect.. 人 > 的 子 元 素 定义 时 ， 表 明 该 切入 点 只 能 在 对 应 的 切面 中 有 效 。 

配置 <aop:pointcut... 人 > 元 素 时 通常 需要 指定 如 下 两 个 属性 。 

> ”id: 指定 该 切入 点 的 标识 名 。 

> ”expression: 指定 该 切入 点 关联 的 切入 点 表达 式 。 

如 下 配置 片段 定义 了 一 个 简单 的 切入 点 : 


<!-- 定义 一 个 简单 的 切入 点 --> 
<aop:pointcut id="myPointcut" 
expression="execution(* org.crazyit.app.service.impl.*.*(..))"/> 


上 面 的 配置 片段 昕 可 作为 <aopxconfig .的 子 元 素 , 用 于 配置 全 局 切入 点 ; 也 可 作为 <aopraspect.- 人 > 
的 子 元 素 ， 用 于 配置 仅 对 该 切面 有 效 的 切入 点 。 
除 此 之 外 , 如果 程 序 已 经 使 用 了 Annotation 定义 了 切入 点 ， 在 <aop:pointcut .人 > 元 素 中 指定 切入 点 
表达 式 时 还 有 另外 一 种 用 法 ， 看 如 下 配置 片段 : 
<aop:config> 
<1-- 直接 使 用 某 个 切面 类 中 切入 点 作为 切入 点 表达 式 -> 
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<aop:pointcut id="myPointcut" 
expression="org. craryit.SystemArchitecture.myPointcut ()"/> 
</aop:config> 
下 面 的 示例 程序 定义 了 一 个 AfterThrowing 增强 处 理 ， 包 含 该 增强 处 理 的 切面 类 如 下 。 
程序 清单 : codes\08\8.4WXML-AfterThrowing\src\org\crazyit\app\advice\AfterThrowingAdviceTest.java 
public class AfterThrowingAdviceTest 
{ 


// 定 义 一 个 普通 方法 作为 增强 处 理 方法 
public void doRecoveryActions (Throwable ex) 


{ 
//ex 代表 目标 方法 中 抽出 的 异常 
System.out .println ("目标 方法 中 抛 出 的 异常 : ”+ ex)7 
System.out .println ("模拟 抛 出 异常 后 的 资源 回收 . . .") ; 
} 
} 


与 前 面 的 切面 类 完全 类 似 , 该 Java 类 就 是 一 个 普通 的 Java 类 .下 面 的 配置 文件 将 负责 配置 该 Bean 
实例 ， 并 将 该 Bean 实例 转换 成 切面 Bean。 
程序 清单 ，codes\08\8.4\XML-AfterThrowing\srcvbean.xml 


://www. springframework.org/schema/beans" 
="http://www.w3.0rg/2001/XMLSchema-instance" 
:aop="http://www. springframework:org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd 
ringframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> 
<aop: config> 
<!-- 定义 一 个 切入 点 ; myPointcut 
直接 指定 它 对 应 的 切入 点 表达 式 -> 
<aop:pointcut id="myPointcut" 
aionmnexecution ty org.crazyit.app.service. impl.*.*(..))"/> 
<aop:aspect id="afterThrowinghdvicehspect" 
ref="afterThrowingAdviceBean" order="1"> 
<!-- 定义 一 个 AfterThrowing 增强 处 理 ， 指 定 切入 点 
以 切面 Bean 中 的 doRecoveryActions () 方法 作为 增强 处 理 方法 --> 
<aop:after-throwing pointcut-ref="myPointcut" 
method="doRecoveryActions” throwing="ex"/> 
</aop:aspect> 
</aop: config> 
<!-- 定义 一 个 普通 组 件 Bean ~-> 
<bean id="chinese" 
class="org.crazyit.app. service.impl.Chinese"/> 
<!-~- 再 定义 一 个 普通 Bean 实例 ， 该 Bean 实例 将 被 作为 Aspect Bean --> 
<bean id="afterThrowingAdviceBean" 
class="org.crazyit .app.advice. AfterThrowingAdviceTest"/> 
</beans> 


上 面 的 配置 文件 中 第 一 段 粗 体 字 代 码 配 置 了 一 个 全 局 切入 点 : myPointcut， 这 样 其 他 切面 Bean 就 
可 多 次 复 用 该 切入 点 了 。 上 面 的 配置 文件 在 配置 <aop:pointcut.…… 户 元 素 时 , 使 用 pointcut-ref 引用 了 一 个 
已 有 的 切入 点 ， 如 配置 文件 中 第 二 段 粗 体 字 代码 所 示 。 


8.5 Spring 的 事务 


Spring 的 事务 管理 不 需要 与 任何 特定 的 事务 API 耦合 。 对 不 同 的 持久 层 访问 技术 ， 编 程式 事务 提 
供 一 致 的 事务 编程 风格 ， 通 过 模板 化 的 操作 一 致 性 地 管理 事务 。 声 明 式 事务 基于 Spring AOP 实现 ， 却 
并 不 需要 程序 开发 者 成 为 AOP 专家 ， 亦 可 轻易 使 用 Spring 的 声明 式 事务 管理 。 
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>>8.5.1 Spring 支持 的 事务 策略 


Java EE 应 用 的 传统 事务 有 两 种 策略 : 全 局 事务 和 局 部 事务 , 全 局 事务 由 应 用 服务 器 管理 , 需要 底 
层 服 务 器 的 JTA 支持 。 局 部 事务 和 底层 所 采用 的 持久 化 技术 有 关 ， 当 采用 JDBC 持久 化 技术 时 ， 需 要 
使 用 Connection 对 象 来 操作 事务 ; 而 采用 Hibernate 持久 化 技术 时 , 需要 使 用 Session 对 象 来 操作 事务 。 

全 局 事务 可 以 跨 多 个 事务 性 的 资源 (典型 例子 是 关系 数据 库 和 消息 队列 ); 使 用 局 部 事务 ， 应 用 服 
务 器 不 需要 参与 事务 管理 ， 因 此 不 能 保证 跨 多 个 事务 性 资源 的 事务 的 正确 性 。 当 然 ， 实 际 上 大 部 分 应 
用 都 使 用 单一 事务 性 的 资源 。 

图 8.19 对 比 了 JTA 全 局 事务 、JDBC 局 部 事务 、Hibernate 事务 的 事务 操作 代码 。 


JTA 全 局 事务 


图 8.19 三 种 事务 策略 的 事务 操作 代码 


从 图 8.19 可 以 看 出 ， 当 采用 传统 的 事务 编程 策略 时 ， 程 序 代码 必然 和 具体 的 事务 操作 代码 耦合 ， 
这 样 造成 的 后 果 是 ， 当 应 用 需要 在 不 同 的 事务 策略 之 间 切 换 时 ， 开 发 者 必须 手动 修改 程序 代码 。 当 使 
用 Spring 事务 操作 策略 后 ， 就 可 以 改变 这 种 现状 。 

Spring 事务 策略 是 通过 PlatformTransactionManager 接口 体现 的 , 该 接口 是 Spring 事务 策略 的 核心 。 
该 接口 的 源 代码 如 下 ; 

public interface PlatformTransactionManager 

// 平 台 无 关 的 获得 事务 的 方法 

TransactionStatus getTransaction (TransactionDefinition definition) 


throws TransactionException; 


// 平 台 无 关 的 事务 提交 方法 
void commit (TransactionStatus status) throws TransactionException; 


// 平 台 无 关 的 事务 回 滚 方法 


void rollback (Transactionstatus status) throws TransactionExCeption; 
_ 


PlatformTransactionManager 是 一 个 与 任何 事务 策略 分 离 的 接口 ， 随 着 底层 不 同事 务 策略 的 切换 ， 应 
用 必须 采用 不 同 的 实现 类 。PlatformTransactionManager 接口 没有 与 任何 事务 资源 捆绑 在 一 起 ， 它 可 以 适 
应 于 任何 的 事务 策略 , 结合 Spring 的 loC 容器 , 可 以 向 PlatformTransactionManager 注入 相关 的 平台 特性 。 

PlatformTransactionManager 接口 有 许多 不 同 的 实现 类 ， 应 用 程序 面向 与 平台 无 关 的 接口 编程 ， 当 
底层 采用 不 同 的 持久 层 技术 时 , 系统 只 需 使 用 不 同 的 PlatformTransactionManager 实现 类 即 可 一 一 而 这 
种 切换 通常 由 Spring 容器 负责 管理 ， 应 用 程序 既 无 须 与 具体 的 事务 API 耦合 ， 也 无 须 与 特定 实现 类 耦 
合 ， 从 而 将 应 用 和 持久 化 技术 、 事 务 API 彻底 分 离开 来 


Fa 的 事务 管理 机 制 是 一 种 典型 的 策略 模式 ,PlatformTransactionManager 代表 事务 管理 接 | 
贡品 ， 但 它 并 不 知道 底层 到 底 如 何 管理 事务 , 它 只 要 求 事务 管理 需要 提供 开始 事务 (gctTransaction() )、| 

| 。 提交 事务 (commit() ) 和 回 党 事务 (rollback0) 三 个 方法 ， 但 具体 如 何 实现 则 交 给 其 实现 类 来 完成 
同 实现 类 则 代表 不 同 的 事务 管理 策略 . 1 
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即使 使 用 容器 管理 的 JTA， 代 码 依然 无 须 执行 JNDI 查找 ， 无 须 与 特定 的 JTA 资源 耦合 在 一 起 ， 
通过 配置 文件 ，JTA 资源 传 给 PlatformTransactionManager 的 实现 类 。 因此 ， 程 序 的 代码 可 在 JTA 事务 
管理 和 非 JTA 事务 管理 之 间 轻 松 切 换 。 


有 读者 给 笔者 写 来 邮件 ， 他 询问 pi 是 否 支持 事务 跨 多 个 数据 库 交 ? Spring 完 
全 支持 这 种 跨 多 个 事务 性 资源 的 全 局 事务 ， 前 提 是 底层 的 应 用 服务 器 ( 如 WebLogic、 
JBoss 等 ) 支持 JTA 全 局 事务 。 可 以 这 样 说 : Spring 本 身 没有 任何 事务 支持 ， 它 只 是 负 
责 包 装 底层 的 事务 一 一 当 我 们 在 程序 中 面向 PlatformTransactionManager 接口 编程 时 ， 
Spring 在 底层 负责 将 这 些 操作 转 摘 成 具体 的 事务 操作 代码 ， 所 以 应 用 底层 支持 怎样 的 事 
务 策略 ， 那 么 Spring 就 可 支持 怎样 的 事务 策略 。 Spring 事务 管理 的 优势 是 将 应 用 从 具体 要 


的 事务 API 中 分 离 出 来 ， 而 不 是 真正 提供 事务 管理 的 底层 实现 。 


在 PlatformTransactionManager 接口 内 ， 包 含 一 个 getTransaction(TransactionDefinition definition) 方 
法 ， 该 方法 根据 一 个 TransactionDefinition 参数 ， 返 回 一 个 TransactionStatus 对 象 。TransactionStatus 对 
象 表示 一 个 事务 ，TransactionStatus 被 关联 在 当前 执行 的 线程 上 。 
getTransaction(TransactionDefinition definition) 返回 的 TransactionStatus 对 象 ， 可 能 是 一 个 新 的 事 
务 ， 也 可 能 是 一 个 已 经 存在 的 事务 对 象 。 如 果 当 前 执行 的 线程 已 经 处 于 事务 管理 下 ， 则 返回 当前 线程 
的 事务 对 象 ， 否则 ， 系 统 将 新 建 一 个 事务 对 象 后 返回 。 
TransactionDefinition 接口 定义 了 一 个 事务 规则 ， 该 接口 必须 指定 如 下 几 个 属性 值 。 
> “事务 隔离 ; 当前 事务 和 其 他 事务 的 隔离 程度 。 例 如 ， 这 个 事务 能 否 看 到 其 他 事务 未 提交 的 数 
据 等 。 
> 事务 传播 通常， 在 事务 中 执行 的 代码 都 会 在 当前 事务 中 运行 。 但 是 ， 如 果 一 个 事务 上 下 文 
已 经 存在 ， 有 儿 个 选项 可 指定 该 事务 性 方法 的 执行 行为 。 例 如 ， 大 多 数 情况 下， 简单 地 在 现 
有 的 事务 上 下 文中 运行 ， 或 者 挂 起 现 有 事务 ， 创 建 一 个 新 的 事务 。Spring 提供 EJB CMT 
(Contain Manager Transaction， 容 器 管理 事务 ) 中 所 有 的 事务 传播 选项 。 
> ”事务 超时 : 事务 在 超时 前 能 运行 多 久 ， 也 就 是 事务 的 最 长 持续 时 间 。 如 果 事 务 一 直 没 有 被 提 
交 或 回 滚 ， 将 在 超出 该 时 间 后 ， 系 统 自动 回 滚 事务 。 
> ”只 读 状 态 : 只 读 事务 不 修改 任何 数据 。 在 某 些 情况 下 《〈 例 如 使 用 Hibernate 时 ) ， 只 读 事务 
是 非常 有 用 的 优化 。 
TransactionStatus 代表 事务 本 身 ， 它 提供 了 简单 的 控制 事务 执行 和 查询 事务 状态 的 方法 ， 这 些 方法 
在 所 有 的 事务 API 中 都 是 相同 的 。TransactionStatus 接口 的 源 代码 如 下 : 
public interface Transactionstatus 
/的 
boolean isNewTransaction(); 
// 设 置 事务 回 滚 
void setRollbackOnly()} 
// 查 询 事务 是 否 已 有 回 溢 标 志 
boolean isRollbackonly(] 
} 
Spring 具体 的 事务 管理 由 PlatformTransactionManager 的 不 同 实现 类 来 完成 。 在 Spring 容器 中 配 
置 PlatformTransactionManager Bean 时 ， 必 须 针对 不 同 环境 提供 不 同 的 实现 类 。 
下 面 提供 了 不 同 的 持久 层 访问 环境 ， 及 其 对 应 的 PlatformTransactionManager 实现 类 的 配置 。 
JDBC 数据 源 的 局 部 事务 策略 的 配置 文件 如 下 : 


<?xml version="1.0" encoding="GBK"?> 
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<beans xmlns:xsi="http://www:w3.org/2001/XMLSchema-instance”" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http: //www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSsource" 
destroy-method="close"> 
<!-- 指定 连接 数据 库 的 驱动 一 > 
<property name="driverClass”value="com.mysql.jdbc.Drivern/> 
<!-- 指定 连接 数据 库 的 URL -> 
<property name="jdbcUrl" value="jdbc:mysql://localhost/javaee"/> 
<!-- 指定 连接 数据 库 的 用 户 名 --> 
<property name="user" value="root"/> 
<!-- 指定 连接 数据 库 的 密码 -> 
<property name="password" value="32147"/> 
<!-- 指定 连接 数据 库 连 接 池 的 最 大 连接 数 -> 
<property name="maxPoolSize" value="40"/> 
<!-- 指定 连接 数据 库 连接 池 的 最 小 连接 数 一 
<property name="minPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连 接 池 的 初始 化 连接 数 --> 
<property name="initialPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连接 池 的 连接 的 最 大 空闲 时 间 --> 
<property name=nmaxIdleTime”valUe="20"/> 
</bean> 
<!-- 配置 JDBC 数据 源 的 局 部 事务 管理 器 ， 使 用 DataSourceTransactionManager 类 --> 
<!-- 该 类 实现 PlatformTransactionManager 接口 ， 是 针对 采用 数据 源 连接 的 特定 实现 --> 
<bean id="transactionManagern 
class="org. springframework. jdbc.datasource.DataSourceTransactionManager"> 
<!-- 配置 DataSourceTransactionManager 时 需要 依赖 注入 DataSource 的 引用 --> 
name="dataSource" ref="datasource"/> 


</bean> 
</beans> 


容器 管理 的 JTA 全 局 事务 的 配置 文件 如 下 : 


<?xml version="1.0" encoding="GBK"?> 
<beans xmlns:xsi="httpi//www.w3.org/2001/XMLSchema-instancen 
//www.springframework.org/schema/beans" 


http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 JNDI 数据 源 Bean --> 
<bean id="dataSourcen 

class="org. springframework. jndi. JndiObjectFactoryBean"> 

<!-- 容器 管理 数据 源 的 JNDI -> 

<property name="jndiName" value="jdbc/jpetstore"/> 
</bean> 
使 用 JtaTransactionManager 类 ， 该 类 实现 PlatformTransactionManager 接口 --> 
针对 采用 全 局 事务 管理 的 特定 实现 。--> 

<bean id="transactionManager" 

Class="org: springframework. transaction. jta. JtaTransactionManager"/> 
</beans> 


从 上 面 的 配置 文件 来 看 ， 当 配置 JtaTransactionManager 全 局 事务 管理 策略 时 ， 只 需 指 定 事务 管理 
器 实现 类 即 可 ， 无 须 传 入 额外 的 事务 资源 。 这 是 因为 全 局 事务 的 JTA 资源 由 Java EE 服务 器 提供 ， 而 
Spring 容器 能 自行 从 Java EE 服务 器 中 获取 该 事务 资源 ， 所 以 无 须 使 用 依赖 注入 来 配置 。 


当 采 用 Hibernate 持久 层 访问 策略 时 ， 局 部 事务 策略 的 配置 文件 如 下 : 


<?xml version="1.0" encoding="GBK"?> 
<beans xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans™" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"> 
<!-- 指定 连接 数据 库 的 驱动 --> 


<property name="driverClass" value="com.mysql.jdbc.Driver"/> 
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<!-- 指定 连接 数据 库 的 URL --> 

<property name="jdbcUrl" value-"jdbc:mysql://localhost/javaee"/> 

<!-- 指定 连接 数据 库 的 用 户 名 --> 

<property name="user" value="root"/> 

<!-- 指定 连接 数据 库 的 密码 --> 

<property name="password" value="32147"/> 

<!-- 指定 连接 数据 库 连 接 池 的 最 大 连接 数 --> 

<property name="maxPoolSize" value="40"/> 

一 指定 连接 数据 库 连接 池 的 最 小 连接 数 -> 

<property name="minPoolSize" value="1"/> 

!-- 指定 连接 数据 库 连 接 池 的 初始 化 连接 数 -~-> 

<property name="initialPoolSize" value="1"/> 

<!-- 指定 连接 数据 库 连接 池 的 连接 的 最 大 空闲 时 间 -> 
<property name="maxIdleTime" value="20"/> 

</bean> 

<!-- 定义 Hibernate 的 SessionFactory --> 

<bean id="sessionFactory" 

class="org. springframework.orm.hibernate3.LocalSessionFactoryBean"> 
<!-- 配置 SessionFactory 所 需 的 数据 源 ， 注 入 上 文 定义 的 dataSource --> 
<property name="dataSource" ref="dataSource"/> 
<!-- mappingResouces 属性 用 来 列 出 全 部 映射 文件 -> 
<property name="mappingResources"> 


<list> 
~ 以 下 用 来 列 出 所 有 的 PO 映射 文件 --> 
<value>lee/MyTest .hbm.xml</value> 
</list> 
</property> 
<!-- 定义 Hibernate 的 SessionFactory 的 属性 --> 
<property name="hibernateProperties"> 
<props> 
!-- 指定 Hibernate 的 连接 方言 --> 
<prop key="hibernate.dialect">org.hibernate.dialect.MySQLInno- 
DBDialect</prop> 
<!-- 是 否 根据 Hiberante 映射 创建 数据 表 --> 
<prop key="hibernate.hbm2dd1.auto">update</prop> 
</props> 
</property> 
</bean> 
配置 Hibernate 的 局 部 事务 管理 器 ， 使 用 HibernateTransactionManager 类 
<!-- 该 类 是 PlatformTransactionManager 接口 针对 采用 Hibernate 的 特定 实现 类 --> 
<bean id="transactionManagern 
class="org. springframework.orm.hibernate3.HibernateTransactionManager"> 
配置 HibernateTransactionManager 需 依 赖 注 入 SessionFactory --> 
<property nane="sessionFactory" ref="sessionFactory"/> 
</bean> 


</beans> 


如 果 底 层 采 用 Hibernate 持久 层 技 术 ， 但 事务 采用 JTA 全 局 事务 ， 则 Spring 配置 文件 如 


<?xml version="1.0" encoding="GBK"?> 


<beans xmlns:xsi="http: 
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/ww.w3.org/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 配置 JNDI 数据 源 Bean --> 
<bean id="dataSource”" 

class="org. springframework. jndi. JndiobjectFactoryBean"> 

<!-- 容器 管理 数据 源 的 JNDI --> 

<property name="jndiName" value="jdbc/jpetstore"/> 
</bean> 
<!-- 定义 Hibernate 的 SessionFactory --> 
<bean id="sessionFactory" 
class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> 

<!-- 配置 SessionFactory 所 需 的 数据 源 ， 注 入 上 文 定义 的 dataSource 一 > 

<property name="dataSource” ref="dataSource"/> 

<!-- mappingResouces 属性 用 来 列 出 全 部 映射 文件 --> 

<property name="mappingResources"> 

<list> 
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<!-- 以 下 用 来 列 出 所 有 的 PO 映射 文件 --> 
<value>lee/MyTest-hbm-xml</value> 
</list> 
</property> 
<!-- 定义 Hibernate 的 SessionFactory 的 属性 --> 
<property name="hibernateProperties"> 
<props> 
<!-- 指定 Hibernate 的 连接 方言 --> 
<prop key="hibernate.dialect">org.hibernate.dialect,.MYSQLInno- 
DBDialect</prop> 
<!-- 是 否 根据 Hiberante 映射 创建 数据 表 --> 
<prop key="hibernate.hbm2ddl.auto">update</prop> 
</props> 
</property> 
</bean> 
<!-- 使 用 JtaTransactionManager 类 ， 该 类 实现 PlatformTransactionManager 接口 --> 
<!-- 针对 采用 全 局 事务 管理 的 特定 实现 。--> 
<bean id="transactionManager™ 
clasas="org .springframework.transaction.jta.JtaTransactionManager"/> 
</beans> 


从 上 面 的 配置 文件 可 以 看 出 ， 不 论 采用 哪 种 持久 层 访问 技术 ， 只 要 使 用 JTA 全 局 事务 ，Spring 事 
I 因为 它们 采用 的 都 是 全 局 事务 管理 策略 。 


当 采 用 JTA 全 局 事务 策略 时 ， 实际 上 需要 底层 应 用 服务 器 的 支持 ， 而 不 同 应 用 服务 

器 所 提供 的 JTA 全 局 事务 可 能 存在 细节 上 的 差异 ， 因 此 实际 配置 全 局 事务 管理 器 时 可 能 

需要 使 用 JtaTransactionManager 的 子 类 ， 如 OC4JJtaTransactionManager ( Oracle 提供 的 

Java EE 应 用 服务 器 ) WebLogicJtaTransactionManager( Bea 提供 的 WebLogic ) WebSphere- 可 
i 心 


从 上 面 的 配置 文人 看 出 ， 当 采用 Spring 事务 管理 策略 时 ， 
合 。Spring 提供 了 如 下 两 种 事务 管理 方式 。 
> 编程 式 事务 管理 : 即使 利用 Spring 编程 式 事务 时 ， 程 序 也 可 直接 获取 容器 中 的 
transactionManager Bean， 该 Bean 总 是 PlatformTransactionManager 的 实例 ， 所 以 可 以 
通过 该 接口 所 提供 的 3 个 方法 来 开始 事务 、 提 交 事 务 和 回 滚 事务 。 
> ”声明 式 事务 管理 : 无 须 在 Java 程序 中 书写 任何 的 事务 操作 代码 ， 而 是 通过 在 XML 文件 中 为 
业务 组 件 配置 事务 代理 (AOP 代理 的 一 种 ), AOP 人 Spring 
提供 : 在 目标 方法 执行 之 前 ， 织 入 开始 事务 ; 在 目标 方法 执行 之 后 ， 织 入 结束 事务 。 
不 论 采 用 何 种 持久 化 策略 ，Spring 都 提供 了 一 致 的 事务 抽象 ,因此 ， ey 
使 用 一 致 的 编程 模型 。 无 须 更 改 代码 ， 应 用 就 可 在 不 同 的 事务 管理 策略 中 切换 。 
当 使 用 编程 式 事务 时 , 开发 者 使 用 的 是 Spring 事务 抽象 (面向 PlatformTransactionManager 接口 纺 
程 ), 而 无 须 使 用 任何 具体 的 底层 事务 AP1。Spring 的 事务 管理 将 代码 从 底层 具体 的 事务 API 中 抽象 出 
来 ， 该 抽象 能 以 任何 底层 事务 为 基础 


\ 体 的 事务 策略 看 


提示 
Fo Spiihg 编程 式 事务 还 可 通过 TransactionTemplate 类 来 完成 ， 该 类 提供 了 一 个 execute 
(TransactionCallback action) 方 法 ， 可 以 以 更 简洁 的 方式 来 进行 事务 操作 .。 

当 使 用 声明 式 事务 时 ， 开 发 者 无 须 书写 任何 事务 管理 代码 ， 不 依赖 Spring 或 任何 其 他 事务 API。 
Spring 的 声明 式 事务 无 须 任何 额外 的 容器 支持 ，Spring 容器 本 身 管理 声明 式 事务 。 使 用 声明 式 事务 策 
略 ， 可 以 让 开发 者 更 好 地 专注 于 业务 逻辑 的 实现 。 
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六- 法 a 
Spring 所 支持 的 事务 策略 非常 灵活 ，Spring 的 事务 策略 允许 应 用 程序 在 不 同 事务 策略 
之 间 自 由 切换 ， 即 使 需要 在 局 部 事务 策略 和 全 局 事务 策略 之 间 切 换 ， 只 需要 修改 配置 文件 -要 


即 可 : 丙 冰 用 痊 认 的 代码 大 频 任 条 下 志 种 灵活 的 设计 ， 证 是 面向 接口 转 程 冲 来 的 优势 


> >8.5.2 使 用 TransactionProxyFactoryBean 创建 事务 代理 


Spring 同时 支持 编程 式 事务 策略 和 声明 式 事务 策略 ， 大 部 分 时 候 ， 我 们 都 推荐 采用 声明 式 事务 策 
略 。 使 用 声明 式 事务 策略 的 优势 十 分 明显 : 

> ”声明 式 事务 能 大 大 降低 开发 者 的 代码 书写 量 , 而 且 声明 式 事务 几乎 不 影响 应 用 的 代码 。 因此， 
无 论 底层 事务 策略 如 何 变化 ， 应 用 程序 都 无 须 任何 改变 。 

> ”应 用 程序 代码 无 须 任何 事务 处 理 代码 ， 可 以 更 专注 于 业务 逻辑 的 实现 。 

> Spring 则 可 对 任何 POJO 的 方法 提供 事务 管理 ， 而 且 Spring 的 声明 式 事务 管理 无 须 容器 的 
支持 ， 可 在 任何 环境 下 使 用 。 

> ”EJB 的 CMT 无 法 提供 声明 式 回 滚 规则 ; 而 通过 配置 文件 ，Spring 可 指定 事务 在 遇 到 特定 异 
常 时 自动 回 滚 。Spring 不 仅 可 在 代码 中 使 用 setRollbackOnly 回 滚 事务 ， 也 可 在 配置 文件 中 
配置 回 滚 规则 。 

> ”由 于 Spring 采用 AOP 的 方式 管理 事务 , 因此 , 可 以 在 事务 回 滚动 作 中 插入 用 户 自己 的 动作 ， 
而 不 仅仅 是 执行 系统 默认 的 回 滚 。 


Fl 本 节 不 打算 全 面 介绍 Spring 的 各 种 事务 策略 ， 因 此 这 里 不 会 介绍 编程 式 事务 ， 如 果 读 ， 
者 需要 更 全 面 了 解 Spring 事务 的 相关 方面 ， 请 自行 参阅 Spring 官方 参考 手册 | 

在 Spring 1.X 中 ， 声 明 式 事务 使 用 TransactionProxyFactoryBean 来 配置 事务 代理 Bean。 正 如 它 的 
类 名 所 暗示 的 ， 它 是 一 个 工厂 Bean， 该 工厂 Bean 专门 为 目标 Bean 生成 事务 代理 。 

可 能 读者 已 经 想到 了 ， 既 然 TransactionProxyFactoryBean 产生 的 是 事务 代理 Bean， 可 见 Spring 的 
声明 式 事务 策略 是 基于 Spring AOP 的 。 

每 个 TransactionProxyFactoryBean 为 一 个 目标 Bean 生成 一 个 事务 代理 Bean， 事 务 代 理 的 方法 改 
写 了 目标 Bean 的 方法 ， 就 是 在 目标 Bean 的 方法 执行 之 前 加 入 开始 事务 ， 在 目标 Bean 的 方法 正常 结 
柬 之 前 提交 事务 ， 如 果 过 到 特定 异常 则 回 滚 事务 。 

TransactionProxyFactoryBean 创建 事务 代理 时 ， 需 要 了 解 当前 事务 所 处 的 环境 ， 该 环境 属性 通过 
PlatformTransactionManager 实例 〈 其 实现 类 的 实例 ) 传 入 ， 而 相关 事务 规则 则 在 该 Bean 定义 中 给 出 。 

下 面 是 一 个 简单 的 持久 化 测试 程序 ， 该 程序 插入 两 条 数据 ， 第 二 条 数据 与 第 一 条 数据 完全 相同 ， 
这 将 违反 唯一 键 约束 。 

程序 清单 : codes\08\8.5\TransactionProxyFactoryBean\src\org\crazyit\app\dao\impl\NewsDaolImpl.java 


Public class NewsDaoImpl 
implements NewsDao 
{ 
private Datasource ds; 
public void setDs (DataSource ds) 
{ 
this.ds = ds; 


F 
public void insert (string title 


, String content) 
{ 
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JdbcTemplate jt = new JdbcTemplate(ds); 
jt.update ("insert into news_inf" 
+ " values(null ,? , ?)" 
,title , content); 
// 两 次 插入 的 数据 违反 唯一 键 约束 
jt.update ("insert into news_inf" 
+ " values(null , ? , ?)" 
, title , content); 
// 如 果 增加 事务 控制 ， 我 们 发 现 第 一 条 记录 也 插 不 进去 。 
// 如 果 没有 事务 控制 ， 则 第 一 条 记录 可 以 被 插入 
} 
} 


上 面 的 程序 中 粗 体 字 代码 将 会 违反 主键 约束 一 一 该 行 代码 将 会 引发 异常 ， 如 果 在 没有 事务 控制 的 
环境 下 ， 前 一 条 代码 将 会 向 数据 表 中 插入 一 条 记录 ;但 如 果 是 在 增加 了 事务 控制 的 环境 下 ， 则 这 两 条 
语句 是 一 个 整体 ， 因 为 第 二 条 语句 插入 失败 ， 所 以 将 导致 第 一 条 语句 插入 的 数据 也 被 回 滚 。 

下 面 是 在 Spring 配置 文件 中 配置 该 测试 程序 ， 并 使 用 TransactionProxyFactoryBean 为 它 配置 事务 


代理 。 
程序 清单 : codes\08\8.5\TransactionProxyFactoryBean\src\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0,xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://www.springframework.org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://wuw, springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"> 
<!-- 指定 连接 数据 库 的 驱动 --> 
<property name=ndriVerClass” value="com.mysql.jdbc.Driver"/> 
<!-- 指定 连接 数据 库 的 URL --> 
<property name="jdbcUrl" value="jdbc:mysql://localhost/javaee"/> 
<!-~ 指定 连接 数据 库 的 用 户 名 --> 
<property name="user" value="root"/> 
<!-- 指定 连接 数据 库 的 密码 --> 
<property name="password" value="32147"/> 
<!-- 指定 连接 数据 库 连接 池 的 最 大 连接 数 --> 
<property name="maxPoolSize" value="40"/> 
<!-- 指定 连接 数据 库 连接 池 的 最 小 连接 数 ~-> 
<property name="minPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连接 池 的 初始 化 连接 数 --> 
<property name="initialPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连接 池 的 连接 的 最 大 空闲 时 间 --> 
<property name="maxIdleTime" value="20"/> 
</bean> 
<!-- 配置 JDBC 数据 源 的 局 部 事务 管理 器 ， 使 用 DataSourceTransactionManager 类 --> 
<!-- 该 类 实现 PlatformTransactionManager 接口 ， 是 针对 采用 数据 源 连 接 的 特定 实现 --> 
<bean id=" 
claas="org .apringframework.jdbc.datasource.DatasSourceTransactionManager"> 
<!-- 配置 DataSourceTransactionManager 时 需要 依 注入 DataSource 的 引用 --> 
<property name="dataSource" ref="dataSource"/> 
</bean> 
<!-- 配置 一 个 业务 逻辑 Bean -> 
<bean id-"newsDao” class="org.crazyit.app.dao. impl.NewsDaoImpl"> 
<property name="ds" ref="dataSource"/> 


</bean> 
<1-~ 为 业务 逻辑 Bean 配置 事务 代理 --> 
<bean id="newsDaoTrans" class= 


"org. springframework.transaction.interceptor. TransactionProxyFactoryBean"> 
<!-- 为 事务 代理 工厂 Bean 注入 事务 管理 器 --> 
<property name="transactit 


<property 
<!-- 指定 事务 属性 --> 
<property name="transactionAttributes"> 
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</beans> 


上 面 的 配置 文件 中 第 一 段 粗 体 字 代 码 配置 了 一 个 事务 管理 器 ， 该 事务 管理 器 是 针对 JDBC 局 部 事 
务 的 特定 实现 类 。 程 序 第 二 段 粗 体 字 代码 为 test Bean 配置 了 事务 代理 。 
配置 事务 代理 时 需要 传 入 一 个 事务 管理 器 、 一 个 目标 Bean， 并 指定 该 事务 代理 的 事务 属性 ， 事 务 
属性 由 transactionAttributes 属性 指定 。 上 面 事务 属性 只 有 一 条 事务 传播 规则 ， 该 规则 指定 对 于 所 有 方 
法 都 使 用 PROPAGATION_REQUIRED 的 传播 规则 。Spring 支持 的 事务 传播 规则 如 下 。 
> ”PROPAGATION_MANDATORY: 要 求 调用 该 方法 的 线程 必须 处 于 事务 环境 中 , 否则 抛 出 异常 。 
> ”PROPAGATION_NESTED: 如 果 执 行 该 方法 的 线程 已 处 于 事务 环境 下 , 依然 启动 新 的 事务 ， 
方法 在 嵌 套 的 事务 里 执行 。 如 果 执行 该 方法 的 线程 并 未 处 于 事务 中 ， 也 启动 新 的 事务 ， 然 后 
执行 该 方法 ， 此 时 与 PROPAGATION_REQUIRED 相同 。 
> ” ”PROPAGATION_NEVER: 不 允许 调用 该 方法 的 线程 处 于 事务 环境 下 ,如果 调用 该 方法 的 线 
程 处 于 事务 环境 下 ， 则 抛 出 异常 。 
> ”PROPAGATION_NOT_SUPPORTED: 如 果 调用 该 方法 的 线程 处 在 事务 中 ， 则 先 暂停 当前 
事务 ， 然 后 执行 该 方法 。 
> PROPAGATION_REQUIRED: 要 求 在 事务 环境 中 执行 该 方法 ， 如 果 当 前 执行 线程 已 处 于 事 
务 中 ， 则 直接 调用 如果 当前 执行 线程 不 处 于 事务 中 ， 则 启动 新 的 事务 后 执行 该 方法 。 
> ”PROPAGATION_REQUIRES_NEW: 该 方法 要 求 在 新 的 事务 环境 中 执行 ， 如 果 当 前 执行 线 
程 已 处 于 事务 中 ， 则 先 暂停 当前 事务 ， 启 动 新 事务 后 执行 该 方法 ， 如 果 当 前 调用 线程 不 处 于 
事务 中 ， 则 启动 新 的 事务 后 执行 方法 。 
> ” ”PROPAGATION_SUPPORTS: 如 果 当 前 执行 线程 处 于 事务 中 ， 则 使 用 当前 事务 ,否则 不 使 
用 事务 。 
主 程序 面向 NewsDao 接口 编程 , TransactionProxyFactoryBean 生成 的 代理 Bean 也 会 实现 NewsDao 
接口 ， 因 此 主 程序 无 须 了 解 业务 组 件 的 底层 实现 。 下 面 是 本 应 用 的 主 程序 代码 。 
程序 清单 : codes\08\8.5\TransactionProxyFactoryBean\src\lee\SpringTest.java 


public class SpringTest 
{ ; 
public static void main(String[] args) 


{ 
// 创 建 Spring 容器 
ApplicationContext ctx = new > SS 
ClassPathXmlApplicationContext ("bean.xml"); 
// 获 取 事 务 代理 Bean + 
NewsDao dao = (NewsDao)ctx 庆 是 
.getBean("newsDaoTrans" , NewsDao.class); ~ 
// 执 行 插入 操作 Y 
dao.insert ("疯狂 Java” ，" 轻 量 级 Java EE 企业 应 用 实战 "); 
} 
1 


上 面 的 程序 中 第 一 行 粗 体 字 代码 获取 了 newsDaoTrans Bean， 该 Bean 已 经 不 再 是 NewsDaoImpl 
类 的 实例 了 , 它 只 是 Spring 容器 创建 的 事务 代理 ,该 事务 代理 以 NewsDaoImpl 实例 为 目标 对 象 ， 且 该 
目标 对 象 也 实现 了 NewsDao 接口 (与 NewsDaolmpl 实现 了 相同 接口 ), 故 代理 对 象 也 可 当成 NewsDao 
实例 使 用 。 

运行 上 面 的 程序 ， 将 出 现 一 个 异常 ， 而 且 insert0 方 法 所 执行 的 两 条 SQL 语句 全 部 回 滚 一 一 因为 
事务 控制 的 缘故 。 
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当 我 们 使 用 TransactionProxyFactoryBean 为 目标 Bean 配置 了 事务 代理 之 后 , Spring AOP 将 会 把 负 
责 事务 操作 的 增强 处 理 织 入 目标 Bean 的 业务 方法 中 。 在 这 种 情况 下 , 事务 代理 的 业务 方法 将 如 图 8.20 
所 示 。 


图 8.20 事务 代理 的 业务 方法 


事实 上 ，Spring 不 仅 支持 对 接口 的 代理 ， 整 合 CGLIB 后 ，Spring 甚至 可 对 具体 类 生成 代理 ， 只 要 
设置 proxyTargetClass 属性 为 tue 就 可 以 。 如 果 目 标 Bean 没有 实现 任何 接口 ，proxyTargetClass 属性 默 
认 被 设 为 ue， 此 时 Spring 会 对 具体 类 生成 代理 。 当 然 ， 通 常 建议 面向 接口 编程 ， 而 不 要 面向 具体 的 


>>8.5.3 Spring2.X 的 事务 配置 策略 


虽然 前 面 介绍 的 TransactionProxyFactoryBean 配置 策略 简单 易 懂 ， 但 配置 起 来 极为 烦琐 ， 每 个 目 
标 Bean 都 需要 额外 配置 一 个 TransactionProxyFactoryBean 代理 ， 这 种 方式 将 导致 配置 文件 急剧 增加 。 
Spring 2.X 的 XML Schema 方式 提供 了 更 简洁 的 事务 配置 策略 ，Spring 2.X 提供 了 tx 命名 空间 来 
配置 事务 管理 ，tx 命名 空间 下 提供 了 <bxcadvice.. 人 > 元 素来 配置 事务 增强 处 理 ， 一 旦 使 用 该 元 素 配置 了 
事务 增强 处 理 ， 就 可 直接 使 用 <aop:advisor... 人 > 元 素 启用 自动 代理 了 。 
下 面 的 应 用 示例 依然 使 用 前 面 提供 的 Test 接口 和 TestImpl 实现 类 ， 但 改 为 使 用 <tx:advice..…/> 元 素 
来 配置 事务 增强 处 理 ， 再 使 用 <aop:advisor.. 人 > 为 容器 中 一 批 Bean 配置 自动 事务 代理 。 
下 面 是 本 应 用 示例 所 使 用 的 配置 文件 。 
程序 清单 : codes\08\8.5\tx\src\bean.xml 
<?xml Version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi=nhttp://www.w3.org/2001/XMLSchema-instancen 
xmlns="http://www.springframework.org/schema/beans" 
xmlns:aop="http://w™w.springframework.org/schema/aop" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 专 
http://www.springframework.org/schema/beans/spring-beans-3.0,xsd 
http://ww.springframework.org/schema/tx ey 
http://ww. springframework.org/schema/tx/spring-tx-3.0.xsd 
http://www. springframework .org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实 现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"> 
<!-- 指定 连接 数据 库 的 驱动 一 > 
<property name="driverClass" value="com.mysql.jdbc.Driver"/> 
<!-- 指定 连接 数据 库 的 URL -> 
<property name="jdbcUrl" value="jdbc:mysql://localhost/javaee"/> 
<!-- 指定 连接 数据 库 的 用 户 名 -> 
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<property name="user" value="root"/> 
<!-- 指定 连接 数据 库 的 密码 --> 

<property name="password" value="32147"/> 
<!-- 指定 连接 数据 库 连接 池 的 最 大 连接 数 --> 
<property name="maxPoolSize" value="40"/> 


<!-- 指定 连接 数据 库 连接 池 的 最 小 连接 数 -> 


"/> 


<property name="minPoolSize" valui 
<!-- 指定 连接 数据 库 连 接 池 的 初始 化 连接 数 --> 
<property name="initialPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连 接 池 的 连接 的 最 大 空闲 时 间 一 -> 
<property name="maxIdleTime" value="20"/> 
</bean> 
<!-- 配置 JDBC 数据 源 的 局 部 事务 管理 器 ， 使 用 DataSourceTransactionManager 类 --> 
<!-- 该 类 实现 PlatformTransactionManager 接口 ， 是 针对 采用 数据 源 连 接 的 特定 实现 --> 
<bean id="transactionManager™" 
class="org. springframework. jdbe.datasource.DatasourceTransactionManager"> 
<!-- 配置 DataSourceTransactionManager 时 需要 依 注入 DataSource 的 引用 --> 
<property name="dataSource" ref="dataSource"/> 
</bean> 
<!-- 配置 一 个 业务 逻辑 Bean -> 
<bean id="newsDao" class="org.crazyit.app.dao.impl.NewsDaoImpl"> 
<property name="ds" ref="dataSource"/> 
</bean> 
<!-- 配置 事务 增强 处 理 Bean, 指定 事务 管理 器 --> 
<tx:advice id="txAdvice" 
transaction-manager="transactionManager"> 
<!-- 用 于 配置 详细 的 事务 语义 --> 
<tx:attributes> 
<!-- 所 有 以 'get ' 开 头 的 方法 是 read-only 的 --> 
<tx:method name="get*" read-only="true"/> 
<!-- 其 他 方法 使 用 默认 的 事务 设置 --> 
<tx:method name="*"/> 
</tx:attributes> 


i 各 生 一 个 切入 点， 匹配 org.crazyit.app.dao.impl 包 下 
所 有 以 Impl 结尾 的 类 里 、 所 有 方法 的 执行 --> 

<aop:Pointcut id="myPointout" 
expression="execution(* org.crazyit.app.dao.impl.*Impl.*(..))"/> 
<!-- 指定 在 txAdvice 切入 点 应 用 txAdvice 事务 增强 处 理 --> 

<aop:advisor advice-ref="txAdvice" 
pointcut-ref="myPointcut"/> 

</aop:config> 
</beans> 


上 面 的 配置 文件 的 第 一 段 粗 体 字 代码 使 用 XML Schema 启用 了 Spring 配置 文件 的 tx、aop 两 个 命 

名 空间 ， 配 置 文件 的 第 二 段 粗 体 字 代码 配置 了 一 个 事务 增强 处 理 ， 配 置 <tx:advice... 记 元素 时 只 需 指定 
-个 transaction-manager 属性 ， 该 属性 的 默认 值 是 'transactionManager 。 

提示 一 

如 果 事务 管理 器 Bean( Platform TransactionManager 实现 类 ) 的 名 字 是 transactionManager， ， 

Fg 则 配置 <tx:advice... 人 > 元 素 时 完全 可 以 省 略 指定 transaction-manager 属性 .只 有 当 我 们 为 事务 ! 

管理 器 Bean 指定 了 其 他 名 字 时 , 才 需 要 为 <bx: advict 


伺 元 素 指定 transaction-manager 属性 。 


配置 文件 中 最 后 一 段 粗 体 字 是 <aop:config.. 信 定义 ， 它 确保 由 txAdvice 切面 定义 事务 增强 处 理 能 
在 合适 的 点 被 织 入 。 首 先 我 们 定义 了 一 个 切入 点 ， 它 匹配 org.crazyit.app.dao.impl 包 下 所 有 以 Impl 结 
尾 的 类 所 包含 的 所 有 方法 ， 我 们 把 该 切入 点 叫做 myPointcut。 然 后 用 一 个 Advisor 把 这 个 切入 点 与 
txAdvice 绑 定 在 一 起 ， 表 示 当 myPointcut 执行 时 ，txAdvice 定义 的 增强 处 理 将 被 织 入 。 
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6 


概念 里 并 没有 所 谓 的 “Advisor"，Advisor 是 Spring 1.X 遗留 下 来 的 一 个 东西 。Advisor 的 
| ”作用 非常 简单 : 将 Advice 和 切入 点 〔 婚 可 通过 pointcut-ref 指定 一 个 已 有 的 切入 点 ， 也 可 
: ”通过 pointcut 指定 切入 表达 式 ) 绑 定 在 一 起 ， 保 证 Advice 所 包含 的 增强 处 理 将 在 对 应 的 切 | 
| 入 点 被 织 入 。 
当 我 们 使 用 这 种 配置 策略 时 ， 无 须 为 每 个 业务 Bean 专门 配置 事务 代理 ，Spring AOP 会 为 业务 组 
件 自动 生成 代理 ， 程 序 可 以 直接 请 求 容器 中 test Bean， 该 Bean 的 方法 已 经 具有 了 事务 性 一 一 因为 该 
Bean 的 实现 类 位 于 org.crazyit.app.dao.impl 包 下 ， 且 以 Impl 结尾 ， 和 myPointcut 切入 点 匹配 。 
本 示例 的 主 程序 非常 简单 ,直接 获取 newsDao Bean， 并 调用 它 的 insert0 方 法 ,可 以 看 到 该 方法 已 
经 具有 了 事务 性 。 
程序 清单 :codes\08\8.5\tx\src\lee\SpringTestjava 
Public class SpringTest 


Re 提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 - 一 一 - 
OS <aop:advisor'.. 记 元 素 是 一 个 很 奇怪 的 东西 ， 它 用 于 配置 一 个 Advisor， 但 标准 的 AOP 


public static void main(String[] args) 


// 创 建 Spring 容器 

ApplicationContext ctx = new 
ClassPathXxmlApplicationContext ("bean.xml"); 

// 获 取 事 务 代理 Bean 

NewsDao dao = (NewsDao)ctx 
.getBean ("newsDao" , NewsDao.class); 

// 执 行 插入 操作 

dao.insert ("疯狂 Java”，" 轻 量 级 Java EE 企业 应 用 实战 ") 7 

} 
} 


上 面 的 配置 文件 直接 获取 容器 中 的 newsDao Bean， 因 为 Spring AOP 会 为 该 Bean 自动 织 入 事务 增 
强 处 理 的 方式 ， 所 以 newsDao Bean 里 的 所 有 方法 都 具有 事务 性 。 

当 采 用 这 种 策略 时 还 有 一 个 额外 的 优势 : Spring 容器 中 只 有 一 个 newsDao Bean, 该 newsDao Bean 
已 经 具有 了 事务 性 ， 不 像 采 用 TransactionProxyFactoryBean 策略 时 ， 容 器 中 有 一 个 目标 Bean， 还 有 为 
该 目标 Bean 配置 的 事务 代理 Bean 一 一 当 程序 “不 小 心 ”获取 了 目标 Bean 后 ， 如 果 调 用 目标 Bean 的 
方法 时 ， 这 些 方法 将 是 不 具备 事务 性 的 ， 这 可 能 埋 下 一 些 安全 隐患 。 

当 采 用 <aop:advisor.. 人 > 元 素 将 Advice 和 切入 点 绑 定时 ， 实 际 上 是 由 Spring 提供 的 Bean 后 处 理 器 
完成 的 。Spring 提供 了 BeanNameAutoProxyCreator、DefaultAdvisorAutoProxyCreator 两 个 Bean 后 处 理 
器 , 它们 都 可 以 后 处 理 容器 中 的 Bean (为 它们 织 入 切面 中 包含 的 处 理 )。 前 面 我 们 配置 <aop:advisor../> 
元 素 时 传 入 一 个 kAdvice 事务 增强 处 理 , 所 以 Bean 后 处 理 器 将 为 所 有 Bean 实例 里 匹配 切入 点 的 方法 
织 入 事务 操作 的 增强 处 理 。 

配置 <tx:advice... 人 > 元 素 时 除了 需要 一 个 transaction-manager 属性 之 外 ， 重 要 的 是 需要 配置 一 个 
<attributes.…. 人 > 子 元 素 ， 该 子 元 素 里 又 可 包含 多 个 <method... 人 > 子 元 素 。<bcadvice... 亿 元素 的 属性 、 子 元 
素 如 图 8.21 所 示 。 

从 图 8.21 可 以 看 出 ， 配 置 <tx:advice.…/> 元 素 的 重点 就 是 配置 <method..…/> 子 元 素 ， 实 际 上 每 个 
<method.… 人 > 子 元 素 为 一 批 方法 指定 所 需 的 事务 语义 ， 包 括 事务 传播 属性 、 事 务 隔离 属性 、 事 务 超时 属 
性 、 只 读 事 务 、 对 指定 异常 回 滚 、 对 指定 异常 不 回 滚 等 。 

如 图 8.21 所 示 ， 配 置 <method... 人 > 子 元 素 可 以 指定 如 下 几 个 属性 。 

> name: 必 选 属性 , 与 该 事务 语义 关联 的 方法 名 。 该 属性 支持 使 用 通配符 , 例如 'get*、'handle*、 

'on*Event' 等 。 
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图 8.21 配置 <be:advice../> 元 素 


propagation: 指定 事务 传播 行为 ， 该 属性 值 可 为 Propagation 枚 举 类 的 任 一 枚 举 值 ， 各 枚 举 
值 的 含义 和 8.5.2 节 的 介绍 完全 一 样 。 该 属性 的 默认 值 为 Propagation.REQUIRED。 
isolation: 指定 事务 隔离 级 别 ， 该 属性 值 可 为 lsolation 枚 举 类 的 任 一 枚 举 值 ， 各 枚 举 值 的 具 
体 含义 可 参考 API 文档。 该 属性 的 默认 值 为 Isolation.DEFAULT。 

timeout: 指定 事务 超时 的 时 间 (以 秒 为 单位 ) ,指定 -1 意味 着 不 超时 ,该 属性 的 默认 值 是 -1。 
read-only: 指定 事务 是 否 只 读 。 该 属性 的 默认 值 是 false。 

rollback-for: 指定 触发 事务 回 滚 的 异常 类 (应 使 用 全 限定 类 名 ) ， 该 属性 可 指定 多 个 异常 类 ， 
多 个 异常 类 之 间 以 英文 逗号 隔 开 。 

no-rollback-for: 指定 不 触发 事务 回 滚 的 异常 类 (应 使 用 全 限定 类 名 ) ,该 属性 可 指定 多 个 异 
常 类 ， 多 个 异常 类 之 间 以 英文 逗号 隔 开 。 


在 这 种 策略 下 , 我 们 完全 可 以 为 不 同业 务 逻辑 方法 指定 不 同 的 事务 策略 , 如 下 面 的 配置 文件 所 示 。 
<?xml version="l.0" encoding="GBK"?> 

<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 


xmlns="http://www:springframework.org/schema/beans" 
xmlns:acp="http://ww. springframework.org/schema/aop" 


xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www ,springframework.org/schema/beans/spring-beans-3.0.xsd 
http://w™w.springfranework.org/schema/tx 
http://ww.springframework.org/schema/tx/spring-tx-3,0.xsd 
Mee //w™.springframework.org/schema/aop 
/ww 和 org/schema/aop/spring-aop-3.0.xsd"> 
配置 两 个 事务 增强 处 理 一 
:advice a desacl tn maven 
<tx:attributes> 
<tx:method name="get*" read-only="true"/> 
<tx:method name="*"/> 
</tx:attributes> 
</tx:advice> 
<tx:advice id="noTxAdvice"> 
<tx:attributes> 
<tx:method name="*" propagation="NEVER"/> 
</tx:attributes> 
</tx:advice> 
<aop:config> 
<!-- 配置 一 个 切入 点 ， 匹 配 ns ee Bean 中 所 有 方法 的 执行 一 > 
<aop:pointcut id="txOperation 
es "/> 
<!-- 配置 一 个 切入 点 ， 匹 配 org-crazyit.app.service 包 下 
所 有 以 Manager 结尾 的 类 的 所 有 方法 的 执行 eS 
<aop:pointcut id="noTxOperation’ 
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expression="execution(* org.crazyit. .app.service. *Manager.*(..))"/> 
<!-- 将 txOperation 切入 点 和 defaultTxAdvice 切面 绑 定 在 一 起 --> 
<aop:advisor pointcut-ref=" txOperation " 
advice-ref="defaultTxAdvice"/> 
<!-- 将 noTxOperation 切入 点 和 noTxAdvice 切面 绑 定 在 一 起 --> 
<aop:advisor pointcut-ref=nnoTxOperationn 
advice-ref="noTxAdvice"/> 
</aop:config> 
<!-- 配置 第 一 个 业务 逻辑 Bean， 实 现 类 位 于 lee 包 下 
将 被 织 入 defaultTxAdvice 切面 里 的 增强 处 理 --> 
<bean id="userService" class="org.crazyit.app.service.UserServiceImpl"/> 
<!-- 配置 第 二 个 业务 逻辑 Bean， 实 现 类 位 于 org.crazyit.app.service 包 下 
将 被 织 入 noTxAdvice 切面 里 的 增强 处 理 --> 
<bean id="anotherFooService" class="org.crazyit.service.AuctionManager"/> 
</beans> 


Ne Checked 异常 时 自动 回 滚 ， 则 可 借助 于 rollback-for 属性 。 


:在 跨 认 情 况 下 ， 只 有 当 抽出 运行 时 异常 和 unChecked 异常 时 ， Spring 事务 框架 才 会 自 ， 
动 回 滚 事务 。 也 就 是 说 ， 只 有 当 抛 出 一 个 RuntimeException 或 其 子 类 实例 ， 以 及 Error 对 1! 


通过 使 用 rollback-for 属性 可 强制 Spring 遇 到 特定 Checked 异常 时 自动 回 滚 事务 ， 下 面 的 XML 配 
置 片段 示范 了 这 种 用 法 。 
<tx:advice id="txAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<!-- 所 有 以 get 开头 的 方法 是 只 读 的 ， 
且 当 事务 方法 抛 出 NoItemException 异常 时 自动 回 滚 --> 
<tx:method name="get*" read-only="true" 
rollback-for="exception.NoItemException"/> 
<tx:method name="*"/> 
</tx:attributes> 
</tx:advice> 
如 果 想 让 事务 方法 抛 出 指定 异常 时 强制 不 回 滚 事务 ， 则 可 通过 no-rollback-for 属性 来 指定 ， 如 下 
面 的 配置 片段 所 示 。 
<tx:advice id="txAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<!-- 所 有 以 get 开头 的 方法 是 只 读 的 ， 
且 当 事务 方法 抛 出 NoItemException 异常 时 自动 回 滚 --> 
<tx:method name="get*" read-only="true" 
no-rollback-for="exception.NoItenException"/> 
<tx:method name="#*"/> 
</tx:attributes> 
</tx:advice> 


>》>8.5.4 使 用 @Transactional 


Spring 还 允许 将 事务 配置 设置 放 在 Java 类 中 定义 ， 这 需要 借助 于 @Transactional Annotation， 该 
Annotation 既 可 用 于 修饰 Spring Bean 类 ， 也 可 用 于 修饰 Bean 类 中 的 某 个 方法 。 

如 果 使 用 @Transactional 修饰 Bean 类 ， 表 明 这 些 事务 设置 对 整个 Bean 类 起 作用 ; 如 果 使 用 
@Transactional 修饰 Bean 类 的 某 个 方法 ， 表 明 这 些 事务 设置 只 对 该 方法 有 效 。 

使 用 @Transactional 时 可 指定 如 下 方法 。 

> ， isolation: 用 于 指定 事务 的 隔离 级 别 。 默 认为 底层 事务 的 隔离 级 别 。 

> ”noRollbackFor: 指定 遇 到 指定 异常 时 强制 不 回 滚 事务 。 

> ”noRollbackForClassName: 指定 遇 到 指定 多 个 异常 时 强制 不 回 滚 事务 。 该 属性 值 可 以 指定 
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多 个 异常 类 名 。 
propagation: 指定 事务 传播 属性 。 
readOnly: 指定 事务 是 否 只 读 。 
rollbackFor: 指定 遇 到 指定 异常 时 强制 回 滚 事务 。 
rollbackForClassName: 指定 遇 到 指定 多 个 异常 时 强制 回 滚 事务 。 该 属性 值 可 以 指定 多 个 异 
党 类 名 。 
> timeout: 指定 事务 的 超时 时 长 。 
根据 上 面 的 解释 不 难看 出 ， 其 实 该 Annotation 所 指定 的 属性 与 <bcadvice.../> 元 素 中 能 指定 的 事务 
属性 基本 上 是 对 应 的 ， 它 们 的 意义 也 基本 相似 。 
下 面 使 用 @Transactional 修饰 需要 添加 事务 的 方法 。 
程序 清单 :codes\08\8.5\Transactional\src\org\crazyitapp\dao\impl\NewsDaoImpl 


public class NewsDaoImpl 
implements NewsDao 


YY 


{ 


QTransactional (propagation=Propagation .REQUIRED) 
Public void insert (String title 
，String content) 


{ 


上 
) 


上 面 的 Bean 类 中 insert0 方 法 使 用 了 @Transactional 修饰 ， 表 明 该 方法 就 会 具有 事务 性 。 仅 使 用 这 
个 Annotation 修饰 还 不 够 ， 还 需要 在 让 Spring 根据 Annotation 来 配置 事务 代理 。 所 以 还 需要 在 Spring 
配置 文件 中 增加 如 下 配置 片段 : 
<!-- 配置 JDBC 数据 源 的 局 部 事务 管理 器 ， 使 用 DataSourceTransactionManager 类 --> 
<!-~ 该 类 实现 PL1atformTral onManager 接口 ， 是 针对 采用 数据 源 连 接 的 特定 实现 --> 
<bean id="transactionManagern 
class="org. springframework.jdbc.datasource. DataSourceTransactionManager"> 
<!-- 配置 DatasourceTransactionManager 时 需要 依 注入 DataSource 的 引用 --> 
<property name="dataSource" ref="dataSource"/> 
</bean> 
<!-- 根据 Annotation 来 生成 事务 代理 --> 
<tx:annotation-driven transaction-manager="transactionManager"/> 


8.6 Spring 整合 Struts 2 


虽然 Spring 也 提供 了 自己 的 MVC 组 件 , 但 一 来 Spring 的 MVC 组 件 稍 嫌 烦 琐 ,， 二 来 Struts 2 的 拥 
护 者 实在 太 多 。 因 此 ， 很 多 项 目 都 会 选择 使 用 Spring 整合 Struts 2 框架 。 而 且 Spring 完全 可 以 无 缝 整 
合 Stuts 2 框架 ， 二 者 结合 成 一 个 更 实际 的 Java EE 开发 平台 。 


8.6.1 启动 Spring 容器 


介绍 Spring 容器 时 ， 已 经 清楚 地 说 过 ， 对 于 使 用 Spring 的 Web 应 用 ， 无 须 手动 创建 Spring 容器 ， 
而 是 通过 配置 文件 ， 声 明 式 地 创建 Spring 容器 。 因 此 在 Web 应 用 中 创建 Spring 容器 有 如 下 两 种 方式 : 

> ”直接 在 web.xml 文件 中 配置 创建 Spring 容器 。 

> ”利用 第 三 方 MVC 框架 的 扩展 点 ， 创 建 Spring 容器 。 

其 实 第 一 种 创建 Spring 容器 的 方式 更 加 常见 。 为 了 让 Spring 容器 随 Web 应 用 的 启动 而 自动 启动 ， 
借助 于 ServletContextListener 监听 器 即 可 完成 ， 该 监听 器 可 以 在 Web 应 用 启动 时 回调 自 定义 方法 
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和 


该 方法 就 可 以 启动 Spring 容器 。 

Spring 提供 了 一 个 ContextLoaderListener， 该 监听 器 类 实现 了 ServletContextListener 接口 。 该 类 可 
以 作为 Listener 使 用 ， 它 会 在 创建 时 自动 查找 WEB-INF/ 下 的 applicationContextxml 文件 ， 因 此 ， 如 果 
只 有 一 个 配置 文件 ， 并 且 文 件 名 为 applicationContextxml， 则 只 需 在 web.xml 文件 中 增加 如 下 配置 片 
段 即 可 。 

<listener> 
<listener-class>org. springframework .web.context.ContextLoaderListener 
</listener-class> 

</listener> 

如 果 有 多 个 配置 文件 需要 载 入 ， 则 考虑 使 用 <context-param... 人 > 元 素来 确定 配置 文件 的 文件 名 。 
ContextLoaderListener 加 载 时 ， 会 查找 名 为 contextConfigLocation 的 初始 化 参数 。 因 此 ， 配 置 
<context-param..…/> 时 应 指定 参数 名 为 contextConfigLocation。 

带 多 个 配置 文件 的 web.xml 文件 如 下 : 


<?xml version="1.0" encoding="GBK"?> 
<web-app xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.0rg/2001/XMLschema-instance" 
.sun.com/xml /ns/javaee 
//java. sun. com/xml/ns/javaee/web-app_3_0.xsd" version="3.0"> 
!-~ 指定 多 个 配置 文件 一 > 
<context-param> 
-- 参数 名 为 contextConfigLocation --> 
param-name>contextConfigLocation</param-name> 
<!-- 多 个 配置 文件 之 间 以 “,” 隔 开 一 -> 
<param-value>/WEB-INF/daoContext.xml 
/WEB-INF/applicationContext .xml</param-value> 
</context-param> 
<!-- 使 用 ContextLoaderListener 初始 化 Spring 容器 --> 
<listener> 
<listener-class>org. springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 
</web-app> 


如 果 没 有 使 用 contextConfigLocation 指定 配置 文件 ， 则 Spring 自动 查找 applicationContext.xml 配 
置 文件 ， 如 果 有 contextConfigLocation， 则 利用 该 参数 确定 的 配置 文件 。 如 果 无 法 找到 合适 的 配置 文 
件 ，Spring 将 无 法 正常 初始 化 。 

Spring 根据 指定 配置 文件 创建 WebApplicationContext 对 象 ， 并 将 其 保存 在 Web 应 用 的 
ServletContext 中 。 大 部 分 情况 下 ， 应 用 中 的 Bean 无 须 感受 到 ApplicationContext 的 存在 ， 只 要 利用 
ApplicationContext 的 IoC 即 可 。 

如 果 需 要 在 应 用 中 获取 ApplicationContext 实例 ， 则 可 以 通过 如 下 代码 获取 : 


// 获 取 当前 Web 应 用 的 Spring 容器 
WebApplicationContext ctx = WebApplicationContextUtils 
getWebApplicationContext (servletContext); 


当然 ， 也 可 以 通过 ServletContext 的 getAttribute 方法 获取 ApplicationContext 。 但 使 用 
WebApplicationContextUtils 类 更 方便 ， 因 为 这 样 无 须 记 住 ApplicationContext 在 ServletContext 中 的 属 
性 名 (属性 名 为 WebApplicationContexLROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE)。 使 用 
WebApplicationContextUtils 还 有 一 个 额外 的 好 处 : 即使 ServletContext 的 WebApplicationContext. 
ROOT_WEB_APPLICATION_CONTEXT_ ATTRIBUTE 属性 没有 相应 的 对 象 ， WebApplication- 
ContextUtils 的 getWebApplicationContext0 方 法 将 会 返回 空 ， 而 不 会 引起 异常 。 

还 有 一 种 情况 ， 即 利用 第 三 方 MVC 框架 的 扩展 点 来 创建 Spring 容器 ， 比 如 Stmts1， 但 这 种 情况 
通常 只 对 特定 框架 才 有 效 ， 故 此 处 不 再 袭 述 。 
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> >8.6.2 MVC 框架 与 Spring 整合 的 思考 


对 于 一 个 基于 B/S 架构 的 Java EE 应 用 而 言 ， 用 户 请 求 总 是 向 MVC 框架 的 控制 器 请 求 ， 而 当 控 
制 器 拦截 到 用 户 请 求 后 ， 必 须 调用 业务 逻辑 组 件 来 处 理 用 户 请 求 。 此 时 有 一 个 问题 : 控制 器 应 该 如 何 
获得 业务 多 辑 组 件 ? 

最 容易 想到 的 策略 是 ， 直 接 通过 new 关键 字 创建 业务 逻辑 组 件 ， 然 后 调用 业务 逻辑 组 件 的 方法 ， 
根据 业务 罗 辑 方法 的 返回 值 确定 结果 。 

在 实际 的 应 用 中 ， 很 少见 到 采用 上 面 的 访问 策略 ， 因 为 这 是 一 种 非常 差 的 策略 。 不 这 样 做 至 少 有 
如 下 三 个 原因 : 

> 。 控制 器 直接 创建 业务 逻辑 组 件 ， 导 致 控制 器 和 业务 逻辑 组 件 的 耦合 降低 到 代码 层次 ， 不 利于 

高 层次 解 耦 。 

> “控制 器 不 应 该 负责 业务 逻辑 组 件 的 创建 ， 控 制 器 只 是 业务 逻辑 组 件 的 使 用 者 ， 无 须 关系 业务 

逻辑 组 件 的 实现 。 

> 每 次 创建 新 的 业务 逻辑 组 件 导 致 性 能 下 降 。 

答案 是 采用 工厂 模式 ， 或 者 服务 定位 器 模式 。 对 于 采用 服务 定位 器 模式 ， 是 远程 访问 的 场景 。 在 
这 种 场景 下 ， 业 务 逻辑 组 件 已 经 在 某 个 容器 中 运行 ， 并 对 外 提供 某 种 服务 。 控 制 器 无 须 理会 该 业务 多 
辑 组 件 的 创建 ， 直 接 调 用 该 服务 即 可 ， 但 在 调用 之 前 ， 必 须 先 找到 该 服务 一 一 这 就 是 服务 定位 器 的 概 
念 。 经 典 Java EE 应 用 就 是 这 种 结构 的 应 用 。 

对 于 轻 量 级 的 Java EE 应 用 ,工厂 模式 则 是 更 实际 的 策略 。 因 为 在 轻 量 级 Java EE 应 用 中 ,业务 逻 
辑 组 件 不 是 EJB， 通 常 就 是 一 个 POJO， 业 务 逻辑 组 件 的 生成 通常 应 由 工厂 负责 ， 而 且 工 厂 可 以 保证 
该 组 件 的 实例 只 需 一 个 就 够 了 ， 可 以 避免 重复 实例 化 造成 的 系统 开销 。 

如 图 8.22 所 示 就 是 采用 工厂 模式 的 顺序 图 。 


二 BB @ 


图 8.22 工厂 模式 顺序 图 


采用 工厂 模式 ， 将 控制 器 与 业务 逻辑 组 件 的 实现 分 离 ， 从 而 提供 更 好 的 解压 。 在 采用 工厂 模式 的 
访问 策略 中 ， 所 有 的 业务 逻辑 组 件 的 创建 由 工厂 负责 ， 业 务 逻 辑 组 件 的 运行 也 由 工厂 负责 。 而 控制 器 
只 需 定位 工厂 实例 即 可 。 

如 果 系统 采用 Spring 框架 ， 则 Spring 成 为 最 大 的 工厂 。Spring 负责 业务 逻辑 组 件 的 创建 和 生成 ， 
并 可 管理 业务 逻辑 组 件 的 生命 周期 。 可 以 如 此 理解 : Spring 是 个 性 能 非常 优秀 的 工厂 ， 可 以 生产 出 所 
有 的 实例 ， 从 业务 逻辑 组 件 ， 到 持久 层 组 件 ， 甚 至 控制 器 组 件 。 

现在 的 问题 是 : 控制 器 如 何 访问 到 Spring 容器 中 的 业务 逻辑 组 件 呢 ? 为 了 让 Action 访问 Spring 
的 业务 逻辑 组 件 ， 有 两 种 策略 : 

> ”Spring 容器 负责 管理 控制 器 Action， 并 利用 依赖 注入 为 控制 器 注入 业务 逻辑 组 件 。 
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> ”利用 Spring 的 自动 装配 ，Action 将 会 自动 从 Spring 容器 中 获取 所 需 的 业务 逻辑 组 件 。 
下 面 依次 介绍 这 两 种 实现 方式 。 


> >8.6.3 让 Spring 管理 控制 器 


让 Spring 容器 来 管理 应 用 中 的 控制 器 ， 可 以 充分 利用 Spring 的 IoC 特性 ， 但 需要 将 配置 Struts 2 
的 控制 器 部 署 在 Spring 容器 中 ， 因 此 导致 配置 文件 元 余 。 

正如 前 面 所 介绍 的 ，Struts 2 的 核心 控制 器 首先 拦截 到 用 户 请 求 ,然后 将 请 求 转发 给 对 应 的 Action 
处 理 ， 在 此 过 程 中 ，Struts 2 将 负责 创建 Action 实例 ， 并 调用 其 execute0 方 法 ， 这 个 过 程 是 固定 的 ( 除 
非 改写 Struts 2 的 核心 控制 器 )。 现在 的 情形 是 : 我 们 已 经 把 Action 实例 交 由 Spring 容器 来 管理 ,而 不 
是 由 Struts 2 产生 的 。 那么 , 核心 控制 器 如 何 知道 调用 Spring 容器 中 的 Action, 而 不 是 自行 创建 Action 
实例 呢 ? 这 个 工作 由 Struts 2 提供 的 Spring 插件 完成 。 

进入 Struts 2 项 目的 lib 目录 下 ， 可 以 找到 一 个 struts2-spring-plugin-2.2.1.jar 文件 ， 这 个 JAR 包 就 
是 Struts 2 整合 Spring 的 插件 ， 简 称 Spring 插件 。 为 了 将 Struts 2、Spring 进行 整合 开发 ， 首 先 应 该 将 
该 JAR 包 复制 到 Web 应 用 的 WEB-INF\lib 目录 下 。 

Spring 插件 提供 了 一 种 伪 Action， 当 我 们 在 struts.xml 文件 中 配置 Action 时 ， 通 常 需要 指定 class 
属性 ， 该 属性 就 是 用 于 创建 Action 实例 的 实现 类 。 但 Spring 插件 允许 我 们 指定 class 属性 时 ， 不 再 指 
定 Action 的 实际 实现 类 , 而 是 指定 为 Spring 容器 中 的 Bean ID, 这 样 Struts 2 不 再 自己 负责 创建 Action 
实例 ， 而 是 直接 通过 Spring 容器 去 获取 Action 对 象 。 

通过 上 面 的 方式 ， 我 们 发 现 了 这 种 整合 策略 的 关键 当 Struts 2 将 请 求 转发 给 指定 的 Action 时 ， 
Struts 2 中 的 该 Action 只 是 一 个 “ 俐 仿 ”， 它 只 有 一 个 代号 ， 并 没有 指定 实际 的 实现 类 ， 当 然 也 不 可 能 
创建 Action 实例 ， 而 隐藏 在 该 Action 下 的 是 Spring 容器 中 的 Action 实例 一 一 它 才 是 真正 处 理 用 户 请 
求 的 控制 器 。 

这 种 整合 流程 的 组 件 协作 图 如 图 8.23 所 示 。 


图 8.23 Spring 管理 Action 的 协作 图 


正如 在 图 8.23 中 看 到 的 ，Struts 2 只 是 配置 一 个 伪 控制 器 ， 这 个 伪 控制 器 的 功能 实际 由 Spring 容 
器 中 的 控制 器 来 完成 ， 这 就 实现 了 让 核心 控制 器 调用 Spring 容器 中 的 Action 来 处 理 用 户 请 求 。 

在 这 种 整合 策略 下 ， 处 理 用 户 请 求 的 Action 由 Spring 插件 负责 创建 ， 但 Spring 插件 创建 Action 
实例 时 ， 并 不 是 利用 配置 Action 时 指定 的 class 属性 来 创建 该 Action 实例 ， 而 是 从 Spring 容器 中 取出 
对 应 的 Bean 实例 完成 创建 。 


提示 ;… 一 … 一 … 一 … 一 … 一 … 一 .… 一 .一 .… 一 … 一 … 一 … 一 … 一 … 
由 于 本 系统 仅仅 是 一 个 示范 性 的 应 用 ， 因 此 没有 使 用 很 复杂 的 处 理 远 辑 ， 仅 仅 模拟 了 : 
一 种 程序 架构 .应 用 从 输入 页 面 开 始 ， 当 用 户 输 入 它们 的 用 户 名 、 密 码 后 ， 提 交 登 录 请 求 ， | 
| 请 求 发 送 到 Struts 2 的 控制 器 - j 
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图 8.24 系统 登录 页 面 


在 图 8.24 中 包含 了 两 个 简单 的 表单 域 , 分别 用 于 输入 系统 的 用 户 名 和 密码 ， 系 统 将 会 根据 用 户 输 
入 的 用 户 名 和 密码 来 处 理 登录 。 

为 了 处 理 用户 请 求 , 必须 提供 处 理 用 户 请 求 的 Action 类 , 该 Action 需要 调用 业务 逻辑 组 件 的 业务 
逻辑 方法 来 处 理 用 户 请 求 。 在 实际 的 Java EE 项 目 中 ，Action 只 是 系统 的 控制 器 ， 也 不 应 该 处 理 用 户 
请 求 ， 处 理 用 户 请 求 是 业务 逻辑 实现 ， 理 应 由 业务 逻辑 组 件 来 提供 实现 。 下 面 是 本 应 用 中 处 理 用 户 请 
求 的 Action 代码 。 

程序 清单 : codes\08\8.6\spring-manage-action\WEB-INF\src\org\crazyit\app\action\LoginAction.java 

public class LoginAction 
implements Action 


{ 

// 下 面 是 用 于 封装 用 户 请 求 参数 的 两 个 属性 

private String username; 

private String password; 

// 用 于 封装 处 理 结果 的 属性 

private String tip; 

// 系 统 所 用 的 业务 还 辑 组 件 

Private MyService ms; 

// 设 置 注入 业务 逻辑 组 件 所 必需 的 setter 方法 

public void setMs (MyService ms) 
this.ms = ms; 


} 
// 省 略 3 个 属性 的 setter 和 getter 方法 


// 处 理 用 户 请 求 的 execute 方法 
public String execute() throws Exception 


{ 
// 调 用 业务 逻辑 组 件 的 valid 方法 来 
// 验 证 用 户 输 入 的 用 户 名 和 密码 是 否 正确 
if (ms.valid(getUsername(), getPassword())) 


{ 
setTip(" 险 险 ， 整 合成 功 !"); 
return SUCCESS; 

} 

else 


return ERROR; 


上 面 程序 的 第 一 段 粗 体 字 代 码 提供 了 一 个 MyService 组 件 ， 并 为 该 组 件 提供 了 一 个 setter 方法 ， 
通过 该 setter 方法 ， 就 可 让 Spring 来 管理 Action 和 MyService 组 件 的 依赖 关系 ， 避 免 了 控制 器 和 业务 
组 件 之 间 的 硬 编码 耦合 。 

上 面 第 二 段 粗 体 字 代码 显示 : Action 调用 了 MyService 的 valid0 方 法 来 判断 用 户 名 、 密 码 是 否 正 
确 。 这 意味 着 处 理 用 户 登录 的 逻辑 由 MyService 组 件 提供 。 虽 然 本 应 用 中 的 业务 逻辑 组 件 只 包含 了 一 
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个 简单 方法 ， 但 实际 的 业务 逻辑 组 件 是 整个 应 用 的 核心 ， 它 可 以 包含 非常 复杂 的 处 理 逻 辑 。 此 处 想 示 
范 的 是 : 控制 器 可 以 获得 业务 逻辑 组 件 的 引用 ， 即 调用 业务 逻辑 组 件 的 所 有 方法 ， 这 就 完成 了 控制 器 
和 业务 逻辑 组 件 之 间 的 整合 。 


在 系统 中 配置 该 控制 器 ， 本 应 用 中 的 配置 文件 如 下 。 


程序 清单 : codes\08\8.6\spring-manage-action\WWEB-INF\src\struts.xml 


<2xml version="1.0" encoding="GBK"?> 
<!-- 指定 Struts 2 配置 文件 的 DTD 信息 --> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" 
"http://struts.apache,org/dtds/struts-2.1.7.dtd"> 
<!-- Struts 2 配置 文件 的 根 元 素 --> 
<struts> 
<!-- 配置 了 系列 常 最 --> 
<constant name="struts.il8n.encoding" value="GBK"/> 
<constant name="struts.devMode" value="true"/> 
<package name="lee" extends="struts-default"> 
<!-- 定义 处 理 用 户 请 求 的 Action， 该 Rction 的 class 属性 不 是 实际 处 理 类 
， 而 是 Spring 容器 中 的 Bean 实例 一 > 
<action name="loginPro" elass="loginAction"> 
<!-- 为 两 个 逻辑 视图 配置 视图 页 面 一 > 
<result name="error">/WEB-INF/content/error, jsp</result> 
<result name="success">/WEB-INF/content/welcome.jsp</result> 
</action> 
FS Ry 让 用 记 间 神功 生计 应 用时 放出 所 有 有福 因 页 a 
<action namern 
osult> /NEB-INF/content/ {1}. 人 
</action> 
</package> 
</struts> 


该 配置 文件 的 核心 在 于 粗 体 字 代码 处 ， 此 处 配置 Action 的 class 属性 时 ， 并 不 是 该 Action 类 的 实 
际 处 理 类 ， 而 是 loginAction 名 ， 该 loginAction 名 就 是 一 个 伪 控 制 器 ， 它 对 应 于 Spring 容器 中 的 一 个 
Bean 实例 。 

三- 注意: 

当 使 用 Spring 容器 管理 系统 的 Action 时 ,在 struts.xml 文件 中 配置 该 Action 时 ,class 
属性 并 不 是 指向 该 Action 的 实现 类 ， 而 是 指定 了 Spring 容器 中 Action 实例 的 ID， 


因此 本 应 用 的 业务 地 加 组 件 非常 简单 它 仅仅 示范 了 一 个 简单 的 处 理 方法 ， 该 方法 根据 传 入 的 用 
户 名 、 密 码 参数 来 决定 是 否 登 录 成 功 。 本 示例 程序 依然 面向 接口 编程 ， 所 以 业务 逻辑 组 件 由 接口 和 实 
现 类 两 个 部 分 组 成 ， 此 处 仅 给 出 其 实现 类 代码 。 

程序 清单 : codes\08\8.6\spring-manage-action\WWEB-INF\src\org\crazyitapp\service\limpl\MyServiceImpljava 

public class MyServiceImpl 

implements MyService 


{ 
public boolean valid(String username , String pass) 


{ 
td 故 直接 判断 用 户 名 、 密 码 
if ( username.equals("crazyit.org") 
de i 区 


return true; 
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» 
return false; 


} 
了 


正如 上 面 的 粗 体 字 代码 所 示 ， 该 业务 远 辑 组 件 的 实现 并 没有 数据 库 信息 处 理 ， 只 是 进行 了 简单 的 
判断 一 一 因为 访问 数据 库 不 是 本 示例 关注 的 重点 ! 只 要 我 们 的 Action 可 以 调用 该 业务 逻辑 组 件 方法 ， 
一 切 都 会 简单 起 来 。 如 果 业 务 逻 辑 需 要 根据 数据 库 状态 来 判断 用 户 登录 是 否 成 功 ， 则 可 以 在 业务 逻辑 
组 件 中 调用 DAO 组 件 来 实现 业务 逻辑 方法 ， 当 业务 逻辑 组 件 需要 DAO 组 件 时 ， 一样 让 Spring 管理 它 


们 的 依赖 关系 即 可 。 
下 面 将 该 业务 逻辑 组 件 部 署 在 Spring 容器 中 ， 配 置 该 业务 逻辑 组 件 的 配置 片段 如 下 : 


<!-- 部 署 一 个 业务 逻辑 组 件 --> 
<bean id="myService" 
class="org,crazyit .app. service. impl.MyServiceImpl"/> 


除 此 之 外 ， 还 应 该 在 Spring 容器 中 配置 前 面 的 Action 实例 ， 并 将 该 业务 逻辑 组 件 注入 到 Action 
实例 中 。 本 应 用 的 applicationContext.xml 配置 文件 的 代码 如 下 。 
程序 清单 : codes\08\8.6\spring-manage-action\WEB-INF\applicationContext.xml 


<?xml version="].0" encoding="GBK"?> 

<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

"http://www.w3.0org/2001/XMLSchema-instance" 

ttp://www. springframework.org/schema/beans" 

:schemaLocation="http://www.springframework.org/schema/beans 

http://www, springframework.org/schema/beans/spring-beans™3.0.xsd"> 

<!--~ 定义 一 个 业务 逻辑 组 件 ， 实 现 类 为 MyServiceImp --> 

<bean id="myServicen 
class="org.crazyit.app. service. impl.MyServiceImpl"/> 

<!-- 让 Spring 管理 的 Action 实例 --> 

<bean id="loginAction" class="org.crazyit.app.action.LoginAction" 


<property name="ms" ref="myService"/> 
</bean> 
</beans> 


正如 在 上 面 的 配置 文件 中 粗 体 字 代码 所 示 : 对 Spring 容器 而 言 ，Struts 2 的 Action 就 是 一 个 普通 
Bean， 也 可 接受 依赖 注入 ， 这 就 可 以 轻松 将 业务 逻辑 组 件 注入 该 Action Bean 中 。 当 Spring 管理 Struts 
2 的 Action 时 ， 一 定 要 配置 scope 属性 ， 因 为 Action 里 包含 了 请 求 的 状态 信息 ， 所 以 必须 为 每 个 请 求 
对 应 一 个 Action， 所 以 不 能 将 该 Action 实例 配置 成 单 例 模式 。 

本 

六 和 
i 当 使 用 Spring 容器 管理 Struts 2 的 Action 时 ， 由 于 每 个 Action 对 应 一 次 用 户 请 求 ， 
| 且 封装 了 该 次 请 求 的 状态 信息 , 所 以 不 应 将 Action 配置 成 单 例 模式 , 因此 必须 指定 scope 


属性 ， 该 属性 值 可 指定 为 prototype 和 request 两 种 。 


这 种 策略 充分 利用 了 Spring 的 IoC 特性 ， 是 一 种 较为 优秀 的 解 耦 策略 ， 这 种 策略 也 有 一 些 不 足 之 
处 。 归 纳 起 来 ， 主 要 有 如 下 不 足 之 处 : 
> ”Spring 管理 Action， 必 须 将 所 有 的 Action 配置 在 Spring 容器 中 ， 而 struts.xml 文件 中 还 需 
要 配置 一 个 “ 伪 Action ”， 从 而 导致 配置 文件 腑 肿 、 宛 余 。 
> ”Action 的 业务 逻辑 组 件 接收 容器 注入 ， 将 导致 代码 的 可 读 性 降低 。 


>>8.6.4 使 用 自动 装配 
在 这 种 策略 下 ，Action 还 是 由 Spring 插件 创建 ，Spring 插件 在 创建 Action 实例 时 ， 利 用 Spring 
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的 自动 装配 策略 ， 将 对 应 业务 逻辑 组 件 注入 Action 实例 。 这 种 整合 策略 配置 文件 简单 ， 但 控制 器 和 业 
务 逻 辑 组 件 耦合 又 提升 到 了 代码 层次 ， 耦 合 较 高 。 

如 果 我 们 不 指定 自动 装配 ， 则 系统 默认 使 用 按 name 自动 装配 。 在 前 面 的 整合 策略 下 ， 我 们 没有 
指定 任何 的 自动 装配 策略 ， 当 启动 Web 应 用 时 ， 将 看 到 如 图 8.25 所 示 的 提示 。 


Inltinlieieg Strvts -Spring Integretion 
0 mark2. util. logging. commons CommonsLogger 1 


图 8.25 ”系统 默认 使 用 按 name 自动 装配 策略 


所 谓 自动 装配 ， 即 让 Spring 自动 管理 Bean 与 Bean 之 间 的 依赖 关系 ， 无 须 使 用 ref 显 式 指定 依赖 
Bean。Spring 容器 会 自动 检查 XML 配置 文件 内 容 ， 为 主 调 Bean 注入 依赖 Bean。 自 动 装配 可 以 减少 
配置 文件 的 工作 量 ， 但 会 降低 依赖 关系 的 透明 性 和 清晰 性 。 

通过 使 用 自动 装配 ， 可 以 让 Spring 插件 自动 将 业务 逻辑 组 件 注入 Struts 2 的 Action 实例 中 。 

通过 设置 struts.objectFactory.spring.autoWire 常量 可 以 改变 Spring 插件 的 自动 装配 策略 , 该 常量 可 
以 接受 如 下 儿 个 值 。 

> name: 根 据 属性 名 自动 装配 .Spring 插件 会 查找 容器 中 全 部 Bean, 找 出 其 中 id 属性 与 Action 

所 需 的 业务 逻辑 组 件 同名 的 Bean， 将 该 Bean 实例 注入 到 Action 实例 。 
> type: 根 据 属性 类 型 自动 装配 .Spring 插件 会 查找 容器 中 全 部 Bean, 找 出 其 类 型 恰好 与 Action 
所 需 的 业务 逻辑 组 件 相同 的 Bean， 将 该 Bean 实例 注入 到 Action 实例 。 如 果 有 多 个 这 样 的 
Bean， 就 抛 出 一 个 致命 异常 ， 如 果 没 有 匹配 的 Bean， 则 什么 都 不 会 发 生 ， 属 性 不 会 被 设置 。 
> ”auto: Spring 插件 会 自动 检测 需要 使 用 哪 种 自动 装配 方式 。 
> ”constructor: 与 type 类 似 ， 区 别 是 constructor 使 用 构造 器 来 构造 注入 的 所 需 参数 ， 而 不 是 
使 用 设 值 注入 方式 。 

关于 Spring 自动 装配 的 介绍 ， 读 者 可 参看 本 书 前 面 关 于 自动 装配 的 介绍 ， 此 处 的 自动 装配 策略 与 
Spring 自身 所 提供 的 自动 装配 完全 相同 。 

如 果 使 用 按 name 来 完成 自动 装配 ， 则 无 须 设置 任何 的 Struts 2 常量 。 

在 这 种 整合 策略 下 ， 我 们 还 采用 传统 的 方式 来 配置 Struts 2 的 Action， 配 置 Action 时 一 样 指定 其 
具体 的 实现 类 ， 下 面 是 本 应 用 的 配置 文件 。 

因为 使 用 了 自动 装配 ，Spring 插件 创建 Action 实例 时 ， 是 根据 配置 Action 的 class 属性 指定 实现 
类 来 创建 Action 实例 的 。 故 需要 修改 struts.xml 文件 为 如 下 形式 。 

程序 清单 : codes\08\8.6\autowire\WEB-INF\src\struts.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Struts 2 配置 文件 的 DFTD 信息 --> 
<!DOCTYPE struts PUBLIC j 
"-//Apache Software Foundation//DTD Struts codtiguiation 2.1.7//EN™ 
"http://struts.apache:org/dtds/struts-2.1.7.dtd"> 
<!-- Struts 2 配置 文件 的 根 元 素 -> 
<struts> 
<!-- 配置 了 系列 常量 --> 
<constant name="struts.il8n.encoding" value="GBK"/> 
<constant name="struts.devMode” value="true"/> 
<package name="lee" extends="struts-default"> 
<!-~ 定义 处 理 用 户 请 求 的 Action --> 
<action name="loginPron 
class="org.crazyit.app.action.LoginAction"> 
<!-- 为 两 个 逻辑 视图 配置 视图 页 面 --> 
<result name="error">/WEB-INF/content /etror.jsp</result> 
<result name="success">/WEB-INF/content/welcome.jsp</result> 
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</action> 
SP 让 用 户 坪 接 沪 该 应 用时 列 出 所 有 福 间 责 克 id 
<action name="*". 
Seesult> /WED NE/content/ (1) jsp</result> 
</action> 
</package> 
</struts> 


正如 上 面 配 置 文件 中 看 到 的 ， 此 时 Struts 2 配置 文件 里 配置 的 依然 是 该 Action 的 实现 类 ， 该 配置 
文件 与 不 整合 Spring 时 的 配置 文件 没有 任何 区 别 。 


整合 Spring 框架 与 不 整合 时 当然 存在 区 别 ， 只 是 这 个 区 别 不 是 在 这 个 配置 文件 中 体 
现 ， 而 是 在 创建 该 Action 实例 时 体现 出 来 的 。 如 果 不 整合 Spring 框架 ， 则 Struts 2 框架 
i 负责 创建 Action 实例 ， 创 建成 功 后 就 结束 了 ; 如 果 整 合 Spring 框架 ， 则 当 Action 实例 创 要 


建 完成 之 后 ，Spring 插件 还 会 负责 将 该 Action 所 需 的 业务 逻辑 组 件 注入 给 该 Action 实例 


我 们 查看 刚才 的 Action 类 代码 ， 发 现 了 如 下 的 方法 定义 


// 系 统 所 用 的 业务 逻辑 组 件 ‘ 

private MyService ms; g 

// 设 置 注入 业务 逻辑 组 件 所 必需 的 Rn 方法 
(MyService ms) 


Public void setMs 
a 
} 
通过 上 面 的 setter 方法 , 可 以 看 出 该 Action 所 需 的 业务 逻辑 组 件 名 为 ms， 因 此 我 们 必须 在 配置 业 
务 逻辑 组 件 时 ， 指 定 其 id 属性 为 ms。 本 示例 应 用 的 applicationContext.xml 文件 代码 如 下 。 
程序 清单 : codes\08\8.6\autowire\WEB-INF\applicationContext.xml 


<?xml version="1.0" encoding="GBK"?> 

<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http: //www. springframework. org/schema/beans" 
xsi:schemaLocation="http://www. springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-~ 定义 一 个 业务 逻辑 组 件 ， 实 现 类 为 MyServiceImp -> 
<bean id="ma" 

class="org.crazyit.app. service. impl.MyServiceImp1"/> 


this.ms = ms; 


</beans> 
因为 在 配置 业务 逻辑 组 件 时 , 指定 了 该 业务 逻辑 组 件 的 id 为 ms, 则 Spring 插件 可 以 在 创建 Action 
实例 时 将 该 业务 逻辑 组 件 注入 给 Action 实例 。 
当 我 们 在 如 图 8.24 所 示 页 面 的 用 户 名 输入 框 中 输入 crazyit.org, 密码 输入 框 中 输入 leegang 后 , 单 
击 “ 登 录 ” 按 钮 ， 将 看 到 如 图 8.26 所 示 的 页 面 。 


您 已经 登录 ! 哈哈 ， 整 合成 芒 | 


图 8.26 整合 成 功 的 效果 页 面 


在 这 种 整合 策略 下 ，Spring 插件 负责 为 Action 自动 装配 业务 逻辑 组 件 ， 从 而 可 以 简化 配置 文件 的 


配置 。 这 种 方式 也 存在 如 下 两 个 缺点 。 
> ”Action 与 业务 逻辑 组 件 的 耦合 降低 了 代码 层次 , 必须 在 配置 文件 中 配置 Action 所 需 控制 器 同 
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名 的 业务 逻辑 组 件 。 这 不 利于 高 层次 解 辜 。 
> ”Action 接受 Spring 容器 的 自动 装配 ， 代 码 的 可 读 性 较 差 。 


8.7 Spring 整合 Hibernate 


时 至 今日 ， 可 能 极 少 有 Java EE 应 用 会 直接 以 JDBC 方式 进行 持久 层 访问 。 毕 竟 ， 用 面向 对 象 的 
程序 设计 语言 来 访问 关系 型 数据 库 ， 是 一 件 让 人 诅 丧 的 事情 。 大 部 分 时 候 ，Java EE 应 用 都 会 以 ORM 
框架 来 进行 持久 层 访 问 ， 在 所 有 的 ORM 框架 中 ，Hibernate 以 其 灵巧 、 轻 便 的 封装 赢得 了 众多 开发 者 
的 青睐。 

Spring 以 良好 的 开放 性 ， 能 与 大 部 分 ORM 框架 良好 整合 。 下 面 详细 介绍 Spring 与 Hibernate 的 
整合 。 


>>8.7.1 Spring 提供 的 DAO 支持 


DAO 模式 是 一 种 标准 的 Java EE 设计 模式 ，DAO 模式 的 核心 思想 是 : 所 有 的 数据 
过 DAO 组 件 完成 ，DAO 组 件 封装 了 数据 库 的 增 、 删 、 改 等 原子 操作 。 业 务 逻 辑 组 件 依赖 于 DAO 组 
件 提供 的 数据 库 原子 操作 ， 完 成 系统 业务 逻辑 的 实现 。 

对 于 Java EE 应 用 的 架构 ， 有 非常 多 的 选择 ， 但 不 管 细节 如 何 变换 ，Java EE 应 用 都 大 致 可 分 为 如 
下 三 层 : 

> ”表现 层 。 

> ”业务 逻辑 层 。 

> ”数据 持久 层 。 

轻 量 级 Java EE 架构 以 Spring IoC 容器 为 核心 ,承上启下 其 向 上 管理 来 自 表现 层 的 Action， 向 
下 管理 业务 逻辑 层 组 件 ， 同 时 负责 管理 业务 逻辑 层 所 需 的 DAO 对象 。 

图 8.27 描绘 了 轻 量 级 Java EE 架构 的 大 致 情形 。 

Web 服 务 器 / 应 用 服务 器 


间 ， 都 通 


es Data Transfer Object > 一 Domain Model Object 


图 8.27 轻 量 级 Java EE 应 用 架构 
DAO 组 件 是 整个 Java EE 应 用 的 持久 层 访问 的 重要 组 件 ， 每 个 Java EE 应 用 的 底层 实现 都 难以 离 
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开 DAO 组 件 的 支持 。Spring 对 实现 DAO 组 件 提供 了 许多 工具 类 ， 系 统 的 DAO 组 件 可 通过 继承 这 些 
工具 类 完成 ， 从 而 可 以 更 加 简便 地 实现 DAO 组 件 。 

Spring 提供 了 一 系列 的 抽象 类 ， 这 些 抽象 类 将 被 作为 应 用 中 DAO 实现 类 的 父 类。 通过 继承 这 些 
抽象 类 , Spring 简化 了 DAO 的 开发 步骤 , 能 以 一 致 的 方式 使 用 数据 库 访问 技术 。 不 管 底层 采用 JDBC、 
JDO 还 是 Hibemate， 应 用 中 都 可 采用 一 致 的 编程 模型 。 

DAO 组 件 继承 这 些 抽象 基 类 会 大 大 简化 应 用 的 开发 。 不 仅 如 此 ， 继 承 这 些 抽象 基 类 的 DAO 能 以 
一 致 方式 访问 数据 库 ， 意 味 着 应 用 程序 可 以 在 不 同 的 持久 层 访问 技术 中 切换 。 

除 此 之 外 ，Spring 提供 了 一 致 的 异常 抽象 ， 将 原 有 的 Checked 异常 转换 包装 成 Runtime 异常 ， 因 
而 , 编码 时 无 须 捕获 各 种 技术 中 特定 的 异常 。 Spring DAO 体系 中 的 异常 , 都 继承 DataAccessException， 
而 DataAccessExcetpion 异常 是 Runtime 的 , 无 须 显 式 捕捉 。 通过 DataAccessException 的 子 类 包装 原始 
异常 信息 ， 从 而 保证 应 用 程序 依然 可 以 捕捉 到 原始 异常 信息 。 

Spring 提供 多 种 数据 库 访 问 技术 的 DAO 支持 ,包括 Hibernate、JDO、TopLink、iBatis、OJB、JPA 
等 。 就 Hibernate 的 持久 层 访问 技术 而 言 ，Spring 提供 了 如 下 三 个 工具 类 (或 接口 ) 来 支持 DAO 组 件 
的 实现 : 

> HibernateDaoSupport 

> HibernateTemplate 

> HibernateCallback 


>>8.7.2 管理 Hibernate 的 SessionFactory 


前 面 介绍 Hibernate 时 已 经 知道 ， 当 通过 Hibernate 进行 持久 层 访问 时 ， 必 须 先 获得 SessionFactory 
对 象 ， 它 是 单个 数据 库 映 射 关系 编译 后 的 内 存 镜像 。 大 部 分 情况 下 ， 一 个 Java EE 应 用 对 应 一 个 数据 
库 ， 即 对 应 一 个 SessionFactory 对 象 。 

:纯粹 的 Hibernate 访问 中 ， 应 用 程序 需要 手动 创建 SessionFactory 实例 ， 可 想 而 知 ， 这 不 是 一 个 
优秀 的 策略 。 在 实际 开发 中 ， 我 们 希望 以 一 种 声明 式 的 方式 管理 SessionFactory 实例 ， 直 接 以 配置 文 
件 来 管理 SessionFactory 实例 。 

Spring 的 loC 容器 正好 提供 了 这 种 管理 方式 ， 它 不 仅 能 以 声明 式 的 方式 配置 SessionFactory 实例 ， 
也 可 充分 利用 IoC 容器 的 作用 ， 为 SessionFactory 注入 数据 源 引 用 。 

下 面 是 在 Spring 配置 文件 中 配置 Hibernate SessionFactory 的 示范 代码 。 

<?xml version="1.0" encoding="GBK"?> 

<!-- spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-~3.0.xsd 语义 约束 --> 

<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

xmlns="http: //www, springframework.org/schema/beans" 
i:schemaLocation="http://' ingframework.org/: 
Ft : /www drat rane 人 
<in® 定义 数据 源 Bean， 使 用 < 数据 源 实现 » 
<bean id="dataSsource" classrvcomvnchangs、 V2 .c3p0 .Combo; 
dest: thod="close"> 
上 指定 开 到 所 库 的 了 
的 mysql .jdbc. Drive 
a et A dbeimysql: //1 ee 
dbcgrlw =" oca 
te 
<property name="user" value="root"/> 
ps ni zd” value="32147 /> 
9 sword" value=": 中 
i ee Ee 
<property name="maxPoolsize" value="40"/> 


<!- 指定 连接 数据 库 连 接 池 的 最 小 连接 数 -> 
<property name="minPoolSize" value="1"/> 
<!- 指定 连接 数据 库 连接 池 的 初始 化 连接 数 一 > 
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<property name="initialPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连接 池 的 连接 的 最 大 空 采 时间 --> 
<property name="maxIdleTime" value="20"/> 
</bean> 
<!-- 定义 Hibernate 的 SessionFactory--> 
<bean id="sessionFactory" 
class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"> 
<property name="dataSource" ref="dataSource"/> 
<property name="mappingResources"> 
<list> 
<!-- 以 下 用 来 列 出 所 有 的 PO 映射 文件 -> 
<value>Person.hbm.xml</value> 
</list> 
</property> 
<property name="hibernateProperties"> 
<!-- 设置 Hibernate 属性 --> 
<value> 
hibernate.dialect=org.hibernate. dialect.MySQLInnoDBDialect 
hibernate .hbm2ddl .auto=update 
</value > 
</property> 
</bean> 
</beans> 


-日 在 Spring 的 IoC 容器 中 配置 了 SessionFactory Bean， 它 将 随 应 用 的 启动 而 加 载 ， 并 可 以 充分 
利用 IoC 容器 的 功能 ， 将 SessionFactory Bean 注入 任何 Bean， 比 如 DAO 组 件 。 一 旦 DAO 组 件 获得 
了 SessionFactory Bean 的 引用 ， 就 可 以 完成 实际 的 数据 库 访问 。 

当然 ，Spring 也 支持 访问 容器 数据 源 ， 如 果 需 要 使 用 容器 数据 源 ， 则 将 数据 源 Bean 修改 成 如 下 
配置 : 


<!-- 此 处 配置 JNDI 数据 源 -> 
<bean id="myDataSource”" cl 

<!-~ 指定 数据 源 的 JNDI --> 
name=" " 


value="java:comp/env/jdbc/myds"/> 


="org. springframework. jndi. JndiobjectFactoryBean"> 


</bean> 
从 上 面 配置 文件 可 以 看 出 ， 当 以 声明 式 的 方式 来 管理 SessionFactory 时 ， 可 以 让 应 用 在 不 同 数据 

源 之 间 切 换 。 如 果 应 用 需要 更 换 数 据 库 等 持久 层 资源 ， 只 需 对 配置 文件 进行 简单 修改 即 可 。 
声明 式 的 方式 管理 SessionFactory, 非常 类 似 于 早期 将 数据 库 服务 的 相关 信息 放 在 web.xml 文件 中 

进行 配置 。 这 种 方式 ， 是 为 了 提供 更 好 的 适应 性 : 当 持 久 层 服务 需要 更 改 时 ， 程 序 代码 无 须 任何 改变 。 


>>8.7.3 使 用 HibernateTemplate 


HibernateTemplate 提供 持久 层 访 问 模板 化 , 它 只 需要 提供 一 个 SessionFactory 的 引用 , 就 可 执行 持 
久 化 操作 。SessionFactory 对 象 既 可 通过 构造 参数 传 入 ， 也 可 通过 设 值 方式 传 入 。HibernateTemplate 提 
供 如 下 三 个 构造 函数 。 
> HibermateTemplate(): 构造 一 个 默认 的 HibernateTemplate 实例 ， 因 此 创建 了 
HibernateTemplate 实例 之 后 ， 还 必须 使 用 方法 setSessionFactory(SessionFactory sf) 为 
HibernateTemplate 注入 SessionFactory 对 象 ， 然 后 才 可 进行 持久 化 操作 。 
> HibernateTemplate(org.hibernate.SessionFactory sessionFactory): 在 构造 时 已 经 传 入 
SessionFactory 对 象 ， 创 建 后 立即 可 执行 持久 化 操作 。 
> HibernateTemplate(org.hibernate.SessionFactory sessionFactory, boolean allowCreate): 
allowCreate 参数 表明 ,如 果 当 前 线程 没有 找到 一 个 事务 性 的 Session,， 是 否 需 要 创建 一 个 非 
事务 性 的 Session。 
对 于 Web 应 用 , 通常 应 用 启动 时 会 自动 创建 ApplicationContext，SessionFactory 和 DAO 对 象 都 处 
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在 Spring 容器 的 管理 下 , 因此 无 须 在 代码 中 显 式 设置 , 可 采用 依赖 注入 实现 SessionFactory 和 DAO 的 
解 不 ， 依 赖 关 系 通过 配置 文件 来 设置 。 

下 面 的 示例 程序 基于 HibemateTemplate 实现 了 一 个 DAO 组 件 , Spring 将 为 该 DAO 组 件 注入 所 需 
的 SessionFactory。 该 DAO 组 件 的 实现 类 如 下 。 

程序 清单 :codes\08\8.7\HibernateTemplate\src\org\crazyit\app\dao\impl\PersonDaolImpl.java 

public class PersonDaoImpl 


号 


implements PersonDao 


// 定 义 一 个 HibernateTemplate 对 象 ， 用 于 执行 持久 化 操作 
private HibernateTemplate ht = null; 
//Hibernate 持久 化 操作 所 需 的 SessionFactory 
private SessionFactory sessionFactory; 
// 依 赖 注入 SessionFactory 的 setter 方法 
public void setsessionFactory (SessionFactory sessionFactory) 
{ 
this.sessionFactory ~ sessionFactory; 


} 
// 初 始 化 HibernateTemplate 的 方法 
private HibernateTemplate getHibernateTemplatet) 
{ 
if (ht == null) 
{ 


ht = new HibernateTemplate (sessionFactory); 
1 


return ht 
) 
/us 
* 加 载 Person 实例 


* @param id 需要 加 载 的 Person 实例 的 标识 属性 什 
* 8return 指定 id 对 应 的 Person 实例 
2 


Public person get(Integer id) 
return getHibernateTemplate() 
get(Person.class, id); 
} 
/uu 
* 保存 Person 实例 
* param person 需要 保存 的 Person 实例 
* ereturn 刚刚 保存 的 Person 实例 的 标识 属性 值 
“7 
Public Integer save(Person person) 


return (Integer)getHibernateTemplate() 
-save (person) ; 
* 修改 Person 实例 
* @param person 需要 修改 的 Person 实例 
“ 


Public void update (Person person) 
{ 


: gotHibernateTemplate () .update (person) ; 
/a 

* 删除 Person 实例 

A id 需要 删除 的 Person 实例 的 标识 属性 值 


Public void.delete{(Integer id) 
{ 
， getHibernateTemplate () .delete (get (id)); 
/es 
* 删除 Person 实例 
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* @param person 需要 删除 的 Person 实例 
*/ 


public void delete(Person person) 
{ 
getHibernateTemplate () .delete (Person) ; 
i 
/us 
* 根据 用 户 名 查找 Person 
+ eparam name 查询 的 人 名 
* @return 指定 用 户 名 对 应 的 全 部 Person 
wy/ 
public List<Person> findByName {String name) 
{ 
return (List<Person>)getHibernateTemplate() 
.find("from Person p where p.name = ?" , name); 
* 查询 全 部 Person 实例 
* Breturn 全 部 Person 实例 
A 
public List findAllPerson() 
{ 
return (List<Person>)getHibernateTemplate() 
.find("from Personn) 7 
) 


/查询 所 中 Person 实例 的 加 娄 
* @return 数据 表 中 Person 实例 的 总 数 
se long getPersonNumber () 
es (Long) getHibernateTenplate() .find 
("select count(*) from Person as p") 
.get(0); 

} 

上 面 的 程序 中 粗 体 字 代码 用 于 创建 一 个 HibemateTemplate 对 象 ， 创 建 该 对 象 时 传 入 了 一 个 
SessionFactory 对 象 。 一 旦 HibemateTemplate 对 象 初始 化 完成 (获得 了 SessionFactory 的 引用 )， 大 部 
分 持久 化 操作 都 可 通过 该 对 象 来 完成 。 

HibernateTemplate 提供 很 多 实用 方法 来 完成 基本 的 操作 ， 比 如 增加 、 删 除 、 修 改 、 查 询 等 操作 ， 
Spring 2.X 更 增加 了 对 命名 SQL 查询 的 支持 ， 也 增加 了 对 分 页 的 支持 。 

大 部 分 情况 下 ， 通 过 HibemateTemplate 如 下 方法 就 可 完成 大 多 数 DAO 对 象 的 CRUD 操作 。 下 面 
是 HibernateTemplate 的 常用 方法 简介 。 

> ”void delete(Object entity)， 删除 指定 持久 化 实例 。 
deleteAll(Collection entities): 删除 集合 内 全 部 持久 化 类 实例 。 
find(String queryString): 根据 HQL 查询 字符 串 来 返回 实例 集合 的 系列 重 载 方法 。 
findByNamedQuery(String queryName): 根据 命名 查询 返回 实例 集合 的 系列 重 载 方法 。 
get(Class entityClass, Serializable id): 根据 主键 加 载 特定 持久 化 类 的 实例 。 
save(Object entity): 保存 新 的 实例 。 
saveOrUpdate(Object entity): 根据 实例 状态 ， 选 择 保存 或 者 更 新 。 
update(Object entity): 更 新 实例 的 状态 ， 要 求 entity 是 持久 状态 。 
setMaxResults(int maxResults): 设置 分 页 的 大 小 。 

结合 上 面 的 方法 来 看 , 不 难 发 现 借助 于 HibernateTemplate 实现 持久 层 的 简洁 性 , 大 部 分 CRUD 操 
作 只 需 一 行 代码 即 可 ， 完 全 可 避免 Hibemate 持久 化 操作 那些 烦琐 的 步骤 。 

HibernateTemplate 是 Spring 众多 模板 工具 类 之 一 ，Spring 正 是 通过 这 种 简便 的 模板 工具 类 ， 为 我 
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们 完成 了 开发 中 大 量 需 要 重复 进行 的 工作 。 
正如 在 上 面 的 程序 中 所 看 到 的 ，PersonDaoImpl 创建 HibermateTemplate 时 需要 传 入 一 个 
SessionFactory 对 象 ， 此 时 利用 Spring 的 依赖 注入 即 可 。 在 Spring 容器 中 配置 PersonDaoImpl， 配 置 文 


件 如 下 。 
程序 清单 : codes\08\8.7\HibernateTemplatevsrc\bean xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- Spring 配置 文件 的 根 元 素 ， 使 用 spring-beans-3.0.xsd 语义 约束 --> 
<beans xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns="http://www. springframework.org/schema/beans" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"> 
<!-- 指定 连接 数据 库 的 驱动 --> 
<property name="driverClass" value="com.mysql.jdbc.Driver"/> 
<!-- 指定 连接 数据 库 的 URL -> 
<property name="jdbcUrl" value= 
<!-- 指定 连接 数据 库 的 用 户 名 --> 
<property name="user" value="root"/> 
<!-~ 指定 连接 数据 库 的 密码 --> 
<property name="password" value="32147"/> 
<!-- 指定 连接 数据 库 连 接 池 的 最 大 连接 数 
<property name="maxPoolSize" vali 
<!-- 指定 连接 数据 库 连接 池 的 最 小 连接 数 
<property name="minPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连接 池 的 初始 化 连接 数 --> 
<property name="initialPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连 接 池 的 连接 的 最 大 空闲 时 间 --> 
<property name="maxIdleTime" valuern20"/> 


jdbc:mysql://localhost /hibernate"/> 


</bean> 
<!-- 定义 Hibernate 的 SessionFactory --> 
<bean id="sessionFactory" 


class="org. springframework.orm.hibernate3.LocalsessionFactoryBean"> 
<!-- 依赖 注入 数据 源 ， 注 入 正 是 上 面 定义 的 datasource --> 
<property name="dataSource" ref="datasource"/> 
<!-- mappingResouces 属性 用 来 列 出 全 部 映射 文件 --> 
<property name="mappingResourcesw> 
<list> 
<!-~ 以 下 用 来 列 出 Ribernate 映射 文件 --> 
<value>org/crazyit/app/domain/Person.hbm.xml</value> 
</list> 
</property> 
<!-- 定义 Hibernate 的 SessionFactory 的 属性 二 > 
<property name="hibernateProperties"> 
<!-- 配置 Hibernate 属性 --> 
<value> 
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect 
hibernate.hbm2ddl .auto=update 
hibernate. show_sql=true 
hibernate. format_sql=true; 
</value> 
</property> 
</bean> 
<!-- 定义 DAO Bean--> 
<bean id="personDao" 
class="org.crazyit.app.dao. impl. PersonDaoImpl"> 
<!-- 注入 持久 化 操作 所 需 的 SessionFactory --> 
name="sessionFactory" ref="sessionFactory"/> 


</bean> 
</beans> 


如 配置 文件 中 的 粗 体 字 代 码 所 示 ， 一 旦 我 们 在 配置 文件 中 为 PersonDaolmpl 注入 了 SessionFactory 
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的 引用 ， 程 序 即 可 通过 该 DAO 组 件 进行 持久 化 操作 。 在 PersonDao 组 件 中 ， 所 有 的 持久 化 操作 都 通 
过 HibernateTemplate 实例 完成 ， 而 HiberanteTemplate 操作 数据 库 非常 简洁 ， 大 部 分 CRUD 操作 都 可 
通过 一 行 代码 解决 问题 。 


>>8.7.4 使 用 HibernateCallback 


不 得 不 承认 , 使 用 HibernateTemplate 进行 数据 库 访问 十 分 方便 , 但 这 种 方便 也 带 来 了 一 定 的 缺点 : 
灵活 性 不 足 一 一 如 果 我 们 希望 使 用 Hibernate API 进行 持久 化 访问 ， 借 助 于 Hibernate 上 面 的 方法 就 不 
行 了 。 

为 了 避免 HibernateTemplate 灵活 性 不 足 的 缺陷 ，HibemateTemplate 还 提供 一 种 更 加 灵活 的 方式 来 
操作 数据 库 ,通过 这 种 方式 可 以 完全 使 用 Hibernate 的 操作 方式 。HibernateTemplate 的 灵活 访问 方式 是 
通过 如 下 两 个 方法 完成 的 : 

> Objectexecute(HibernateCallback action) 

> List executeFind(HibernateCallback action) 

这 两 个 方法 都 需要 一 个 HibernateCallback 实例 ，HibernateCallback 实例 可 在 任何 有 效 的 Hibernate 
数据 访问 中 使 用 。 程 序 开发 者 通过 HibernateCallback， 可 以 完全 使 用 Hibernate 灵活 的 方式 来 访问 数据 
库 ， 解 决 Spring 封装 Hibernate 后 灵活 性 不 足 的 缺陷 。 

HibemateCallback 是 个 接口 ， 该 接口 包含 一 个 方法 doInHibernate(org.hibernate.Session session)， 该 
方法 只 有 一 个 参数 Session。 当 我 们 在 开发 中 提供 HibernateCallback 实现 类 时 ， 必 须 实现 接口 里 的 
doInHibernate 方法 ， 该 方法 体内 即 可 获得 Hibernate Session 的 引用 ， 一 旦 获得 了 Hibernate Session 的 
引用 ， 我 们 可 以 完全 以 Hibernate 的 方式 进行 数据 库 访问 。 


在 dolnHibemate 方法 内 可 以 访问 Session， 该 Session 对 象 是 绑 定 到 该 线程 的 Session 
影 ”实例 .该 方法 内 的 持久 层 操作 ， 与 不 使 用 Spring 的 持久 层 操作 完全 相同 。 这 保证 了 对 于 复 ， 
上。 杂 的 持久 层 访问 ， 依 然 可 以 直接 使 用 Hibernate 的 访问 方式 。 j 
下 面 的 代码 对 HibernateDaoSupport 类 进行 扩展 (虽然 Spring 2.X 的 HibernateTemplate 提供 了 一 个 
分 页 方法 setMaxResults0,， 但 仅 此 一 个 方法 依然 不 可 以 实现 查询 分 页 )， 这 种 扩展 主要 是 为 该 类 增加 了 
三 个 分 页 查询 的 方法 ， 执 行 分 页 查询 时 必须 直接 调用 Hibernate 的 Session 完成 ， 因 此 必须 借助 于 
HibernateCallback 的 帮助 。 下 面 是 笔者 扩展 的 一 个 HibernateDaoSupport。 
程序 清单 :codes\08\8.7\YeekuHibemateDaoSupport\YeekuHibernateDaoSupportjava 
public class YeekuHibernateDaosupport “ 
和 extends HibernateDaoSupport 
4 使 用 hql 语句 进行 分 页 查询 
* @param hql 需要 查询 的 hql 语句 
* 8@param offset 第 一 条 记录 索引 


* @param pageSize 每 页 需要 显示 的 记录 数 
* @return 当前 页 的 所 有 记录 
*/ 


public List findByPage(final String hql, 
final int offset, final int pageSize) 


// 通 过 一 个 HibernateCallback 对 象 来 执行 查询 
List list = getHibernateTemplate() 
.executeFind (new HibernateCallback() 


{ 


{ 
// 实 现 HibernateCallback 接口 必须 实现 的 方法 
Public Object doInHibernate (Session session) 
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throws HibernateException, SQLException 


// 执 行 Bibernate 分 页 查询 

List result = session.createQuery (hgl) 
.setFirstResult (offset) 

etMaxResults (PageSize) 


} 
Ds 
return list; 
} 
As 
* 使 用 hql 语句 进行 分 页 查询 
* @param hql 需要 查询 的 hql 语句 
@param value 如 果 hql 有 一 个 参数 需要 传 入 ，value 就 是 传 入 hql 语句 的 参数 
eparam offset 第 一 条 记录 索引 
eparam pageSize 每 页 需要 显示 的 记录 数 
ereturn 当前 页 的 所 有 记录 
*/ 
public List findByPage(final String hql , final Object value , 
final int offset, final int pageSize) 
{ 
// 通 过 一 个 HibernateCallback 对 象 来 执行 查询 
List list = getHibernateTemplate() 
.executeFind (new HibernateCallback() 
{ 
// 实 现 Hibernatecallback 接口 必须 实现 的 方法 
public Object doInHibernate (Session session) 
throws HibernateException, SQLException 


/1/ 执 行 Hibernate 分 页 查询 
List result = session.createQuery (hql) 


{ 


.setFirstResult (offset) 
.setMaxResults (pageSize) 
list(); 
return result; 
} 
Ds 
return list; 
ys 
* 使 用 hql 语句 进行 分 页 查询 
* @param hql 需要 查询 的 hgl 语句 
* eparam values 如 果 hql 有 多 个 个 参数 需要 传 入 ，values 就 是 传 入 hal 的 参数 数组 
* @param offset 第 一 条 记录 索引 
* eparam pageSize 每 页 需要 显示 的 记录 数 
* @return 当前 页 的 所 有 记录 
全 人 
public List findBypage(final string hql, final Object[] values, 
final int ‘offset, final int pageSize) 


// 通 过 一 个 HibernateCallback 对 象 来 执行 查询 
List list = getHibernateTemplate() 
.executeFind(new HibernateCallback() 


// 实 现 HibernateCallback 接 口 必须 实现 的 方法 
public Object doInHibernate (Session session) 
throws HibernateException, SQLException 


// 执 行 Hibernate 分 页 查询 . 

Query query = session.createQuery (hql); 
// 为 hql 语句 传 入 参数 

for (int i1 = 0 ; i < values.length ; i++) 
{ 


4 


{ 
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query. setParameter( i, values[i]); 
List result = query.setFirstResult (offset) 
.setMaxResults (pageSize) 
-list(); 
return result; 
} 
Ds; 
return list; 
时 
} 


上 面 的 程序 中 三 段 代码 就 是 实现 分 页 查询 的 关键 ， 当 实现 doInHibernate(Session session) 方 法 时 ， 
完全 以 Hibenate 的 方式 进行 数据 库 访问 ， 这 样 保证 了 Hibemate 进行 数据 库 访 问 的 灵活 性 。 

当 使 用 HibernateCallback 对 象 来 执行 持久 化 操作 时 ， 程 序 获得 了 对 Hibernate 访问 的 最 大 控制 权 ， 
而 Spring 只 是 需要 得 到 一 个 查询 结果 (相当 于 一 个 命令 )， 而 具体 的 命令 实现 则 由 HibernateCallback 


实现 ， 这 就 是 典型 的 命令 者 模式 。 
本 


| Spring 提供 的 XxxTemplate 和 XxxCallBack 互 为 补充 ， 二 者 体现 了 Spring 框架 设计 
i 的 用 心 良 苦 : XxxTemplate 对 通用 操作 进行 封装 ， 而 XxxCallBack 解决 了 封装 后 灵活 性 
| 不足 的 纳 陶 。 污 


为 了 实现 DAO 组 件 ，Spring 提供 了 大 量 的 XxxDaoSupport 类 ， 这 些 DAO 支持 类 对 于 实现 DAO 
组 件 大 有 帮助 ， 因 为 这 些 DAO 支持 类 已 经 完成 了 大 量 基础 性 工作 。 

Spring 为 Hibernate 的 DAO 提供 工具 类 :HibernateDaoSupport。 该 类 主要 提供 如 下 两 个 方法 来 简 
化 DAO 的 实现 : 

> public final HibernateTemplate getHibernateTemplate() 

> public final void setSessionFactory(SessionFactory sessionFactory) 

其 中 ，setSessionFactory() 方 法 可 用 于 接收 Spring 的 依赖 注入 ， 人 允许 使 用 依赖 注入 Spring 管理 的 
SessionFactory 实例 ，getHibernateTemplate() 则 用 于 返回 一 个 HibemateTemplate 对 象 。 一 旦 获得 了 
HibernateTemplate 对 象 ， 剩 下 的 DAO 实现 将 由 该 HibernateTemplate 来 完成 。 

下 面 的 DAO 组 件 继承 了 Spring 提供 的 HibernateDaoSupport 类 ， 依 然 实 现 了 PersonDao 接口 ， 其 
功能 与 前 面 提供 的 PersonDao 实现 类 完全 相同 。 

程序 清单 : codes\08\8.7\HibernateDaoSupport\src\org\crazyit\app\dao\impl\PersonDaoHibernate.java 

Public class PersonDaoHibernate 
extends RibernateDaoSupport implements PersonDao 
{ 
au 
* 加 载 Person 实例 
* @param id 需要 加 载 的 Person 实例 的 标识 属性 值 
* @return 指定 id 对 应 的 Person 实例 
尖 玻 Person get(Integer id) 
return getHibernateTemplate() 
-get (Person.class, id); 
} 
/is 
* 保存 Person 实例 
* Eparam person 需要 保存 的 Person 实例 
* ereturn 刚刚 保存 的 Person 实例 的 标识 属性 值 
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fh 
public Integer save(Person person)} 
{ 
return (Integer)getHibernateTemplate() 
save (person); 


} 
/us 
* 修改 Person 实例 
* Bparam person 需要 修改 的 Person 实例 
i 
public void update (Person person) 
{ 
getHibernateTemplate() .update (person}; 
} 
/a 
* 删除 Person 实例 
* @param id 需要 删除 的 Person 实例 的 标识 属性 什 
A 


public void delete(Integer id) 
{ 
getHibernateTemplate() .delete (get (id)); 


/es 

* 删除 Person 实例 

* 8param person 需要 删除 的 Person 实例 
et 


public void delete(Person person) 
{ 
getHibernateTemplate() .delete (person); 


} 
/us 
* 根据 用 户 名 查找 Person 


* @param name 查询 的 人 名 
* @return 指定 用 户 名 对 应 的 全 部 Person 
we 


public List<Person> findByName (String name) 
{ 
return (List<Person>)getHibernateTemplate() 
,find("from Person P where p.name = ?" , name); 
} 
/us 
* 查询 全 部 Person 实例 
* @return 全 部 Person 实例 
二 
public List findAllPerson() 
{ 
return (List<Person>)getHibernateTemplate() 
.find("from Person"); 
) 


Ju 
* 查询 数据 表 中 Person 实例 的 总 数 
* Breturn 数据 表 中 Person 实例 的 总 数 


bi long getPersonNumber () 
return (Long)getHibernateTemplate().find 
{"select count (*) from Person as p") 
"get (0); 
} 
} 
将 上 面 的 代码 与 前 面 的 PersonDAOImpl 对 比 ， 会 发 现代 码 量 大 大 减少 。 事 实 上 ，DAO 的 实现 依 
然 借 助 于 HibernateTemplate 的 模板 访问 方式 , 只 是 HibernateDaoSupport 提供 了 两 个 工具 方法 ,所 以 本 
DAO 组 件 的 代码 更 加 简洁 了 。 
在 继承 HibmateDaoSupport 的 DAO 实现 里 , 程序 无 须 理会 Hibernate 的 Session 管理 , Spring 会 根 


据 实际 的 操作 ， 采 用 “每 次 事务 打开 一 次 session” 的 策略 ， 自 动 提高 数据 库 访问 的 性 能 。 
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>>8.7.6 使 用 IoC 容器 组 装 各 种 组 件 


至 此 , Java EE 应 用 所 需要 的 各 种 组 件 都 已 经 出 现 了 , 从 MVC 层 的 控制 器 组 件 , 到 业务 逻辑 组 件 ， 
以 及 持久 层 的 DAO 组 件 ， 已 经 全 部 成 功 实现 。 但 这 种 组 件 并 未 直接 耦合 ， 组 件 与 组 件 之 间 面 向 接口 
编程 ， 所 以 还 需要 利用 Spring 的 IoC 容器 将 它们 组 合 在 一 起 。 

从 用 户 角 度 来 看 ， 用 户 发 出 HTTP 请 求 ， 当 MVC 框架 的 控制 器 组 件 拦截 到 用 户 请 求 时 ， 将 调用 
系统 的 业务 逻辑 组 件 ， 业 务 远 辑 组件 则 调用 系统 的 DAO 组 件 ， 而 DAO 组 件 则 依赖 于 SessionFactory 
和 DataSource 等 底层 组 件 实现 数据 库 访问 。 

从 系统 实现 角度 看 ，IoC 容器 先 创建 SessionFactory 和 DataSource 等 底层 组 件 ， 然 后 将 这 些 底层 
组 件 注入 给 DAO 组 件 ， 提 供 一 个 完整 的 DAO 组 件 ， 并 将 此 DAO 组 件 注入 给 业务 逻辑 组 件 ， 从 而 提 
供 一 个 完整 的 业务 逻辑 组 件 , 而 业务 逻辑 组 件 又 被 注入 给 控制 器 组 件 , 控制 器 组 件 负责 拦截 用 户 请 求 ， 
并 将 处 理 结果 呈现 给 用 户 一 一 这 一 系列 的 衔接 ， 都 由 Spring 的 IoC 容器 提供 实现 。 

下 面 的 应 用 示范 了 一 个 简单 的 注册 Action， 该 Action 用 于 处 理 注册 用 户 的 请 求 。 
程序 清单 :codes\08\8.7\regist\WEB-INF\src\org\crazyit\app\action\RegistAction.java 
public class RegistAction 
implements Action 


// 下 面 是 用 于 封装 用 户 请 求 参数 的 属性 

private Person person; 

// 用 于 封装 处 理 结果 的 属性 

private String tip; 

// 系 统 所 用 的 业务 逻辑 组 件 

Private LeeService leeService; 

// 设 置 注入 业务 逻辑 组 件 所 必需 的 setter 方法 

Public void setLeeService (LeeService leeService) 
{ 


{ 


this.leeService = leeService; 
} 
// 省 略 其 他 属性 的 setter 和 getter 方法 
7/7 处 理 用 户 请 求 的 execute 方法 


public String execute() 
throws Exception 


// 调 用 业务 逻辑 组 件 的 regist 方法 来 处 理 请 求 
if (leeService. regist (person)) 


{ 
setTip ("哈哈 ， 注 册 成 功 !"); 
return SUCCESS; 


{ 


return ERROR; 


} 
} 


从 RegistAction 的 粗 体 字 代码 可 以 看 出 ，RegistAction 依赖 于 LeeService 组 件 , 它 将 调用 该 业务 多 
辑 组 件 的 regist0 方 法 来 处 理 用 户 请 求 一 一 但 RegistAction 并 未 与 LeeService 组 件 直接 耦合 ， 它 只 依赖 
于 LeeService 组 件 的 接口 。 下 面 是 LeeService 接口 代码 。 
程序 清单 :codes\08\8.7\regist\WEB-INF\src\org\crazyit\app\service\LeeService.java 
public interface LeeService 
/7 注册 用 户 


boolean regist (Person person); 


} 
为 上 面 的 LeeService 提供 实现 类 ， 该 实现 类 将 会 依赖 于 DAO 组 件 来 实现 regist0 方 法 。 下 面 是 该 
705 


http://52pdf.taobao.com 


粒 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


实现 类 的 代码 。 
程序 清单 :codes\08\8.7\regist\WEB-INF\src\org\crazyit\service\app\impl\LeeServicelmpljava 


public class LeeServiceImpl 
implements LeeService 
{ 
Private PersonDao personDao; 
/7 依赖 注入 DAO 组 件 所 项 的 setter 方法 
public void setPersonDao (PersonDao personDao) 
{ 
this.personDao = personDao; 


上 
// 注 册 用 户 
public boolean regist (Person person) 


{ 
// 调 用 DAO 组 件 的 方法 来 实现 业务 逻辑 
int result = personDao. save{person); 
if (result > 0) 
{ 

return truer 

} 
return false; 

} 

} 


从 LeeServiceImpljava 类 的 粗 体 字 代码 可 以 看 出 ， 该 业务 逻辑 组 件 依赖 于 PersonDao 组 件 ， 但 它 
同样 没有 直接 与 PersonDao 实现 类 耦合 ， 仅 与 PersonDao 接口 耦合 ， 所 以 也 需要 Spring IoC 容器 来 管 
理 它们 的 依赖 关系 。 本 示例 程序 直接 使 用 了 前 面 的 DAO 组 件 、 实 体 类 ， 故 此 处 不 再 熬 述 。 

在 Spring 配置 文件 中 使 用 如 下 配置 片段 来 管理 Action、 业 务 逻辑 组 件 、DAO 组 件 之 间 的 依赖 

程序 清单 :codes\08\8.7\regist\WEB-INF\applicationContext.xml 


<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 -> 

<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close' 
<!-- 指定 连接 数据 库 的 驱动 


operty name="user" value="root"/> 
-~ 指定 连接 数据 库 的 密码 -> 

<property name="password" value="32147"/> 

<!-- 指定 连接 数据 库 连接 池 的 最 大 连接 数 ~-> 

<property name="maxPoolSize" value="40"/> 

<!--~ 指定 连接 数据 库 连接 池 的 最 小 连接 数 -> 

<property name="minPoolSize" valu 1"/> 

<!-- 指定 连接 数据 库 连接 池 的 初始 化 连接 数 一 -> 

<property name="initialPoolSize" value="1"/> 

<!-- 指定 连接 数据 库 连接 池 的 连接 的 最 大 空闲 时 间 -> 

<property name="maxIdleTime" value="20"/> 
</bean> 
<!-- 定义 Hibernate 的 SessionFactory --> 
<bean id="sessionFactory" 
org.springframework.orm.hibernate3.LocalSessionFactoryBean"> 
束 注 入 数据 源 ， 注 入 正 是 上 面 定义 的 dataSource 一 -> 
<property name="dataSource" ref="dataSource"/> 
<!-- mappingResouces 属性 用 来 列 出 全 部 映射 文件 -> 
<property name="mappingResources"> 

<list> 

<!-- 以 下 用 来 列 出 Hibernate 映射 文件 --> 
<value>org/crazyit/app/domain/Person.hbm.xml</value> 

</Iist> 
</property> 
<!-- 定义 Hibernate 的 SessionFactory 的 属性 --> 
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<property name="hibernateProperties"> 
<!-- 配置 Hibernate 属性 --> 
<value> 
hibernate.dialect=org.hibernate.dialect .MySQLInnoDBDialect 
hibernate.hbm2ddl .auto=update 
hibernate. show_sql=true 
hibernate format_sql=true; 
</value> 
</property> 
</bean> 
<!-- 定义 DAO Bean--> 
<bean id="personDao" class= 
"org.crazyit.app.dao .impl.PersonDaoHibernate"> 
<!-- 注入 持久 化 操作 所 需 的 SessionFactory --> 
<property name="sessionFactory" ref="sessionFactory"/> 
</bean> 
<!-- 配置 一 个 业务 逻辑 组 件 -一 > 
<bean id="leeService" class= 
"org.crazyit.app. service. impl .LeeServiceImpl"> 
Cie 福 入 特 久 化 访问 所 宙 的 DAO 组 件 --> 
name="personDao" ref="personDao"/> 
</bean> 

上 面 的 配置 文件 的 粗 体 字 代码 配置 了 业务 逻辑 组 件 、DAO 组 件 ， 并 通过 依赖 注入 为 DAO 组 件 注 
入 SessionFactory， 为 业务 逻辑 组 件 注入 了 DAO 组 件 一 一 这 就 完成 了 Java EE 应 用 中 各 组 件 的 组 装 。 

本 示例 程序 并 未 让 Spring 管理 Struts 2 的 Action， 而 是 利用 Spring 插件 的 自动 装配 机 制 将 业务 逻 
辑 组 件 注入 Action 实例 中 。 前面 定义 RegistAction 时 指定 所 需 的 业务 逻辑 组 件 名 为 leeService, 故 上 面 
配置 文件 中 将 业务 逻辑 组 件 的 id 指 为 leeService。 

在 struts.xml 文件 中 配置 RegistAction， 该 Action 即 可 调用 所 需 leeService 组 件 的 regist() 方 法 ， 从 
而 让 业务 逻辑 组 件 来 处 理 用 户 请 求 。 

至 此 ， 当 用 户 发 送 一 个 注册 请 求 之 后 ， 该 请 求 将 被 Struts 2 核心 控制 器 拦截 一 核心 控制 器 调用 
Action 一 Action 调用 业务 逻辑 组 件 一 业务 逻辑 组 件 调用 DAO 组 件 一 DAO 组 件 调用 SessionFactory、 
Hibernate 服务 等 ， 当 整个 过 程 完成 后 ， 核 心 控制 器 就 得 到 了 请 求 被 处 理 的 结果 ， 从 而 根据 该 结果 选择 
合适 的 视图 资源 来 生成 响应 一 一 这 就 完成 了 一 个 请 求 /响应 的 全 过 程 。 

提示 :… 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 … 一 
Fo “在 实际 应 用 中 ， 很 少 会 将 DAO 组 件 、 业 务 逻 辑 组 件 以 及 控制 组 件 都 配置 在 同一 个 文 ， 
2。 件 中 。 而 是 将 不 同 的 Java EE 组 件 配置 在 不 同 的 配置 文件 中 ， 比 如 actionContextxml 专门 

| ”用 于 配置 Action，daoContextxml 专门 用 于 配置 DAO 组 件 . ] 


六 和 8.7.7 使 用 声明 式 事务 


在 上 面 的 配置 文件 中 ， 部署 了 控制 器 组 件 、 业 务 逻辑 组 件 、DAO 组 件 ， 几 乎 可 以 形成 一 个 完整 的 
Java EE 应 用 。 但 有 一 个 小 小 的 问题 : 事务 控制 。 系统 没 有 任何 事务 逻辑 ,没有 事务 逻辑 的 应 用 是 不 可 
想象 的 。 

Spring 的 事务 机 制 非常 优秀 ， 它 允许 我 们 在 开发 过 程 中 无 须 理会 任何 事务 逻辑 ， 等 到 应 用 开发 完 
成 后 使 用 声明 式 事务 来 进行 统一 的 事务 管理 。 只 需要 在 配置 文件 中 增加 事务 控制 片段 ， 业 务 逻 辑 组 件 
的 方法 将 会 具有 事务 性 ; 而 且 Spring 的 声明 式 事务 支持 在 不 同事 务 策略 之 间 自 由 切换 。 

配置 Spring 声明 式 事务 时 , 通常 推荐 使 用 BeanNameAutoProxyCreator 自动 创建 事务 代理 。 通过 这 
种 自动 事务 代理 的 配置 策略 ， 增 加 业务 逻辑 组 件 ， 只 需要 在 BeanNameAutoProxyCreator Bean 配置 中 
增加 一 行 即 可 ， 从 而 避免 了 增 量 式 配 置 。 

正如 前 面 所 介绍 的 ， 为 业务 逻辑 组 件 添加 事务 只 需 如 下 几 个 步骤 即 可 。 
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人 针对 不 同 的 事务 策略 配置 对 应 的 事务 管理 器 。 

G 使 用 <bcadvice... 人 > 元 素 配 置 事务 增强 处 理 Bean， 配 置 事务 增强 处 理 Bean 时 使 用 多 个 
<method... 人 > 子 元 素 为 不 同方 法 指定 相应 的 事务 语义 。 

@ 在 <aop:config... 人 > 元 素 中 使 用 <aop:advisor.. 广 元 素 配置 自动 事务 代理 。 

下 面 只 需 在 Spring 配置 文件 中 增加 如 下 配置 片段 ， 业 务 逻 辑 组 件 的 方法 将 会 具有 事务 性 。 

程序 清单 :codes\08\8.7\regist\WEB-INF\applicationContext.xml 


<!-- 配置 Hibernate 的 局 部 事务 管理 器 ， 使 用 HibernateTransactionManager 类 一 > 
<!-- 该 类 实现 PlatformTransactionManager 接口， 是 针对 Hibernate 的 特定 实现 --> 
<bean id="transactionManager" 
class="org. springframework.orm.hibernate3.HibernateTransactionManager"> 
<!-- 配置 HibernateTransactionManager 时 需要 依 注入 SessionFactory 的 引用 --> 
<property name="sessionFactory" ref="sessionFactory"/> 
</bean> 
<!-- 配置 事务 增强 处 理 Bean, 指定 事务 管理 器 一 > 
<tx:advice id="txAdvice" transaction-manager="transactionManager"> 
<!-- 用 于 配置 详细 的 事务 语义 --> 
<tx:attributes> 
<!-- 所 有 以 " get ' 开 头 的 方法 是 id-only 的 --> 
<tx:method name="get*" read-only="true"/> 
<!-- 其 他 方法 使 用 默认 的 事务 设置 --> 
<tx:method name="*"/> 
</tx:attributes> 
</tx:advice> 
<aop:config> 
<!-- 配置 一 个 切入 点 一 > 
<aop:pointcut id="leePointcut" 
sion="bean (leeService) "/> 
<!-- 指定 在 leePointcut 切入 点 应 用 txAdvice 事务 增强 处 理 --> 
<aop:advisor advice-ref="txAdvice" 
pointcut-ref="leePointcut"/> 
</aop:config> 


上 面 的 配置 片段 的 粗 体 字 代 码 指定 切面 表达 式 为 bean(leeService), 该 表达 式 告诉 AOP 为 leeService 
Bean ER 法 织 入 事务 控制 的 增强 处 理 , 从 而 让 应 用 中 的 LeeServicelmpl 组 件 的 方法 具有 了 事务 性 。 


注意 专 ~ 
尽量 使 用 声明 式 事务 配置 方式 ， 而 不 要 在 代码 中 完成 事务 还 辑 。 ey 


8.8 Spring 整合 JPA 


前 面 已 经 提 到 ， 虽 然 Hibemate 十 分 优秀 ， 而 且 在 实际 开发 中 拥有 广泛 的 占有 率 ， 但 JPA 却 是 更 
高 层次 的 规范 ， 它 的 本 质 是 一 种 ORM 规范 ， 底 层 可 以 采用 任何 遵循 这 种 规范 的 ORM 框架 作为 实现 ， 
比如 Hibernate、TopLink 等 ， 因 此 JPA 的 发 展 势头 十 分 良好 。 

就 我 们 实际 开发 来 说 ， 同 样 推荐 大 家 采用 面向 JPA 的 API 编程 一 一 至 于 实体 ，JPA 实体 本 身 就 可 
以 在 Hibernate API 下 运行 良好 ， 没 有 丝毫 问题 。 如 果 应 用 不 是 面向 Hibernate API 编程 ， 而 是 面向 JPA 
的 API 编程 ， 那 么 该 应 用 底层 就 可 以 在 各 种 ORM 框架 (包括 Hibemate) 之 间 自 由 切换 ， 因 此 具有 更 
好 的 可 扩展 性 。 

Spring 为 这 种 改变 做 好 了 准备 ， 就 像 整 合 Hibernate 一 样 ，Spring 为 整合 JPA 同样 提供 了 极 大 
的 方便 。 


“由 于 本 章 只 是 介绍 Spring 与 JPA 的 整合 ， 因 此 关于 JPA 的 入 门 及 用 法 ， 本 章 并 未 涉及 .。 
果 读者 需要 获取 更 多 关于 JPA 的 知识 ,可 以 参考 本 书 寻 妹 简 ( 经 典 Java EE 企业 应 用 实战 | 
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Si 


> >8.8.1 管理 EntityManager 


当 Spring 整合 Hibernate 时 , Spring 可 以 通过 容器 来 管理 Hibernate 的 SessionFactory; 类 似 地 , Spring 
整合 JPA 时 ,Spring 可 通过 容器 管理 JPA 的 EntityManagerFactory 一 旦 我 们 将 JPA EntityManagerFactory 
部 署 在 Spring 容器 中 ， 这 样 至 少 可 以 提供 两 个 好 处 : 

> ”以 声明 式 方式 管理 EntityManagerFactory， 避 免 在 程序 中 手动 创建 EntityManagerFactory。 

> ”可 以 方便 地 将 EntitiyManagerFactory 注入 其 他 组 件 (如 DAO 组 件 ) 中 。 

Spring 管理 JPA EntityManagerFactory 通常 有 两 种 方式 : 

> LocalEntityManagerFactoryBean 

> LocalContainerEntityManagerFactoryBean 

1. 使 用 LocalEntityManagerFactoryBean 

LocalEntityManagerFactoryBean 可 用 于 创建 一 个 EntityManagerFactory ， 但 它 所 创建 的 
EntityManagerFactory 在 很 多 情况 下 都 是 受 限 的 。 它 不 能 使 用 Spring 容器 中 已 有 的 DataSource, 也 不 能 
切换 到 全 局 事务 。 

- 般 来 说 ， 当 应 用 只 需要 使 用 JPA 进行 简单 的 数据 访问 、 或 者 只 是 进行 简单 的 测试 时 ， 才 会 考虑 
使 用 LocalEntityManagerFactoryBean 来 配置 EntityManagerFactory 。 

当 使 用 LocalEntityManagerFactoryBean 配置 EntityManager 时 ， 只 需要 传 入 持久 化 单元 
《PersistenceUnit) 的 名 称 即 可 。 看 如 下 配置 。 

程序 清单 : codes\08\8.8\LocalEntityManagerFactoryBean\src\bean.xml 


<beans> 


<bean id-"emf" class="org.springframework.orm.jpa.LocalEntityManagerFactoryBean"> 
<!-- 注入 JPA 持久 化 单元 --> 
name="persistenceUnitNane" value="person_pu"/> 
</bean> 


</beans> 
上 面 的 配置 文件 中 粗 体 字 代码 指定 持久 化 单元 的 名 称 为 person_pu， 这 意味 着 应 该 在 
persistence.xml 文件 中 配置 一 个 名 为 person_pu 的 持久 化 单元 。 而 且 该 持久 化 单元 需要 自己 管理 数据 库 
连接 等 信息 。 下 面 是 LocalEntityManagerFactoryBean 策略 的 persistence.xml 文件 代码 。 
程序 清单 :codes\08\8.8\LocalEntityManagerFactoryBean\src\META-INF\persitence.xml 


<?xml version="1.0" encoding="GBK"?> 
<persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence" 
xmlns:xsi="http://wuw.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java. sun.com/xml/ns/persistence 
//java. sun.com/xml/ns/persistence/persistence_1_0.xsd"> 
为 持久 化 单元 指定 名 称 ， 并 通过 transaction-type 指定 事务 类 型 
transaction-type 属性 合法 的 属性 值 有 JTA、RESOURCE_LOCAL 两 个 --> 
<persistence-unit name="person_pu" transaction-type="RESOURCE_LOCAL"> 
<!-- 指定 javax.persistence.spi.PersistenceProvider 实现 类 --> 
<provider>org.hibernate.ejb.HibernatePersistence</provider> 
<!-- 列 出 该 应 用 需要 访问 的 所 有 的 Entity 类 ,， 
也 可 以 用 <mapping-file> 或 <jar-file> 元 素来 定义 --> 
<class>org.crazyit.app. domain. Person</class> 
<!-~ properties 元 素 用 于 为 特定 JPA 实现 包 配 置 属性 --> 
<!-- 下 面 列举 的 是 Hibernate JPA 实现 中 可 以 配置 的 部 分 属性 
<properties> 
<!-- 指定 连接 数据 库 的 驱动 名 --> 
<property name="hibernate.connection.driver_class" 
value="com.mysql.jdbc.Driver"/> 
<!-- 指定 连接 数据 库 的 URL -> 
<property name="hibernate.connection.url™ 


-> 
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value="jdbc:mysql://localhost:3306/javaee"/> 

<! 一 指定 连接 数据 库 的 用 户 名 --> 

<property name="hibernate.connection.username" 
value="root"/> 

<!- 指定 连接 数据 库 的 密码 --> 

<property name="hibernate.connection.password" 
value="32147"/> 

<!~- 指定 连接 数据 库 的 方言 一 > 

<property name="hibernate.dialect" 
value="org.hibernate. dialect .MySQLInnoDBDialect"/> 

<property name="hibernate. show_sql" value="true"/> 

<!-- 设置 是 否 格式 化 SQL 语句 --> 

<property name="hibernate. format_sql" 
value="true"/> 

<!-- 设置 是 否 根据 要 求 自动 建 表 --> 

<property name="hibernate.hbm2ddl .auto" 
value="update"/> 

</properties> 
</persistence-unit> 
</persistence> 


上 面 的 配置 文件 配置 一 个 持久 化 单元 ， 并 指定 了 它 的 名 称 为 person pu，Spring 的 
LocalEntityManagerFactoryBean 就 可 根据 该 名 称 来 创建 EntityManagerFactory 。 


2. 使 用 LocalContainerEntityManagerFactoryBean 


使 用 LocalContainerEntityManagerFactoryBean 可 以 提供 对 EntityManagerFactory 全 面 的 控制 ， 非 
常 适合 需要 细 粒 度 定制 的 环境 , LocalContainerEntityManagerFactoryBean 将 根据 persistence.xml 文件 创 
建 PersistenceUnitinfo， 并 提供 DataSourceLookup 策略 ， 因 此 它 完全 可 以 直接 使 用 Spring 容器 中 己 有 
的 数据 源 ， 并 自己 控制 织 入 流程 。 
使 用 LocalContainerEntityManagerFactoryBean 创建 EntityManagerFactory 是 一 种 强大 的 配置 方式 ， 
它 允 许 在 应 用 程序 中 灵活 地 进行 配置 ， 也 支持 使 用 容器 中 已 有 的 DataSource。 
例如 如 下 配置 。 
程序 清单 ，codes\08\8.8JpaTemplate\src\bean.xml 
<bean id="emf" 
class="org. springframework.orm.jpa.LocalContainerEntityManagerFactoryBean”"> 
使 用 已 有 的 数据 源 --> 
name="dataSource" ref="dataSource"/> 
<property name="jpaVendorAdapter"> 
<bean class="org.springframework.orm. jpa.vendor.HibernateJpaVendorAdapter"> 
<property name="showSql” value="true"/> 
<property name="database" value="MYSQL"/> 
</bean> 


</property> 
</bean> 


上 面 的 配置 文件 配置 EntityManagerFactory 时 直接 使 用 了 容器 中 已 有 的 数据 源 ， 它 并 没有 直接 利 
用 已 有 的 持久 化 单元 。 不 过 上 面 的 LocalContainerEntityManagerFactoryBean 同样 需要 根据 
persistence.xml 文件 来 创建 PersistenceUnitInfo, 因此 这 种 配置 方式 同样 也 需要 persistence.xml 文件 , 只 
是 persistence.xml 文件 不 需要 管理 数据 库 连 接 信息 ， 如 下 所 示 。 

程序 清单 : codes\08\8.8UpaTemplate\src\META-INFWpersitence .xml 


<?xml version="1.0" encoding="GBK"?> 

<persistence version="1.0" xmlns="http://java. sun.com/xml/ns/persistence" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java. sun.com/xml/ns/persistence 
http://java. sun.com/xml/ns/persistence/persistence_1 0.xsd"> 
<!-~ 为 持久 化 单元 指定 名 称 ， 并 通过 transaction-type 指定 事务 类 型 
transaction-type 属性 合法 的 属性 值 有 JTA、RESOURCE_LOCAL 两 个 --> 
<persistence-unit name="person pu" transaction-type="RESOURCE_LOCAL"> 

<!-- 列 出 该 应 用 需要 访问 的 所 有 的 Entity 类 ， 
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也 可 以 用 <mapping-file> 或 cjar-file> 元 素来 定义 --> 
<class>org.crazyit .app.domain. Person</class> 
<!-- properties 元 素 用 于 为 特定 JPA 实现 包 配置 属性 -> 
<!-- 下 面 列举 的 是 Hibernate JPA 实现 中 可 以 配置 的 部 分 属性 -> 
<properties> 
<!-- 设置 是 否 格 式 化 SQL 语句 -> 
<property name="hibernate. format_sql" 
value="true"/> 
<!-- 设置 是 否 根据 要 求 自动 建 表 --> 
<property name="hibernate.hbm2dd1 .alito" 
value="update"/> 
</properties> 
</persistence-unit> 
</persistence> 


使 用 LocalContainerEntityManagerFactoryBean 配置 EntityManagerFactory 可 以 获得 对 EntityManager 
最 大 的 控制 ， 因 此 实际 项 目 中 通常 推荐 采用 这 种 方式 。 


》>》》>8.8.2 使 用 JpaTemplate 


JpaTemplate 提供 持久 层 访问 模板 化 ， 它 只 需要 提供 一 个 EntityManagerFactory 的 引用 ， 就 可 执行 
持久 化 操作 。EntityManagerFactory 对 象 既 可 通过 构造 参数 传 入 ， 也 可 通过 设 值 方式 传 入 。JpaTemplate 
提供 如 下 三 个 构造 函数 。 

> JpaTemplate(): 构造 一 个 默认 的 JpaTemplate 实例 ， 因 此 创建 了 JpaTemplate 实例 之 后 ， 

还 必须 使 用 方法 setEntityManagerFactory(EntityManagerFactory emf) 为 JpaTemplate 注入 
EntityManagerFactory 对 象 ， 然 后 才 可 进行 持久 化 操作 。 

> JpaTemplate(EntityManagerFactory emf): 在 构造 时 已 经 传 入 EntityManagerFactory 对 象 ， 

创建 后 立即 可 执行 持久 化 操作 。 

> JpaTemplate(EntityManager em): 根据 已 有 的 EntityManager 来 创建 JpaTemplate 对 象 ， 

这 个 构造 器 一 般 较 少 使 用 。 

对 于 在 Web 应 用 ， 通 常 应 用 启动 时 会 自动 创建 ApplicationContext，EntityManagerFactory 和 DAO 
对 象 都 处 在 Spring 上 下 文 管理 下 ， 因 此 无 须 在 代码 中 显 式 设 置 ， 可 采用 依赖 注入 实现 
EntityManagerFactory 和 DAO 的 解 耦 ， 依 赖 关系 通过 配置 文件 来 设置 。 

下 面 的 示例 程序 基于 JpaTemplate 实现 了 一 个 DAO 组 件 ，Spring 将 为 该 DAO 组 件 注入 所 需 
EntityManagerFactory。 该 DAO 组 件 的 实现 类 如 下 。 
程序 清单 :codes\08\8.8UpaTemplate\src\org\craziyt\app\dao\impl\PersonDaolmpl.java “ 
public class PersonDaoImpl 


implements PersonDao 


// 定 义 一 个 JpaTemplate 对 象 ， 用 于 执行 持久 化 操作 

private JpaTemplate jt = null; 

//JPA 持久 化 操作 所 需 的 EntityManagerFactory 

private EntityManagerFactory emf; 

// 依 赖 注 入 EntityManagerFactory 的 setter 方法 

public void setEntityManagerFactory (EntityManagerFactory emf) 
{ 


{ 


this.emf = emf; 
/风化 JpaTemplate 的 方法 
private JpaTemplate getJpaTemplate() 
3 if (jt == null) 

| jt = new JpaTemplate (emf) ; 


return jt; 
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/ex 
* 加 载 Person 实例 
* eparam id 需要 加 载 的 Person 实例 的 标识 属性 什 
* ereturn 指定 id 对 应 的 Person 实例 
Wd 
public Person get (Integer id) 
{ 
return getJpaTemplate() 
.find(Person.class, id); 
} 
/us 
* 保存 Person 实例 
* eparam person 需要 保存 的 Person 实例 
* @return 刚刚 保存 的 Person 实例 的 标识 属性 值 
yr 
public Integer save(Person Person) 
{ 
getJpaTemplate () .persist (person); 
return person.getId(); 


上 
J 

* 修改 Person 实例 

* eparam person 需要 修改 的 Person 实例 
th 


public void update(Person person) 
bE 
getJpaTemplate () .merge (person) ; 


} 

J 
* 删除 Person 实例 

ee fd 需要 删除 的 Person 实例 的 标识 属性 值 
* 


public void delete (Integer id) 
{ 
getJpaTemplate() .remove (get (id)) ; 
} 
/Jun 
* 删除 Person 实例 
* eparam person 需要 删除 的 Person 实例 
A 
public void delete(Person person) 
{ 
getJpaTemplate () .remove (Person) ; 
) 
/us 
* 根据 用 户 名 查找 Person 
* @param name 查询 的 人 名 
* ereturn 指定 用 户 名 对 应 的 全 部 Person 
37 
public List<Person> findByName (String name) 
{ 
return (List<Person>)getJpaTemplate() 
.find("select p from Person P where p.name = ?" 
,name) ; 
} 
As 
* 查询 全 部 Person 实例 
* @return 全 部 Person 实例 
47 
public List findAllPerson() 
{ 
return (List<Person>)getJpaTemplate() 
.find("select P from Person p"); 
7 
* 查询 数据 表 中 Person 实例 的 总 数 
* @return 数据 表 中 Person 实例 的 总 数 
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中 天 

public long getPersonNumber() 

{ 

return (Long)getJpaTemplate() .find 

("select count(*) from Person as p") 
-get(0); 

} 

} 


上 面 的 程序 中 粗 体 字 代码 用 于 创建 一 个 JpaTemplate 对 象 ， 创 建 该 对 象 时 传 入 了 一 个 
EntityManagerFactory 对 象 。 一 旦 JpaTemplate 对 象 初始 化 完成 (获得 了 EntityManagerFactory 的 引用 )， 
大 部 分 持久 化 操作 都 可 通过 该 对 象 来 完成 。 

JpaTemplate 提供 很 多 实用 方法 来 完成 基本 的 操作 ， 比 如 增加 、 删 除 、 修 改 、 查 询 等 操作 。 大 部 分 
情况 下 ， 通 过 JpaTemplate 如 下 方法 就 可 完成 大 多 数 DAO 对 象 的 CRUD 操作 。 下 面 是 JpaTemplate 的 
常用 方法 简介 。 

> void remove(Object entity):， 删除 指定 持久 化 实例 。 
find(String queryString): 根据 HQL 查询 字符 串 来 返回 实例 集合 的 系列 重 载 方法 。 
findByNamedQuery(String queryName): 根据 命名 查询 返回 实例 集合 的 系列 重 载 方法 。 
<T> Tfind(Class<T> entityClass, Object id): 根据 主键 加 载 特定 持久 化 类 的 实例 。 
void persist(Object entity)， 保 存 新 的 实例 。 
public <T> T merge(T entity): 更 新 实例 的 状态 。 

结合 上 面 的 方法 来 看 ， 不 难 发 现 借助 于 JpaTemplate 实现 持久 层 的 简洁 性 ， 大 部 分 CRUD 操作 只 
需 一 行 代码 即 可 ， 完 全 可 避免 JPA 持久 化 操作 那些 烦琐 的 步骤 。 

JpaTemplate 是 Spring 众多 模板 工具 类 之 一 ，Spring 正 是 通过 这 种 简便 的 模板 工具 类 ,为 我 们 完成 
了 开发 中 大 量 需 要 重复 进行 的 工作 。 

正如 在 上 面 的 程序 中 所 看 到 的 ，PersonDaolmpl 创建 JpaTemplate 时 需要 传 入 一 个 
EntityManagerFactory 对 象 ， 此 时 利用 Spring 的 依赖 注入 即 可 。 在 Spring 容器 中 配置 PersonDaoImpl， 
配置 文件 如 下 。 

程序 清单 : codes\08\8.8UJpaTemplate\src\bean.xml 


<!1-- 定义 DAO Bean--> 
<bean id="personDao" class= 
"org.crazyit,app. dao. impl.PersonDaoImpl"> 
<!-- 注入 持久 化 操作 所 需 的 EntityManagerFactory --> 
name="entityManagerFactory" ref="emf"/> 


遇 复 和 人 


</bean> 

如 配置 文件 中 粗 体 字 代码 所 示 ， 一 旦 我 们 在 配置 文件 中 为 PersonDaolmpl 注入 了 
EntityManagerFactory 的 引用 ， 程 序 即 可 通过 该 DAO 组 件 进行 持久 化 操作 。 在 PersonDao 组 件 中 ， 所 
有 的 持久 化 操作 都 通过 JpaTemplate 实例 完成 ,而 JpaTemplate 操作 数据 库 非常 简洁 ， 大 部 分 CRUD 操 
作 都 可 通过 一 行 代码 解决 问题 。 


》>>8.8.3 使 用 JpaCallback 


与 HibenateTemplate 类 似 ，JpaTemplate 用 起 来 非常 方便 ， 但 使 用 JpaTemplate 进行 持久 化 访问 难 
免 有 失灵 活 。 为 了 解决 JpaTemplate 灵活 性 不 足 的 问题 ，Spring 提供 了 JpaCallback 来 解决 这 个 问题 。 
JpaTemplate 提供 了 如 下 两 个 方法 来 执行 JpaCallback。 
> <T> Texecute(JpaCallback<T> action): JpaTemplate 将 根据 JpaCallback 对 象 来 执行 持久 
化 操作 。 
> List executeFind(JpaCallback<?> action): JpaTemplate 将 根据 JpaCallback 对 象 来 执行 查 
询 操作 。 
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提供 JpaCallback 对 象 主要 是 为 了 实现 该 接口 中 定义 的 T doInJpa(EntityManager em) 方 法 ， 实 现 该 
方法 时 就 可 以 获得 JPA 持久 化 操作 的 EntityManager, 这 样 就 可 以 直接 使 用 JPA 的 方式 来 进行 持久 化 访 
问 了 。 

与 使 用 HibernateCallback 类 似 的 是 ， 使 用 JpaCallback 的 代码 模板 通常 如 下 : 

getJpaTemplate.execute (new JpaCallback<Person>(){ 
Person doInJpa (EntityManager em) 
/1/ 此 处 即 可 使 用 em 对 象 进行 持久 化 访问 了 


下 
Ds 


》>8.8.4 借助 JpaDaoSupport 实现 DAO 组 件 


JpaDaoSupport 的 作用 类 似 于 HibernateDaoSuport， 它 主要 提供 了 如 下 两 个 方法 。 
> JpaTemplate getJpaTemplate(): 返回 一 个 JpaTemplate 对 象 。 
> void setEntityManagerFactory(EntityManagerFactory emf): 为 DAO 组 件 依 赖 注 入 
EntityManagerFactory 的 方法 。 
为 了 简化 DAO 的 实现 ， 可 以 让 应 用 程序 的 DAO 实现 类 继承 上 面 的 JpaDaoSupport 类 ， 通 过 这 种 
方式 可 以 更 方便 地 实现 DAO 组 件 ， 如 以 下 代码 所 示 。 
程序 清单 ，codes\08\8.8JpaDaoSupport\src\org\craziyt\app\dao\impl\PersonDaolmpl.java 


public class PersonDaoJpa 
extends JpaDaoSupport implements PersonDao 


{ 
pe 
* 加 载 Person 实例 
* 8param id 需要 加 载 的 Person 实例 的 标识 属性 值 
* @return 指定 id 对 应 的 Person 实例 
3 


public Person get(Integer id) 
{ 


return getJpaTemplate() 
.find(Person.class, id); 
} 
// 省 略 其 他 方法 
ee 
正如 上 面 的 粗 体 字 代 码 所 示 ， 一 旦 DAO 组 件 集成 了 JpaDaoSupport， 该 DAO 组 件 就 具有 了 
setEntityManagerFactory(EntityManagerFactory emf) 方 法 ， 因 此 可 以 采用 依赖 注入 来 注入 
EntityManagerFactory; 由 于 JpaDaoSupport 已 提供 了 geUpaTemplate() 方 法 ， 因 此 可 以 可 直接 通过 该 方 
法 来 获取 JpaTemplate 对 象 ， 进 而 进行 持久 化 访问 。 


>>8.8.5 使 用 声明 式 事 务 


Spring 与 JPA 整合 之 后 ， 所 有 持久 化 操作 都 应 该 处 于 事务 环境 下 进行 ， 否 则 对 数据 库 所 做 的 持久 
化 操作 如 添加 、 删 除 、 修 改 实体 都 不 会 自动 提交 。 

为 了 给 Spring+JPA 整合 的 应 用 增加 声明 式 事务 ， 完 全 可 按 8.7.7 节 所 介绍 的 方式 配置 一 一 因为 
Spring 的 声明 式 事务 管理 与 底层 所 采用 的 持久 化 技术 无 关 。 唯一 要 改变 的 只 是 : 事务 管理 器 的 实现 类 。 
在 使 用 JPA 进行 持久 化 访问 的 环境 下 ， 我 们 配置 如 下 事务 管理 器 。 


<!-- JPR 必须 在 事务 环境 下 才能 有 效 --> 
<bean id="transManager" 
class="org. springframework.orm. jpa. JpaTransactionManager"> 
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<property name="entityManagerFactory" ref="emf"/> 
</bean> 
正如 上 面 的 粗 体 字 代码 所 示 ， 此 时 我 们 使 用 了 JpaTransactionManager 作为 事务 管理 器 实现 类 。 
接 下 来 一 样 可 以 在 Spring 配置 文件 中 使 用 <tx:advice..…/> 配 置 事务 增强 处 理 ， 再 使 用 <aop:config> 
配置 切面 、 并 设置 Spring 完成 实际 织 入 即 可 。 
不 过 此 处 我 们 改 为 使 用 @Transational Annotation 来 配置 声明 式 事务 ， 例 如 我 们 在 应 用 的 业务 逻辑 
组 件 上 使 用 @Transational 类 配置 事务 管理 。 
总 i a 
一 般 都 是 在 应 用 的 业务 逻辑 层 上 增加 事务 控制 ， 因 为 业务 还 辑 组 件 里 的 一 个 方法 往往 ， 
”代表 一 次 业务 操作 ， 只 有 对 一 次 业务 操作 增加 事务 控制 才 有 意义 ! 对 DAO 组 件 的 一 次 原 | 
| 。 子 操作 添加 事务 控制 没有 任何 实际 意义 - ] 
例如 我 们 在 应 用 的 业务 逻辑 组 件 上 增加 如 下 代码 。 
程序 清单 : codes\08\8.8\regist\WEB-INF\src\org\crazyit\app\service\impl\LeeServiceImpl.java 
QTransactional 
public class LeeServiceImpl 
implements LeeService 
1 private PersonDao personDao; 
7/ 依赖 注入 DAO 组 件 所 名 的 setter 方法 
public void setPersonDao (PersonDao personDao) 
this.personDao = personDao; 
/省 赂 了 业务 过 加 方法 
】 序 
上 面 的 代码 中 使 用 了 @Transactional 修饰 该 业务 逻辑 组 件 ， 使 用 @Transactional 时 没有 指定 任何 属 
性 ， 这 意味 着 将 全 部 使 用 默认 设置 。 
为 业务 逻辑 组 件 增加 了 @Transactional 修饰 之 后 ， 接 下 来 还 需要 在 Spring 配置 文件 中 配置 根据 
Annotation 生成 事务 代理 。 如 以 下 代码 所 示 。 
程序 清单 :codes\08\8.8\regist\WEB-INF\src\bean.xml 


<!-- JPA 必须 在 事务 环境 下 才能 有 效 --> 

<bean id="transManager" 
class="org. springframework.orm.jpa.JpaTransactionManager"> 
<property name="entityManagerFactory" ref="emf"/> 

</bean> 

<!-- 根据 Annotation 生成 事务 代理 --> 

<tx:annotation-driven transaction-manager="transManager"/> 


8.9 本 章 小 结 


本 章 详细 介绍 了 Spring 框架 高 级 部 分 ， 包 括 如 何 利用 Spring 的 后 处 理 器 扩展 Spring 的 IoC 容器 ， 
并 介绍 了 Spring 的 资源 访问 策略 ， 从 策略 模式 的 角度 来 深入 剖析 了 Spring 资源 访问 的 设计 思路 。 

本 章 介绍 的 另 一 个 重点 是 AOP, 这 里 只 介绍 了 Spring 2.X 的 AOP 支持 , 简要 介绍 了 Aspect 编程 ， 
详细 介绍 了 Spring AOP 对 AspectJ 的 支持 , 深入 介绍 了 如 何 利用 Annotation、XML 配置 两 种 方式 来 管 
理 切 面 、 切 入 点 、 增 强 处 理 等 内 容 ， 深 入 掌握 这 些 AOP 内 容 对 Java EE 开发 者 将 有 极 大 的 作用 。 

本 章 的 后 面部 分 则 介绍 了 Spring 与 Struts 2 和 Hibemate 框架 的 整合 ， 介 绍 三 个 框架 整合 的 同时 ， 
也 介绍 了 Java EE 应 用 各 组 件 的 组 织 方式 ， 并 给 出 了 如 何 利用 Spring IoC 容器 管理 各 组 件 ， 以 及 声明 
式 事务 的 配置 。 
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本 章 要 点 


他 企 业 应 用 开发 的 挑战 

世 解 决 企业 应 用 开发 中 挑战 的 思考 方式 吉 
世 设 计 模式 的 背景 
各 单 例 模式 

芭 简 单 工厂 

人 工厂 方法 和 抽象 工厂 
他 代 理 模式 

委 命 令 模 式 

和 策略 模式 

芝 门 面 模式 

桥接 模式 。 
划 观 察 者 模式 

苗 软 件 架构 设计 的 原则 
芝 贫 血 模式 


入 领域 对 银 模 型 的 简化 设计 


让 玉生 已 
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和 9 


企业 级 应 用 的 开发 平台 相当 多 ， 如 Java EE、Dot Net、PHP 和 Ruby On Rails 等 。 这 些 平台 为 企业 
级 应 用 的 开发 提供 了 丰富 的 支持 ， 都 实现 了 企业 应 用 底层 所 需 的 功能 : 缓冲 池 、 多 线程 及 持久 层 访问 
等 。 虽 然 企 业 开发 有 如 此 之 多 的 选择 ， 企 业 级 应 用 的 开发 依然 困难 重重 。 

本 章 将 会 简要 介绍 企业 开发 应 用 过 程 中 所 面临 的 困难 ， 以 及 面 对 这 些 困难 时 常用 的 思考 方式 和 应 
对 策略 。 开 发 一 个 大 型 企业 级 应 用 时 ， 常 常 必须 面 对 各 种 各 样 的 问题 ， 而 这 些 问题 常常 具有 特定 的 场 
景 ， 而 且 往 往 会 重复 出 现 ， 借 助 于 前 人 己 有 的 、 较 为 成 熟 的 解决 方案 来 解决 这 些 问题 ， 既 可 提供 应 用 
开发 的 效率 ,也 可 保证 应 用 开发 的 质量 。 这些 前 人 已 有 的 、 较为 成 熟 的 解决 方案 就 是 所 谓 的 设计 模式 ， 
本 章 将 会 深入 介绍 Java EE 应 用 中 常用 的 设计 模式 。 

所 有 企业 级 应 用 的 开发 平台 都 提供 了 高 级 、 抽 象 的 API， 但 仅 依靠 这 些 API 构建 企业 级 的 应 用 远 
远 不 够 。 在 这 些 高 级 API 基础 上 ， 搭 建 一 个 良好 的 开发 体系 ， 也 是 企业 级 应 用 开发 必 不 可 少 的 步骤 。 
本 章 将 从 理论 上 介绍 如 何 搭建 一 个 良好 、 可 维护 、 可 扩展 、 高 稳定 性 且 能 够 快速 开发 的 应 用 架构 ， 本 
章 还 会 重点 介绍 Java EE 应 用 中 常用 的 架构 模型 。 


9.1 企业 应 用 开发 面临 的 挑战 


应 用 的 开发 是 相当 复杂 的 ， 这 种 复杂 除了 表现 在 技术 方面 外 ， 还 表现 在 行业 本 身 所 蕴含 的 专 
业 知 企业 级 应 用 的 开发 往往 需要 面 对 更 多 的 问题 : 大 量 的 并 发 访问 ， 复 杂 的 环境 ， 网 络 的 不 稳 
定 ， 还 有 外 部 的 Crack 行为 等 。 因 此 企业 级 应 用 必须 提供 更 好 的 多 线程 支持 ， 具 备 良 好 的 适应 性 及 良 
好 的 安全 性 等 。 
由 于 各 行业 的 应 用 往往 差别 非常 大 ， 因 此 企业 级 应 用 往往 具有 很 强 的 行业 规则 ， 尤 其 是 优良 的 企 
业 级 应 用 往往 更 需要 丰富 的 行业 知识 。 企 业 应 用 的 开发 成 功 ， 也 需要 很 多 人 的 共同 协作 。 
下 面 对 企业 应 用 开发 面临 的 挑战 作 具 体 分 析 。 


>>9.1.1 可 扩展 性 、 可 伸缩 性 


市 场 是 瞬息 万 变 的 ， 企 业 也 是 随 之 而 变 的 。 而 信息 化 系统 是 为 企业 服务 的 ， 随 着 企业 需求 的 变化 
企业 应 用 的 变化 也 是 必然 的 。 

笔者 在 多 年 开发 过 程 中 ， 经 常 听 到 软件 开发 者 对 于 需求 变更 的 抱怨 。 当 开发 进行 到 中 间 时 ， 大 量 
的 工作 需要 重新 开始 ， 确 实 给 人 极 大 的 挫败 感 ， 难 免 软件 开发 者 会 抱怨 。 不 过 ， 笔 者 认为 ， 一 个 积极 
的 软件 开发 者 应 该 可 以 正确 对 待 需求 的 变更 。 需 求 的 变更 ， 表 明 有 市 场 前 景 ， 只 有 有 变化 的 产品 才 是 
有 市 场 的 产品 。 

优秀 的 企业 级 应 用 必须 具备 良好 的 可 扩展 性 和 可 伸缩 性 。 因 为 良好 的 可 扩展 性 可 允许 系统 动态 增 
加 新 功能 ， 而 不 会 影响 原 有 的 功能 。 

良好 的 可 扩展 性 建立 在 高 度 的 解 看 之 上 。 使 用 Delphi、PowerBuilder 等 工具 的 软件 开发 人 员 对 ini 
文件 一 定 不 会 陌生 。 使 用 ini 文件 是 一 种 基本 的 解 耦 方式 ， 将 运行 所 需 资源 、 模 块 的 耦合 等 从 代码 中 
分 离 出 来 ， 放 入 配置 文件 管理 。 这 是 一 种 优秀 的 设计 思路 ， 最 理想 的 情况 是 允许 使 用 可 插 拔 式 的 模块 
(类 似 于 Eclipse 的 插件 方式 )。 

在 Java EE 应 用 里 ， 大 多 采用 XML 文件 作为 配置 文件 。 使 用 XML 配置 文件 可 以 避免 修改 代码 ， 
从 而 能 极 好 地 提高 程序 的 解 罚 。XML 文件 常用 于 配置 数据 库 连接 信息 ， 通 过 使 用 XML 文件 的 配置 方 
式 ， 可 以 让 应 用 在 不 同 的 数据 库 平台 上 轻松 切换 。 从 而 避免 在 程序 中 使 用 硬 编码 的 方式 来 定义 数据 库 
的 连接 ， 也 避免 了 在 更 改 数据 库 时 ， 需 要 更 改 程序 代码 ， 从 而 提供 更 好 的 适应 性 。 

下 面 是 使 用 Spring 的 Bean 定义 数据 源 的 代码 。 


<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDatasource" 


企业 
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destroy-method="close"> 


<!-~ 指定 连接 数据 库 的 驱动 -> 


<property name="driverClass" value="com.mysql.jdbc.Driver"/> 


<!-- 指定 连接 数据 库 的 URL 一 -> 
<property name="jdbcUrl" value="jdbc:mysql://localhost/auction"/> 


<!-- 指定 连接 数据 库 的 用 户 名 -> 
<property name="user" value="root"/> 

<!-- 指定 连接 数据 库 的 密码 一 > 

<property name="password" value="32147"/> 
<!-- 指定 连接 数据 库 连 接 池 的 最 大 连接 数 一 -> 
<property name="maxPoolSize" value="40"/> 
<!-- 指定 连接 数据 库 连 接 池 的 最 小 连接 数 一 -> 
<property name="minPoolSize" value="1"/> 
<!-- 指定 连接 数据 库 连接 池 的 初始 化 连接 数 一 -> 
<property name="initialPoolSize" value="1"/> 


<!-~ 指定 连接 数据 库 连接 池 的 连接 最 大 空闲 时 间 --> 
<property name="maxIdleTime" value="20"/> 
</bean> 
上 面 的 配置 文件 可 用 于 建立 数据 库 的 连接 ， 可 等 同 于 如 下 代码 : 


// 创 建 数据 源 实例 
ComboPooledDataSource ds = new ComboPooledDatasouirce(); 


// 设 置 连接 数据 库 的 驱动 
ds.setDriverClass ("com.mysql .jdbc.Driver"); 


// 设 置 数据 库 库 服务 的 DRL 

da.setJdbcUrl ("jdbc:mysql://localhost:3306/javaee"); 
// 设 置 数据 库 用 户 名 

ds.setUser ("root"); 

// 设 置 数据 库 连 接 密码 

ds.setPassword("32147"); 


// 指 定 连接 数据 库 连 接 池 的 最 大 连接 数 
ds.setMaxPoolSize(40); 

// 指 定 连接 数据 亩 连接 池 的 最 小 连接 数 
ds.setMinPoolSsize (1); 

// 指 定 连接 数据 库 连 接 池 的 初始 化 连接 数 
ds,.setInitialPoolsize (1); 

// 指 定 连接 数据 库 连 接 池 的 连接 最 大 空 用 时 间 


ds.setMaxIdleTime (true); 

可 以 看 出 ， 第 一 种 方式 明显 比 第 二 种 方式 更 优秀 。 因 为 当 系 统 的 数据 库 发 生变 化 时 (这 是 相当 常 
见 的 情形 )， 开 发 用 的 数据 库 与 实际 应 用 的 数据 库 不 可 能 是 同一 个 数据 库 ， 当 软件 系统 由 客户 使 用 时 ， 
其 数据 库 系统 也 是 需要 改变 的 。 采 用 第 一 种 方式 则 无 须 修改 系统 源 代码 ， 仅 通过 修改 配置 文件 就 可 以 
让 系统 适应 数据 库 的 改变 。 

使 用 XML 配置 文件 提高 解 看 的 方式 ， 是 目前 企业 级 应 用 最 常用 的 解 耦 方式 ， 而 依赖 注入 的 方式 
则 提供 了 更 高 层次 的 解 耦 。 使 用 依赖 注入 可 以 将 各 模块 之 间 的 调用 从 代码 中 分 离 出 来 ， 并 通过 配置 文 
件 来 装配 组 件 。 此 处 的 依赖 注入 并 非特 指 Spring， 事 实 上 ， 依 赖 注入 容器 很 多 ， 如 HiveMind 等 。 


》>》>9.1.2 快捷 、 可 控 的 开发 


如 果 没 有 时 间 限制 ， 任 何 一 个 软件 系统 在 理论 上 都 是 可 实现 的 。 但 这 样 的 条 件 不 存在 ， 软 件 系统 
必须 要 及 时 投放 市 场 。 对 于 企业 级 应 用 ， 时 间 的 限制 则 更 加 严格 。 正 如 前 文 介绍 的 ， 企 业 的 信息 是 瞬 
息 万 变 的 ， 与 之 对 应 的 系统 必须 能 与 时 俱 进 。 因 此 快捷 、 可 控 是 企业 信息 化 系统 必须 面 对 的 挑战 。 

软件 开发 人 员 常 常 乐于 尝试 各 种 新 的 技术 ， 总 希望 将 各 种 新 的 技术 带 入 项 目的 开发 中 ， 因 而 难免 
有 时 会 将 整个 项 目 陷入 危险 的 境地 

当然 , 采用 更 优秀 、 更 新 颖 的 技术 , 通常 可 以 保证 软件 系统 的 性 能 更 加 稳定 。 例如 ， 从 早期 的 C/S 
架构 向 B/S 架构 的 过 渡 ， 以 及 从 Model 1 到 Model 2 的 过 渡 等 。 这 些 都 提高 了 软件 系统 的 可 扩展 性 及 
可 伸缩 性 。 

但 采用 新 的 技术 所 带 来 的 风险 也 是 不 得 不 考虑 的 ， 开 发 架构 必须 重新 论证 ， 开 发 人 员 必 须 重新 培 
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训 ， 这 都 需要 成 本 投入 。 如 果 整 个 团队 缺乏 精通 该 技术 的 领导 者 ， 项 目的 开发 难免 会 陷入 技术 难题 ， 
从 而 导致 软件 的 开发 过 程 变 成 不 可 控 的 一 一 这 是 非常 危险 的 事情 。 
成 功 的 企业 级 应 用 , 往往 是 保证 其 良好 的 可 扩展 性 及 可 伸缩 性 , 并 建立 在 良好 的 可 控 性 的 基础 上 。 


> >9.13 稳定 性 、 高 效 性 


企业 级 应 用 还 有 个 显著 特点 : 并 发 访问 量 大， 访问 频繁 。 因 此 稳定 性 、 高 效 性 是 企业 级 信息 化 系 
统 必须 达到 的 要 求 。 

企业 级 应 用 必须 有 优秀 的 性 能 , 如 采用 缓冲 池 的 技术 。 缓冲 池 专 用 于 保存 那些 创建 开销 大 的 对 象 ， 
如 果 对 象 的 创建 开销 大 ， 花 费时 间 长 ， 该 技术 可 将 这 些 对 象 缓存 ， 避 免 了 重复 创建 ， 从 而 提高 系统 性 
能 。 典 型 的 应 用 是 数据 连接 池 。 

提高 企业 级 应 用 性 能 的 另 一 个 方法 是 一 数据 缓存 。 但 数据 缓存 有 其 缺点 : 数据 缓存 虽然 在 内 存 
中 ， 可 极 好 地 提高 系统 的 访问 速度 ;但 缓存 的 数据 占用 了 相当 大 的 内 存 空间 ， 这 将 会 导致 系统 的 性 能 
下 降 。 因 此 ， 数 据 缓存 必须 根据 实际 硬件 设施 制定 ， 最 好 使 用 配置 文件 来 动态 管理 缓存 的 大 小 。 


>>9.1.4 花费 最 小 化 ， 利 益 最 大 化 


这 是 个 永恒 的 话题 ， 任 何 一 个 商业 组 织 都 希望 尽 可 能 地 降低 开销 。 对 开发 者 而 言 ， 降 低 开销 主要 
是 如 何 使 在 开发 上 的 投资 更 有 保值 效果 。 即 开发 的 软件 系统 具有 很 好 的 复 用 性 ， 而 不 是 每 次 面临 系统 
开发 任务 时 ， 总 是 需要 重复 开发 。 

尽 可 能 让 软件 可 以 有 高 层次 的 复 用 ， 这 也 是 软件 行业 的 发 展 趋势 。 早 期 软件 多 采用 结构 化 的 程序 
设计 语言 ， 此 时 的 软件 复 用 多 停留 在 代码 复 用 的 层次 。 面 向 对 象 的 程序 设计 语言 的 出 现 ， 使 代码 复 用 
提高 到 了 类 的 复 用 中 。 

在 良好 的 Java EE 架构 设计 中 ， 复 用 是 一 个 永恒 的 追求 目标 。 架 构 设计 师 希 望 系统 中 大 部 分 的 组 
件 可 以 复 用 ， 甚 至 能 让 系统 的 整个 层 可 以 复 用 。 对 于 采用 DAO 模式 的 系统 架构 ， 如 果 数 据 库 不 发 生 
大 的 改变 ， 整 个 DAO 层 都 不 需要 变化 。 


9.2 如何 面 对 挑战 


除了 在 上 文 介绍 的 所 面临 的 各 种 技术 挑战 之 外 ， 企 业 级 应 用 还 有 更 多 的 挑战 。 每 个 行业 都 有 各 自 
复杂 的 规则 ， 软 件 开发 者 往往 缺乏 对 行业 规则 的 了 解 。 企 业 级 应 用 的 开发 通常 需要 软件 开发 者 和 行业 
专家 齐心 协作 ， 但 系统 开发 中 沟通 成 本 又 相当 地 高 ， 因 为 软件 开发 者 与 行业 专家 之 间 的 沟通 往往 存在 
不 少 障 碍 ， 这 些 都 会 影响 系统 的 开发 。 

面 对 这 些 挑战 ， 笔 者 有 如 下 建议 。 


“>>9.2.1 使 用 建 模 工具 


此 处 的 建 模 工具 不 一 定 是 ROSE 等 ， 可 以 是 简单 的 手 画 草图 。 当 然 ， 借 助 于 专业 的 建 模 工具 可 以 
更 好 地 确定 系统 模型 。 

任何 语言 的 描述 都 很 空洞 ， 而 且 具 有 很 大 的 歧义 性 。 使 用 图 形 则 更 加 直观 ， 而 且 意 义 更 加 明确 。 
推荐 使 用 建 模 工具 主要 出 于 如 下 两 个 方面 的 考虑 。 

用 于 软件 开发 者 与 行业 专家 之 间 沟 通 ， 正 如 前 文 所 介绍 的 ， 行 业 专家 与 软件 开发 者 之 间 对 系统 的 
理解 可 能 存在 少许 差异 。 使 用 图 形 来 帮助 交流 是 不 错 的 主意 ， 通 过 建 模 工具 绘制 的 各 种 图 形 ， 可 使 软 
件 系统 的 模型 更 加 清晰 化 。 
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用 于 软件 开发 者 之 间 的 沟通 。 即 使 在 软件 开发 者 内 部 ， 对 于 软件 的 模型 往往 也 不 是 非常 统一 的 。 
使 用 建 模 工具 可 以 减少 软件 开发 者 对 于 系统 的 理解 分 歧 ， 从 而 降低 沟通 成 本 。 

关于 建 模 工 具 ， 推 荐 采用 统一 建 模 语言 : UML。 但 UML 的 使 用 也 需要 掌握 分 寸 ， 在 软件 开发 人 
员 内 部 使 用 时 ， 尽 可 能 使 用 规范 的 UML; 但 用 于 与 行业 专家 沟通 时 ， 则 应 该 尽量 增加 文字 说 明 ， 而 不 
要 拘泥 于 UML 图 形 的 表现 上 ， 切 忌 仅 将 一 个 图 形 生硬 摆 出 。 


》>>9.2.2 利用 优秀 的 框架 


使 用 框架 可 以 大 大 提高 系统 的 开发 效率 。 除 非 开 发 一 个 非常 小 的 系统 ， 而 且 是 开发 后 无 须 修改 的 
系统 ， 才 可 以 完全 抛弃 框架 。 

优秀 的 框架 本 身 就 是 从 实际 开发 中 抽取 的 通用 部 分 ， 使 用 框架 就 可 以 避免 重复 开发 通用 部 分 。 使 
用 优秀 的 框架 不 仅 可 以 直接 使 用 框架 中 的 基本 组 件 和 类 库 ， 还 可 以 提高 软件 开发 人 员 对 系统 架构 设计 
的 把 握 。 使 用 框架 有 如 下 几 个 优势 。 

1. 提高 生产 效率 

框架 是 在 实际 开发 过 程 中 抽取 出 来 的 通用 部 分 。 使 用 框架 可 以 避免 开发 重复 的 代码 ， 看 下 面 的 

，JDBC 数据 库 访问 代码 。 
7/ 注册 数据 库 驱动 


Class. forName ("com.mysql. jdbc.Driver"); 

// 数 据 服务 的 URL 

String url = "jdbc:mysql://localhost/javaee"; 

// 数 据 库 的 用 户 名 

String username = "root"; 

// 数 据 库 密码 

String password = "32147"; 

// 获 取 数据 库 连接 

Connection conn = DriverManager.getConnection (url,username, password); 
String sqle"..."; 

// 创 建 Preparedstatement 

PreparedStatement pstmt =c onn. préparestatement (sql); 
// 为 SQL 语句 传 入 参数 

for(int i = 0 ; i < args.length ; i++) 

{ 


pstmt.setobject (i + 1 , args[i]); 
) ’ 

// 执 行 更 新 

pstmt ,executeUpdate()7 

上 面 的 代码 是 连接 数据 库 执行 数据 更 新 的 代码 。 而 这 个 过 程 的 大 部 分 都 是 固定 的 ， 包 括 连接 数据 
库 、 创 建 Statement 及 执行 更 新 等 ， 唯 一 需要 变化 的 是 SQL 语句 。 

在 实际 的 开发 过 程 中 ， 不 可 能 总 是 采用 这 种 步骤 进行 数据 库 访问 ， 为 避免 代码 重复 ， 可 在 实际 的 
开发 中 提取 出 如 下 方法 : 

public Class DbBean 


// 用 于 执行 更 新 的 方法 
public void update(String sql ，String[] args) 


t 
// 创 建 Statement 对 象 
_ Preparedstatement pstmt= getConnection() .preparestatement (sql); 
// 为 SQL 语 旬 传 入 参数 
forlint i1 = 0 ; i < tgs:length ; 1++) 
{ 
pstmt.setobject (i + 1 , args[i]); 


) 
// 执 行 更 新 
pstmt .executeUpdate (sql) ; 
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// 获 取 数据 库 连接 
Private Connection getConnection() 
{ 

if (conn == null) 


{ 
7/ 注册 数据 库 驱动 
Class. forName ("com.mysql .jdbc.Driver") ; 
7/ 数据 服务 的 DRL 
String url="jdbc:mysql://localhost/javaee"; 
7/ 数据库 的 用 户 名 
String Username="root”7 
// 数 据 库 密 码 
String password="32147"; 


/ /获取 数 据 库 连 接 
conn= DriverManager.getConnection{url,username, password) ; 


} 
} 二 四 
上 面 的 代码 可 以 大 大 减少 代码 的 重复 量 ， 但 依然 需要 开发 者 完成 连接 数据 库 、 创 建 Prepared 
Statement 等 步骤 。 如 果 使 用 Spring 的 JDBC 抽象 框架 ， 上 面 的 代码 则 可 以 简化 为 如 下 


JdbcTemplate jt ~ new JdbcTemplate(); 
// 为 JdbcTemplate 指定 DataSource 
jt. setDatasource (ds); 


// 更 新 所 使 用 的 SQL 语句 
String sql="..."; 
// 执 行 更 新 


jt.update (sq1)7 

借助 于 Spring 的 JDBC 抽象 框架 ， 数 据 库 访问 无 须 手 动 获取 连接 ， 无 须 创建 Statement 等 对 象 。 
只 需要 传 入 一 个 DataSource 对 象 ， 由 JdbeTemplate 完成 DataSource 获取 数据 库 连接 ， 创 建 Statement 
对 象 ， 执行 数据 库 更 新 的 通用 步骤 。 而 软件 开发 者 只 需要 提供 简单 的 SQL 语句 即 可 。 

另外 ， 使 用 框架 可 以 缩短 系统 的 开发 时 间 ， 特 别 是 对 于 大 型 项 目的 开发 ， 使 用 框架 的 优势 将 更 加 
明显 。 根 据 JavaWorld 社区 的 调查 ， 使 用 框架 和 不 使 用 框架 的 时 间 对 比如 图 9.1 所 示 。 


不 村 用 大 加 


图 9.1 使 用 框架 和 不 使 用 框架 的 对 比 


2. 具有 更 稳定 、 更 优秀 的 性 能 

如 果 不 使 用 已 有 的 框架 ， 系 统 开发 者 将 面临 着 需要 自己 完成 所 有 的 底层 部 分 * 除非 开发 者 丝毫 不 
遵守 软件 复 用 的 原则 ， 总 是 重复 书写 相同 代码 。 

系统 开发 者 从 系统 开发 中 提取 出 的 共同 部 分 ， 也 可 成 为 框架 。 不 可 和 否认， 完全 由 开发 者 自己 提取 
框架 有 自己 的 优势 ， 开 发 人 员 更 加 熟悉 框架 的 运行 ， 无 须 投入 成 本 学 习 新 的 技术 ; 但 借助 于 已 有 框架 
的 优势 更 加 明显 ， 己 有 的 框架 通常 已 被 非常 多 的 项 目 验证 过 ， 框 架 的 性 能 等 通常 更 有 保障 ， 而 开发 者 
自己 提取 的 框架 则 可 能 包含 许多 未 知 的 隐患 。 
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因此 为 了 更 好 地 了 解 框 架 底层 的 运行 ， 建 议 使 用 开源 框架 。 

3. 更 好 的 保值 性 

采用 框架 开发 的 系统 使 模块 组 织 更 加 一 致 ， 从 而 降低 了 软件 开发 者 之 间 的 沟通 成 本 ， 使 系统 具有 
更 好 的 可 读 性 ， 从 而 让 软件 系统 具有 更 好 的 保值 性 。 

后 期 的 更 新 、 维 护 也 是 企业 级 应 用 开发 的 重要 组 成 部 分 。 而 使 用 框架 的 系统 具有 很 大 的 相似 性 ， 
从 而 有 利于 后 期 的 更 新 及 维护 。 


9.2.3 选择 性 地 扩展 


软件 的 需求 千变万化 ， 任 何 框架 不 可 能 总 是 那么 完美 ， 难 免 需要 扩展 现 有 的 框架 。 

在 许多 项 目 中 ， 开 发 者 往往 喜欢 实现 自己 的 框架 ， 认 为 一 个 固定 的 框架 会 限制 其 发 挥 ， 事 实 上 
他 们 没有 意识 到 如 何 扩展 框架 。 虽 然 开发 自己 的 框架 可 以 获得 全 部 的 控制 权 ， 但 是 这 也 意味 着 需要 很 
多 资源 来 实现 它 。 正 如 前 文 讨论 过 的 ， 实 现 自己 的 框架 将 需要 开发 者 保证 框架 的 稳定 性 及 性 能 。 

而 对 已 有 的 框架 进行 扩展 ， 则 可 最 大 限度 地 利用 已 有 的 框架 ， 即 使 是 扩展 已 有 的 框架 ， 笔 者 也 不 
建议 盲目 扩展 ， 因 为 新 增 的 部 分 有 时 会 引入 新 的 风险 。 笔 者 建议 应 对 已 有 框架 深入 研究 ， 尽 量 利用 已 
有 组 件 ， 除 非 无 法 使 用 已 有 框架 时 ， 才 考虑 选择 性 地 扩展 。 


> >9.2.4 使 用 代码 生成 器 


使 用 代码 生成 器 可 以 自动 生成 部 分 程序 ， 不 但 可 以 省 去 许多 重复 性 的 劳动 ， 而 且 在 系统 开发 过 程 
中 可 以 大 大 节省 时 间 。 程 序 生成 器 的 效率 很 高 ， 在 开发 软件 的 许多 环节 都 有 很 好 的 作用 ， 如 数据 持久 
化 、 界 面 及 中 间 件 等 。 

代码 生成 器 还 有 个 最 大 的 作用 : 在 原型 开发 期 间 可 以 大 量 重复 利用 代码 生成 器 。 原 型 系统 通常 在 
需求 不 十 分 明确 时 非常 有 用 ， 此 时 的 需求 尚未 确定 ， 而 软件 功能 业务 无 须 十 分 完备 ， 仅 提供 大 致 的 软 
件 功能 ， 此 时 的 代码 生成 器 就 非常 有 用 。 


9.3 ”常见 设计 模式 精 讲 


设计 模式 的 概念 最 早起 源 于 建筑 设计 大 师 Alexander 的 《建筑 的 永恒 方法 》 一 书 ， 尽 管 Alexander 
的 著作 是 针对 建筑 领域 的 , 但 他 的 观点 实际 上 适用 于 所 有 的 工程 设计 领域 , 其 中 也 包括 软件 设计 领域 。 
在 《建筑 的 永恒 方法 》 一 书 中 ，Alexander 是 这 样 描述 模式 的 : 

模式 是 一 条 由 三 个 部 分 组 成 的 通用 规则 : 它 表示 了 一 个 特定 环境 、 一 类 问题 和 一 个 解决 方案 之 间 
的 关系 。 每 一 个 模式 描述 了 一 个 不 断 重复 发 生 的 问题 ， 以 及 该 问题 解决 方案 的 核心 设计 。 

软件 领域 的 设计 模式 也 有 类 似 的 定义 ;设计 模式 是 对 处 于 特定 环境 下 ， 经 常 出 现 的 某 类 软件 开发 
问题 的 ， 一 种 相对 成 熟 的 设计 方案 。 

对 应 到 日 常生 活 中 ， 我 们 无 时 无 刻 不 在 使 用 模式 。 例 如 ， 当 你 看 前 面 出 现 一 条 水 沟 时 ， 较 为 成 熟 
的 做 法 是 跳 过 去 一 一 无 须 重新 思索 、 重 新 设计 下 一 步 该 如 何 做 。 这 个 例子 很 浅显 ， 看 上 没有 什么 值得 
研究 的 , 但 试想 :如果 你 从 未 到 过 地 球 从 火星 过 来 ? )， 如 果 你 突然 看 到 一 条 水 沟 ， 你 是 否 需 要 重新 
想 一 想 昵 ? 换个 思路 ， 当 你 对 软件 开发 还 未 熟悉 、 且 刚刚 踏 入 软件 开发 行业 ， 与 一 个 火星 人 刚刚 踏 上 
地 球 是 否 有 一 定 相似 之 处 ? 所 以 每 次 你 遇 到 一 个 问题 时 ， 可 能 都 需要 想 一 想 ， 但 通过 设计 模式 就 可 以 
直接 运用 前 面 成 功 的 经 验 ， 从 而 避免 重复 设计 。 

所 有 资深 软件 设计 师 ， 他 们 积累 了 足够 的 经 验 ， 这 些 经 验 可 以 让 他 们 快速 、 优 雅 地 解决 软件 开发 
中 的 大 量 重复 问题 。 而 设计 模式 的 最 终 目 标 就 是 帮助 人 们 利用 软件 设计 师 的 集体 经 验 ， 从 而 设计 出 更 
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和 


加 优秀 的 软件 。 

很 多 人 容易 把 设计 模式 想象 成 非常 高 深 的 概念 ， 笔 者 还 见 过 一 些 学 员 喜 欢 抱 着 一 本 设计 模式 的 书 
研究 ， 以 期 成 为 一 个 “高 手 ”( 笔 者 估计 他 肯定 是 武侠 小 说 看 多 了 )， 实 际 上 设计 模式 的 理解 必须 以 足 
够 的 代码 积累 量 作为 基础 。 因 为 如 果 你 没有 足够 的 走路 、 跳 跃 经 验 ， 现 在 直接 告诉 你 : 当 遇 到 一 条 水 
沟 时 ， 一 定 要 跳 过 去 ， 你 能 理解 吗 ? 因此 学 习 设 计 模式 之 前 ， 必 须 积累 足够 的 代码 量 〈 就 像 必 须 走 过 
足够 的 路 一 样 )。 

本 节 与 专门 介绍 设计 模式 的 图 书 存在 显著 的 区 别 : 本 节 的 重点 不 是 全 面 地 介绍 各 种 设计 模式 ， 而 
是 从 实用 主义 角度 来 谈 设计 模式 。 本 节 并 不 仅仅 介绍 设计 模式 的 实现 ， 因 为 笔者 认为 : 仅仅 研究 设计 
模式 的 实现 是 没有 意义 的 。 本 节 将 会 联系 实际 Java EE 应 用 开发 来 介绍 设计 模式 ， 并 深入 分 析 Spring、 
Hibernate 等 框架 ， 以 及 Java EE 应 用 中 常用 设计 模式 的 应 用 场景 。 

根据 Erich Gamma、Richard Helm、Ralph Johnson、John Vlissides (他 们 是 软件 设计 模式 的 奠基 人 ) 
的 说 法 ， 设 计 模式 常常 被 分 成 如 下 三 类 。 

> ”创建 型 : 创建 对 象 时 ， 不 再 由 我 们 直接 实例 化 对 象 ， 而 是 根据 特定 场景 ， 由 程序 来 确定 创建 

对 象 的 方式 ， 从 而 保证 更 大 的 性 能 、 更 好 的 架构 优势 。 创 建 型 模式 主要 有 简单 工厂 模式 〈 并 
不 是 23 种 设计 模式 之 一 ) 、 工 厂 方法 、 抽 象 工厂 模式 、 单 例 模式 、 生 成 器 模式 和 原型 模式 。 
> ”结构 型 : 用 于 帮助 将 多 个 对 象 组 织 成 更 大 的 结构 。 结 构 型 模式 主要 有 适配器 模式 、 桥 接 模式 、 
组 合 器 模式 、 装 饰 器 模式 、 门 面 模式 、 享 元 模式 和 代理 模式 。 
> 行为 型 ， 用 于 帮助 系统 间 各 对 象 的 通信 ， 以 及 如 何 控制 复杂 系统 中 流程 。 行 为 型 模式 主要 有 
命令 模式 、 解 释 器 模式 、 友 人 代 器 模式 、 中 介 者 模式 、 备 忘 录 模 式 、 观 察 者 模式 、 状 态 模式 、 
策略 模式 、 模 板 模式 和 访问 者 模式 。 


9.3.1 单 例 模式 


有 些 时 候 ， 人 允许 自由 创建 某 个 类 的 实例 没有 意义 ， 还 可 能 造成 系统 性 能 下 降 〈 因 为 创建 对 象 所 带 
来 的 系统 开销 问题 )。 例 如 整个 系统 只 有 一 个 窗口 管理 器 ， 只 有 一 个 假 脱 机 打印 设备 ; 在 Java EE 应 用 
中 可 能 只 需要 一 个 数据 库 引擎 访问 点 ，Hibemate 访问 时 只 需要 一 个 SessionFactory 实例 ， 如 果 在 系统 
中 为 它们 创建 多 个 实例 就 没有 太 大 的 意义 。 

如 果 一 个 类 始终 只 能 创建 一 个 实例 ， 则 这 个 类 被 称 为 单 例 类 ， 这 种 模式 就 被 称 为 单 例 模式 。 

对 Spring 框架 而 言 ， 可 以 在 配置 Bean 实例 时 指定 scope="singleton" 来 配置 单 例 模式 。 不 仅 如 此 ， 
如 果 配 置 <bean .…/> 元 素 时 没有 指定 scope 属性 ， 则 该 Bean 实例 默认 是 单 例 的 行为 方式 。 

Spring 推荐 将 所 有 业务 逻辑 组 件 、DAO 组 件 、 数 据 源 组 件 等 配置 成 单 例 的 行为 方式 ， 因 为 这 些 组 
件 无 须 保 存 任何 用 户 状态 ， 故 所 有 客户 端 都 可 共享 这 些 业务 逻辑 组 件 、DAO 组 件 ， 因 此 推荐 将 这 些 组 
件 配置 成 单 例 模式 的 行为 方式 。 

如 果 不 借助 Spring 框架 ， 我 们 也 可 手动 实现 单 例 模式 。 为 了 保证 该 类 只 能 产生 一 个 实例 ， 程 序 不 
能 允许 自由 创建 该 类 的 对 象 ， 而 是 只 允许 为 该 类 创建 一 个 对 象 。 为 了 避免 程序 自由 创建 该 类 的 实例 ， 
我 们 使 用 private 修饰 该 类 的 构造 器 ， 从 而 将 该 类 的 构造 器 隐藏 起 来 。 

将 该 类 的 构造 器 隐藏 起 来 , 则 需要 提供 一 个 public 方法 作为 该 类 的 访问 点 , 用 于 创建 该 类 的 对 象 ， 
且 该 方法 必须 使 用 static 修饰 (因为 调用 该 方法 之 前 还 不 存在 对 象 ， 因 此 调用 该 方法 的 不 可 能 是 对 象 ， 
只 能 是 类 )。 

除 此 之 外 ， 该 类 还 必须 缓存 已 经 创建 的 对 象 ， 否 则 该 类 无 法 知道 是 否 曾经 创建 过 实例 ， 也 就 无 法 
保证 只 创建 一 个 实例 。 为 此 该 类 需要 使 用 一 个 静态 属性 来 保存 曾经 创建 的 实例 ， 且 该 属性 需要 被 静态 
方法 访问 ， 所 以 该 属性 也 应 使 用 static 修饰 。 

基于 上 面 的 介绍 ， 下 面 的 程序 创建 了 一 个 单 例 类 。 
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程序 清单 : codes\09\9.3\Singleton\SingletonTestjava 
class Singleton 
{ 
// 使 用 一 个 变量 来 缓存 曾经 创建 的 实例 
private static Singleton instance; 
// 将 构造 器 使 用 private 修饰 ， 隐 藏 该 构造 器 
private Singleton(){} 
// 提 供 一 个 静态 方法 ， 用 于 返回 Singleton 实例 
// 该 方法 可 以 加 入 自 定义 的 控制 ， 保 证 只 产生 一 个 Singleton 对 银 
Public static Singleton getInstance() 
{ 
/7 如 果 instance 为 null， 表 明 还 不 曾 创建 Singleton 对 象 
// 如 果 instance 不 为 null， 则 表明 已 经 创建 了 Singleton 对 象 ， 将 不 会 执行 该 方法 
if (instance 一 null) 
{ 


// 创 建 一 个 Singleton 对 象 ， A 
instance = new Singleton() 
} 
return instance; 
} 
} 
public class SingletonTest 


{ 
public static void main(String[] args) 


// 创 建 Singleton 对 象 不 能 通过 构造 器 ， 只 能 通过 getInstance 方法 
Singleton sl = Singleton.getInstance(); 
Singleton s2 = Singleton.getInstance(); 


// 将 输出 true 
System.out .println(sl == s2); 


} 
} 


上 面 的 程序 中 第 一 行 粗 体 字 代码 使 用 了 一 个 静态 属性 来 保存 已 创建 的 Singleton 实例 , 程序 第 二 段 
粗 体 字 代码 用 于 判断 系统 是 否 已 经 创建 过 Singleton 实例 一 一 如 果 已 经 创建 过 Singleton 实例 ， 则 直接 
返回 该 Singleton 实例 即 可 。 

正 是 通过 上 面 第 二 段 粗 体 字 代 码 提供 的 控制 逻辑 ， 从 而 保证 了 Singleton 类 只 能 产生 一 个 实例 。 所 
以 在 TestSingleton 类 的 main 方法 中 看 到 两 次 产生 的 Singleton 对 象 实际 上 是 同一 个 对 象 。 

在 Java EE 应 用 中 ， 单 例 模式 是 一 种 应 用 非常 广泛 的 设计 模式 ， 应 用 中 许多 组 件 都 只 需要 单个 实 
例 ， 下 面 介绍 的 工厂 模式 里 的 工厂 也 只 需要 单个 实例 …… 

使 用 单 例 模式 主要 有 如 下 两 个 优势 : 

> ”减少 创建 Java 实例 所 带 来 的 系统 开销 。 

> ”便于 系统 跟踪 单个 Java 实例 的 生命 周期 、 实 例 状态 等 。 


>>9.3.2 简单 工厂 


对 于 一 个 典型 的 Java 应 用 而 言 ， 应 用 之 中 各 实例 之 间 存 在 复杂 的 调用 关系 (Spring 把 这 种 调用 关 
系 称 为 依赖 关系 ， 例 如 A 实例 调用 B 实例 的 方法 ， 则 称 为 A 依赖 于 B)。 

当 A 对 象 需要 调用 B 对 象 的 方法 时 ， 许 多 初学 者 会 选择 使 用 new 关键 字 来 创建 一 个 B 实例 ， 然 
后 调用 B 实例 的 方法 。 从 语法 的 角度 来 看 ， 这 种 做 法 没有 任何 问题 ， 这 种 做 法 的 坏处 在 于 : A 类 的 方 
法 实现 直接 调用 了 B 类 的 类 名 〈 这 种 方式 也 被 称 为 硬 编码 耦合 )， 一 旦 系统 需要 重 构 ， 需 要 使 用 C 类 
来 代替 B 类 时 , 程序 不 得 不 改写 A 类 代码 。 如 果 应 用 中 有 100 个 或 10000 个 类 以 硬 编码 方式 耦合 了 B 
类 ， 则 需要 重新 改写 100 个 、10000 个 地 方 …… 这 显然 是 一 种 非常 可 怕 的 事情 。 

换 一 个 角度 来 看 这 个 问题 : 对 于 A 对 象 而 言 ， 它 只 需要 调用 B 对 象 的 方法 ， 并 不 是 关心 B 对 象 
的 实现 、 创 建 过 程 。 考 虑 让 B 类 实现 一 个 IB 接口 , 而 A 类 只 需要 IB 接口 耦合 一 一 A 类 并 不 直接 使 用 
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new 关键 字 来 创建 B 实例 ， 而 是 重新 定义 一 个 工厂 类 : IBFactory， 由 该 工厂 类 来 负责 创建 IB 实例 ; 
而 A 类 通过 调用 IBFactory 工厂 的 方法 来 得 到 I[B 的 实例 。 

通过 改 用 上 面 设计 ， 则 A 类 需要 与 IBFactory 耦合 ， 还 需要 与 IB 接口 耦合 ， 如 果 系 统 需 要 重 构 ; 
需要 使 用 C 类 代替 B 类 ， 则 只 需要 让 C 类 也 实现 IB 接口 ， 并 改写 IBFactory 工厂 中 创建 IB 实例 的 实 
现代 码 ， 让 该 工厂 产生 C〈 实 现 了 IB 接口 ) 实例 即 可 。 由 于 所 有 依赖 IB 实例 的 对 象 都 是 通过 工厂 来 
获取 IB 实例 的 ， 所 以 它们 都 将 改 为 获得 C 实例 ， 这 就 完成 了 系统 重 构 。 

这 种 将 多 个 类 对 象 交 给 工厂 类 来 生成 的 设计 方式 被 称 为 简单 工厂 模式 。 

下 面 以 一 个 简单 的 场景 来 介绍 简单 工厂 模式 ,假设 程序 中 有 个 Computer 对 象 需要 依赖 一 个 输出 设 
备 ， 现 在 有 两 个 选择 : 直接 让 Computer 对 象 依赖 一 个 Printer (实现 类 ) 对 象 ， 或 者 让 Computer 依赖 
一 个 Output (接口 ) 属性 。 

在 这 种 应 用 场景 下 ， 使 用 简单 工厂 模式 可 以 让 系统 具有 更 好 的 可 维护 性 、 可 扩展 性 。 根 据 工 厂 模 
式 , 程序 应 该 让 Computer 依赖 一 个 Output 属性 , 将 Computer 类 与 Printer 实现 类 分 离开 来 。Computer 
对 象 只 需 面向 Output 接口 编程 即 可 ， 而 Computer 具体 依赖 于 Output 的 哪个 实现 类 则 完全 透明 。 

下 面 是 这 个 Computer 类 定义 的 代码 。 

程序 清单 : codes\09\9.3\SimpleFactory\Computer.java 


public class Computer 
{ 
Private Output out; 
Public Computer (Output out) 
{ 


this.out = out; 


} 
// 定 义 一 个 模拟 获取 字符 申 输入 的 方法 
public void keyIn(String msg) 
{ 

out.getData (msg); 


】} 

/7 定义 一 个 模拟 打印 的 方法 

public void print() 

{ 
out.out(); 

上 

public static void main{(String[] args) 

{ 
// 创 建 OutputFactory 
OutputFactory of = new OutputFactory(); 
// 将 Output 对 象 传 入 ， 创 建 Computer 对 象 
Computer c = new Computer (of.getOutput()); 
c.keyIn(" 轻 量 级 Java EE 企业 应 用 实战 ") ; 
cvkeyIn(" 疯 狂 Java 讲义 ") 
Ceprint (); 

} 

} 


从 上 面 粗 体 字 代码 可 以 看 出 ， 该 Computer 类 已 经 完全 与 Output 实现 类 分 离 了 ， 它 只 与 该 接口 耦 
合 。 而 且 ， Computer 不 再 负责 创建 Output 对 象 ， 系 统 将 提供 一 个 Output 工厂 来 负责 生成 Output 对 象 。 
这 个 OutputFactory 工厂 类 代码 如 下 。 

程序 清单 :codes\09\9.3\SimpleFactory\OutputFactoryjava 

public class OutputFactory 

人 Output getOutpout () 


7// 下 面 两 行 代码 用 于 控制 系统 到 底 使 用 Output 的 哪个 实现 类 
return new Printer(); 
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在 该 OutputFactory 类 中 包含 了 一 个 getOutput 方法 ， 该 方法 返回 一 个 Output 实现 类 的 实例 ， 该 方 
法 负责 创建 Output 实例 , 具体 创建 哪 一 个 实现 类 的 对 象 由 该 方法 决定 , 具体 由 该 方法 中 粗 体 部 分 控制 ， 
当然 也 可 以 增加 更 复杂 的 控制 逻辑 。 程 序 中 粗 体 字 代 码 创建 了 一 个 Printer 对 象 ，Printer 类 代码 如 下 。 
程序 清单 : codes\09\9.3\SimpleFactory\Printerjava 
// 让 Printer 类 实现 Output 
public class Printer implements Output 
: private String[] printData ~ new String[MAX_CACHE_ LINE]; 
// 用 以 记录 当前 需 打印 的 作业 数 
private int dataNum = 0; 
public void out() 
{ 
// 只 要 还 有 作业 ， 继 续 打印 
while (dataNum > 0) 
System.out.println(" 打 印 机 打印 , " + printData[l0]); 
// 把 作业 队列 整体 前 移 一 位 ， 并 将 剩 下 的 作业 数 减 1 


System.arraycopy (printData , 1, printData, 0, --dataNum); 
了 


} 
public void getData (String msg) 
人 
if (dataNum >= MAX_CACHE_LINE) 


System.out .println ("输出 队列 已 满 ,添加 失败 ") ; 


else 


// 把 打印 数据 添加 到 队列 里 ， 己 保存 数据 的 数量 加 1。 


PrintData[dataNum++] = msg; 


) 


上 面 的 Printer 类 模拟 了 一 个 简单 的 打印 机 ， 如 果 系 统 需要 重 构 ， 需 要 使 用 BetterPrinter 来 代替 
Printer 类 , 则 只 需要 让 BetterPrinter 实现 Output 接口 , 并 改写 OutputFactory 类 的 getOutput() 方 法 即 可 。 
下 面 是 BetterPrinter 实现 类 的 代码 。BetterPrinter 只 是 对 原 有 的 Printer 进行 简单 修改 ， 以 模拟 系统 
重 构 后 的 改进 。 
程序 清单 ，codes\09\9.3\SimpleFactory\BetterPrinterjava 
public class BetterPrinter implements Output 


private String[] printData = new String[MAX_CACHE LINE * 2]; 
// 用 以 记录 当前 需 打 印 的 作业 数 

private int dataNum = 0; 

public void out() 


{ 
// 只 要 还 有 作业 ， 继 续 打印 
while (dataNum > 0) > DN 
System. out .println ("高 速 打印 机 正在 打印 : ”+ printData[0])z 
// 把 作业 队列 整体 前 移 一 位 ， 并 将 剩 下 的 作业 数 减 1 Se ’ 
System.arraycopy (printData , 1, printData, 0, --dataNum); 
} By 9 


} 
public void getData(String msg) 
{ 
if (dataNum >= MAX_CACHE_LINE * 2) 


{ 
System.out .println ("输出 队列 已 满 ， 添 加 失败 "); 
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9 


7/ 把 打印 数据 添加 到 队列 里 ， 已 保存 数据 的 数量 加 1- 
PrintData[dataNum+t+] = msg; 


i 

} 

上 面 的 程序 中 BetterPrinter 类 与 Printer 并 无 太 大 区 别 ,仅仅 略微 改变 了 Printer 实现 , 量 BetterPrinter 
也 实现 了 Output 接口 ， 因 此 也 可 当成 Output 对 象 使 用 ， 于 是 我 们 只 要 把 OutputFactory 工厂 类 的 
getOutput() 方 法 中 粗 体 部 分 改 为 如 下 代码 : 

return new BetterPrinter(); 

再 次 运行 前 面 的 Computerjava 程序 ， 发 现 Computer 所 依赖 的 Output 对 象 已 改 为 BetterPrinter 对 
象 ， 而 不 再 是 原来 的 Printer 对 象 。 

通过 这 种 方式 ， 我 们 把 所 有 生成 Output 对 象 的 逻辑 集中 在 OutputFactory 工厂 类 中 管理 ， 而 所 有 
需要 使 用 Output 对 象 的 类 只 需 与 Output 接口 耦合 ， 而 不 是 与 具体 的 实现 类 耦合 。 即 使 系统 中 有 很 多 
类 依赖 了 Printer 对 象 ， 只 要 OutputFactory 类 的 getOutput0 方 法 返回 BetterPrinter 对 象 ， 则 它们 全 部 将 
会 改 为 依赖 BetterPrinter 对 象 , 而 其 他 程序 无 须 修改 , 只 需要 修改 OutputFactory 工厂 的 getOutput 的 方 
法 实现 即 可 。 

使 用 简单 工厂 模式 的 优势 是 ， 让 对 象 的 调用 者 和 对 象 创建 过 程 分 离 ， 当 对 象 调用 者 需要 对 象 时 ， 
直接 向 工厂 请 求 即 可 。 从 而 避免 了 对 象 的 调用 者 与 对 象 的 实现 类 以 硬 编码 方式 耦合 ， 以 提高 系统 的 可 
维护 性 、 可 扩展 性 。 工 厂 模式 也 有 一 个 小 小 的 缺陷 ， 当 产品 修改 时 ， 工 厂 类 也 要 做 相应 的 修改 。 

对 Spring 容器 而 言 ， 它 首先 是 一 个 巨大 的 工厂 ， 它 负责 创建 所 有 Bean 实例 ， 整 个 应 用 的 所 有 组 
件 都 由 Spring 容器 负责 创建 。 不 仅 如 此 ，Spring 容器 扩展 了 这 种 简单 工厂 模式 ， 它 还 可 以 管理 Bean 
实例 之 间 的 依赖 关系 ;， 而且， 如 果 容器 中 Bean 实例 具有 singleton 行为 特征 ， 则 Spring 容器 还 会 缓存 
该 Bean 实例 ,从 而 保证 程序 通过 Spring 工厂 来 获取 该 Bean 实例 时 , Spring 工厂 将 会 返回 同一 个 Bean 
实例 。 

下 面 的 示例 提供 一 份 类 似 于 Spring 配置 文件 的 XML 文件 ， 程 序 提供 一 个 扩展 的 工厂 类 ， 该 工厂 
类 也 可 提供 类 似 于 Spring IoC 容器 的 功能 。 

程序 清单 : codes\09\9.3\loC\bean.xml 


<?xml version="1.0" encoding="GBK"?> 
<beans> 
<bean id="computer" class="lee.Computer"> 
<!-- 为 name 属性 注入 普通 属性 值 --> 
<property name="name" value=" 李 刚 的 电脑 "/> 
<!-- 为 out 属性 注入 普通 属性 值 --> 
<property name="out" ref="betterPprinter"/> 


<!-~ 配置 两 个 Bean 实例 --> 
<bean id="printer" class="lee.Printer"/> 
<bean td="betterPrintern class="lee.BetterPrinter"/> 
<!-- 配置 一 个 Prototype 行为 的 Bean 实例 --> 
<bean id="now" class="java.util.Date" scope="prototype"/> <!--@--> 
</beans> 
细心 的 读者 可 能 已 经 发 现 :该 配置 文件 和 Spring 配置 文件 如 此 相似 。 实 际 上 ， 笔 者 只 是 简单 修改 
了 Spring 配置 文件 。 上 面 的 配置 文件 一 样 配置 了 computer Bean， 且 为 该 Bean 依赖 注入 了 2 个 属性 : 
name 和 out。 除 此 之 外 ， 上 面 的 配置 文件 中 @ 号 代码 处 还 配置 了 一 个 prototype 行为 的 Bean 实例 。 
本 程序 中 也 提供 了 一 个 简化 的 ApplicationContext 接口 ， 该 接口 仅 包含 一 个 getBean() 方 法 。 
程序 清单 : codes\09\9.3\lJoC\src\org\crazyit\ioc\ApplicationContext.java 
Public interface ApplicationContext 
// 获 取 指 定 Bean 实例 的 方法 
Object getBean (String name) 
throws Exceptiony 
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} 


本 示例 将 为 该 接口 提供 一 个 简单 的 实现 类 ， 该 实现 类 就 是 一 个 功能 强大 的 工厂 。 它 使 用 Dom4j 
来 解析 XML 配置 文件 ， 并 根据 配置 文件 来 创建 工厂 中 的 Bean 实例 。 下 面 是 该 实现 类 的 代码 。 
程序 清单 : codes\09\9.3\loC\src\org\crazyitiioc\YeekuXmlApplicationContextjava 


Public class YeekuxmlApplicationContext 
implements ApplicationContext 


// 保 存 容器 中 所 有 单 例 模式 的 Bean 实例 
private Map<String , Object> objPool 
= Collections. synchronizedMap (new HashMap<String , Object>()); 
// 保 存 配置 文件 对 应 的 Document 对 象 
private Document doc; 
/ /保存 配 置 文件 里 的 根 元 素 
Private Element root; 
public YeekuxmlApplicationContext (String filePath) 
throws Exception 


{ 


{ 
SAXReader reader = new SAXReader(); 
doc = reader.read(new File(filePath)); 
root = doc.getRootElement (); 
initPool (); 
initProp(); 
} 
public object getBean (String name) 
throws Exception 
{ 
Object target = objPool.get(name); 
// 对 于 singleton Bean， 容 器 已 经 初始 化 了 所 有 Bean 实例 
if (target.getClass() != String.class) 
{ 


} 
else 
{ 


return target; 


String clazz = (String)target; 
// 对 于 prototype 并 未 注入 属性 值 


return Class.forName (clazz) .newInstance(); 


} 

// 初 始 化 容器 中 所 有 singleton Bean 

private void initPool () 
throws Exception 


7/ 遍历 配置 文件 里 的 每 个 <cbean. . . /> 元 素 
for (Object obj : root.elements()) 


{ 


{ 


Element beanEle ~ (Element)obj; 
// 取 得 <bean. . . /> 元 素 的 id 属性 
String beanId = beanEle.attributeValue ("id"); 


// 取 得 <bean. . . /> 元 素 的 class 属性 ; 
String beanClazz = beanEle.attributeValue ("class"); 
// 取 得 <bean. . . /> 元 素 的 scope 属性 
String beanscope = beanEle.attributeValue ("scope"); 
// 如 果 <bean. . . /> 元 素 的 scope 属性 不 存在 ， 或 为 singleton 
if (beanScope == null J1 

beanscope.equals ("singleton"))} 


// 以 默认 构造 器 创建 Bean 实例 ， 并 将 其 放 入 objPool 中 
objPool.put (beanId , Class.forName (beanClazz) .newInstance()); 


{ 


} 
else 
{ 


// 对 于 非 singlton Bean。 存放 该 Bean 实现 类 的 类 名 。 
objPool.put (beanId , beanclazz); 
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上 


} 
7/ 初 始 化 容器 中 singleton Bean 的 属性 
Private void initProp () 

throws Exception 


7/ 遍历 配置 文件 里 的 每 个 <bean .  - /> 元 素 
for (Object obj : root.elements()) 
{ 


{ 


Element beanEle = (Element)obj; 


// 取 得 <bean. . ./> 元 素 的 id 属性 
String beanId = beanEle.attributeValue ("id"); 
// 取 得 <bean: . ./> 元 素 的 scope 属性 
String beanScope = beanEle.attributeValue ("scope"); 
// 如 果 <bean. . . /> 元 素 的 scope 属性 不 存在 ， 或 为 singleton 
if (beanscope == null || 

beanscope.equals ("singleton")) 


7/ 取 出 objPool 的 指定 的 Bean 实例 

Object bean = objPool.get (beanId); 

// 遍 历 <bean . . . /> 元 素 的 每 个 <property.,../> 子 元 素 
for (Object prop : beanEle.elements()) 

{ 


{ 


Element propEle = (Element)prop; 
// 取 得 <property... /> 元素 的 name 属性 
String propName = propEle.attributeValue("name"); 
7/ 取 得 <property, . . /> 元 素 的 value 属性 
String propValue = propEle.attributeValue("value"); 
// 取 得 <property. . . /> 元 素 的 ref 属性 
String propRef = propEle.attributeValue ("ref"); 
// 将 属性 名 的 首 字母 大 写 
String propNameCamelize = propName.substring(0 ，1)，toUpper- 
Case() 

+ propName.substring(1 , propName.length()); 
// 如 果 <property.. . /> 元素 的 value 属性 值 存在 
if (propValue != null &6 propValue.length() > 0) 


{ 
// 获 取 设 值 注入 所 需 的 setter 方法 
Method setter = bean.getClass() .getMethod( 
"set" + propNameCamelize , String.class); 
// 执 行 setter 注入 
setter.invoke(bean , propValue); 


} 
if (propRef != null && propRef.length() > 0) 
{ 


// 取 得 需要 被 依赖 注入 的 Bean 实例 
Object target = objPool.get (propRef); 
//objPool 池 中 不 存在 指定 Bean 实例 
if (target == null) 
{ 
// 此 处 还 应 处 理 Singleton Bean 依赖 prototype Bean 的 情形 


} 

// 定 义 设 值 注入 所 需 的 setter 方法 

Method setter = null; 

// 遍 历 target 对 象 所 所 实现 的 所 有 接口 
for (Class superInterface : target.getCclass().get- 
Interfaces()) 

{ 


try 
{ 
// 获 取 设 值 注入 所 需 的 setter 方法 
setter = bean.getClass() ;getMethod( 
"set" + propNameCamelize , 
superIinterface)s 


// 如 果 成 功 取得 该 接口 对 应 的 方法 ， 直 接 跳出 循环 


break; 
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catch (NoSuchMethodException ex) 


{ 
// 如 果 没有 找到 对 应 的 setter 方法 ， 继 续 下 次 循环 
continue; 
} 
} 
// 如 果 setter 方法 依然 为 nu11, 
// 则 直接 取得 target 实现 类 对 应 的 setter 方法 
if (setter == null) 
{ 
setter = bean.getClass() .getMethod( 
"set" + propNameCamelize , target. 
getClass()); 


} 
// 执 行 setter 注入 
setter.invoke (bean , target); 


上 
} 


上 面 的 YeekuXmlApplicationContext 类 是 一 个 功能 强大 的 工厂 类 , 它 根据 XML 配置 文件 创建 Bean 
实例 ， 程 序 需要 Bean 实例 时 只 需 调用 该 工厂 类 的 getBean() 方 法 即 可 。 
上 面 的 YeekuXmlApplicationContext 类 当然 不 能 与 Spring 的 ApplicationContext 实现 类 相 比 , 该 容 
器 类 仅仅 实现 了 简单 的 IoC 功能， 而 且 并 未 为 prototype 行为 的 Bean 的 属性 提供 依赖 注入 功能 。 读 者 
可 以 通过 该 工厂 类 大 致 了 解 Spring 底层 的 实现 原理 。 
下 面 是 测试 该 工厂 类 的 主 类 。 
程序 清单 : codes\09\9.3\oC\src\lee\loCTestjava 
Public class ToCTest 


Public static void main(String[] args) 
throws Exception 


// 创 建 IToc 容器 
ApplicationContext ctx = 
new YeekuxmlApplicationContext ("bean. xml") ; 
// 从 Ioc 容器 中 取出 computer Bean 
Computer c = (Computer)ctx.getBean("computer"); 
// 测 试 Computer 对 象 
c.keyIn (" 轻 量 级 Java EE 企业 应 用 实战 ") ; 
c.keyIn ("疯狂 Java 讲义 ") ; 
c.print ()? 
System.out.println (otx.getBean ("now") ) 7 


{ 


} 
} 


从 上 面 程序 中 的 粗 体 字 代 码 可 以 看 出 ， 本 程序 的 IoC 容器 具有 和 Spring 容器 类 似 的 功能 ， 同 样 可 
以 创建 并 管理 容器 中 所 有 的 Bean 实例 。 

与 简单 工厂 模式 类 似 的 还 有 工厂 方法 和 抽象 工厂 模式 ， 下 面 将 进一步 讲解 工厂 方式 和 抽象 工厂 模 
式 的 设计 方式 。 
>>》9.3.3 工厂 方法 和 抽象 工厂 


在 简单 工厂 模式 里 ， 系 统 使 用 ProductFactory 工厂 类 生产 所 有 产品 实例 ， 且 该 工厂 类 决定 生产 哪 
个 类 的 实例 ， 即 该 工厂 类 负责 所 有 的 逻辑 判断 、 实 例 创建 等 工作 。 

如 果 我 们 不 想 在 工厂 类 中 进行 逻辑 判断 ， 程 序 可 以 为 不 同 产品 类 提供 不 同 的 工厂 ， 不 同 的 工厂 类 
生产 不 同 的 产品 .例如 我 们 为 上 面 的 Printer、BetterPrinter 分 别提 供 PrinterFactory 和 BetterPrinterFactory 
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六 说 


工厂 类 ， 这 就 无 须 在 工厂 类 进行 复杂 的 逻辑 判断 。 
本 示例 应 用 将 OutputFactory 改 为 一 个 接口 ， 并 为 该 接口 提供 两 个 实现 类 : PrinterFactoryjava 和 
BetterPrinterFactory.java。 下 面 是 OutputFactory 接口 的 代码 。 
程序 清单 : codes\09\9.3\FactoryMethod\OutputFactory.java 
public interface OutputFactory 
{ 
// 仅 定义 一 个 方法 用 于 返回 输出 设备 。 
Output getoutput(); 
} 
上 面 的 OutputFactory 只 是 一 个 接口 ， 该 接口 提供 了 一 个 getOutput0 方 法 ,该 方法 可 直接 返回 一 个 
输出 设备 。 
下 面 为 OutputFactory 接口 提供 一 个 PrinterFactory 实现 类 ， 该 实现 类 专门 负责 生成 Printer 实例 。 
程序 清单 :codes\09\9.3\FactoryMethod\PrinterFactory.java 


public class PrinterFactory 
implements OutputFactory 
{ 
public Output getoutput () 


{ 
// 访 工厂 只 负责 产生 Printer 对 象 
return new Printer(); 
} 
} 
上 面 的 PrinterFactory 实现 了 OutputFactory 接口 ， 并 实现 了 该 接口 里 的 getOutput0 方 法 ， 该 方法 
直接 返回 一 个 简单 的 Printer 对 象 ， 如 上 面 的 粗 体 字 代码 所 示 。 
下 面 再 为 OutputFactory 接口 提供 一 个 BetterPrinterFactory 实现 类 ， 该 实现 类 专门 负责 生成 
BetterPrinter 实例 。 
程序 清单 :codes\09\9.3\FactoryMethod\BetterPrinterFactory.java 


public class BetterprinterFactory 
implements OutputFactory 


{ 
public Output getOutput () 
{ 


// 该 工厂 只 负责 产生 BetterPrinter 对 象 
return new BetterPrinter(); 
} 
1 


本 示例 应 用 中 各 类 之 间 的 类 图 如 图 9.2 所 示 。 
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图 9.2 工厂 方法 中 各 类 的 类 图 
当 使 用 工厂 方法 设计 模式 时 ， 对 象 调用 者 需要 与 具体 的 工厂 类 耦合 ， 当 需要 不 同 对 象 时 ， 程 序 需 
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要 调用 相应 工厂 对 象 的 方法 来 得 到 所 需 的 对 象 。 如 下 是 Computer 类 中 创建 Output 对 象 并 调用 该 对 象 
方法 的 代码 。 
程序 清单 :codes\09\9.3\FactoryMethod\Computerjava 
public class Computer 
l private Output out; 
public Computer (Output out) 
: this.out = out; 


} 
// 定 义 一 个 模拟 获取 字符 串 输入 的 方法 
public void keyIn(String msg) 
{ 

out .getDatatmsg) 


} 

// 定 义 一 个 模拟 打印 的 方法 

public void print() 

{ 
out.out{()7 

} 

public static void main(String[] args) 

{ 
// 使 用 PrinterFactory 子 类 来 创建 OutputFactory 
OutputFactory of = new PrinterFactory(); 
// 将 Output 对 象 传 入 ， 创 建 Computer 对 象 
Computer c = new Computer (of.getOutput ()); 
c,keyIn (" 轻 最 级 Java EE 企业 应 用 实战 ") 7 
c.keyIn(" 疯 狂 Java 讲义 ") 
cprint ()7 

) 

} 


正如 程序 中 的 粗 体 字 代码 所 示 ， 当 客户 端 代码 需要 调用 Ouput 对 象 的 方法 时 ， 为 了 得 到 不 同 的 
Output 实例 ， 程 序 必须 显 式 创建 不 同 的 OutputFactory 实例 ， 程 序 中 创建 的 是 PrinterFactory 实例 。 

从 上 面 的 代码 可 以 看 出 ， 对 于 采用 工厂 方法 的 设计 架构 ， 客 户 端 代码 成 功 与 被 调用 对 象 的 实现 类 
分 离 ， 但 带 来 了 另 一 种 耦合 : 客户 端 代码 与 不 同 的 工厂 类 耦合 。 这 依然 是 一 个 问题 ! 

为 了 解决 客户 端 代码 与 不 同 工 厂 类 耦合 的 问题 ， 接 着 考虑 再 增加 一 个 工厂 类 ， 该 工厂 类 不 是 生产 
Output 对 象 ， 而 是 生产 OutputFactory 实例 一 一 简 而 言 之 ， 这 个 工厂 类 不 制造 具体 的 被 调用 对 象 ， 而 是 
制造 不 同 工 厂 对 象 。 这 个 特殊 的 工厂 类 被 称呼 抽象 工厂 类 ， 这 种 设计 方式 也 被 称 为 抽象 工厂 模式 。 如 
图 9.3 所 示 是 抽象 工厂 模式 示例 的 UML 类 图 。 
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图 9.3 抽象 工厂 模式 的 UML 类 图 


从 图 9.3 中 可 以 看 出 ， 在 这 种 模式 下 系统 新 增 了 一 个 OutputFactoryFactory 工厂 类 ， 该 工厂 类 提供 
了 一 个 getOutputFactory(String type) 方 法 ， 该 方法 用 于 返回 一 个 OutputFactory 工厂 实例 。 下 面 是 该 抽 
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象 工厂 类 的 代码 。 
程序 清单 : codes\09\9.3\AbstractFactory\OutputFactoryFactoryjava 
public class OutputFactoryFactory 


// 仅 定义 一 个 方法 用 于 返回 输出 设备 。 
public static OutputFactory getOutputFactory{ 
String type) 
{ 
if (type.equalsIgnoreCase ("better")) 
人 
return new BetterpPrinterFactory() 7 


else 
用 
return new PrinterFactory(); 
} 
上 
} 


从 上 面 的 粗 体 字 代 码 中 可 以 看 出 , 抽象 工厂 根据 type 参数 进行 判断 , 决定 需要 生成 哪 种 工厂 实例 。 
通过 这 种 设计 模式 ， 就 可 让 客户 端 程序 只 需 与 抽象 工厂 类 耦合 。 下 面 是 客户 端 调 用 被 调用 者 对 象 方法 
的 主 方法 。 

程序 清单 :codes\09\9.3\AbstractFactory\Computerjava 


public static void main(String[] args) 
{ 
// 使 用 PrinterFactory 子 类 来 创建 OutputFactory 
OutputFactory of = OutputFactoryFactory 
,getOutputFactory ("better") ; 
// 将 Output 对 象 传 入 ， 创 建 Computer 对 象 
Computer c = new Computer (of.getOutput ()); 
c.keyIn (" 轻 量 级 Java EE 企业 应 用 实战 ") ; 
c.keyIn ("疯狂 Java 讲义 "); 
cprint (); 


} 

上 面 程序 中 的 粗 体 字 代码 用 于 产生 一 个 OutputFactory 工厂 ， 但 具体 产生 哪个 工厂 则 由 
OutputFactoryFactory 抽象 工厂 决定 , 不 同 的 工厂 对 象 将 产生 不 同 的 Output 对 象 。 通 过 采用 抽象 工厂 的 
设计 模式 ， 系 统 可 以 让 客户 端 代码 与 被 调用 对 象 的 实现 类 、 具 体 的 工厂 类 分 离 。 

读者 掌握 了 这 种 抽象 工厂 模式 后 ， 应 该 对 Spring IoC 容器 感到 迷惑 : 它 到 底 是 简单 工厂 ? 还 是 抽 
象 工厂 ? 实际 上 , 笔者 倾向 于 认为 Spring IoC 容器 是 抽象 工厂 ,因为 Sping IoC 容器 可 以 包括 万 象 , 它 
不 仅 可 以 管理 普通 Bean 实例 ， 也 可 管理 工厂 实例 。 

很 多 时 候 ， 笔 者 不 喜欢 纠缠 于 简单 工厂 模式 、 抽 象 工厂 模式 这 些 概念 ， 笔 者 喜欢 把 它们 统称 为 工 
厂 模式 。 如 果 工 厂 直接 生产 被 调用 对 象 ， 那 就 是 简单 工厂 模式 ;如 果 工 厂 生产 了 工厂 对 象 ， 那 就 会 升 
级 成 抽象 工厂 模式 。 


和 9.3.4 代理 模式 


代理 模式 是 一 种 应 用 非常 广泛 的 设计 模式 ， 当 客户 端 代码 需要 调用 某 个 对 象 时 ， 客 户 端 实际 上 也 
不 关心 是 否 准确 得 到 该 对 象 ， 它 只 要 一 个 能 提供 该 功能 的 对 象 即 可 ， 此 时 我 们 就 可 返回 该 对 象 的 代理 
(Proxy)。 

在 这 种 设计 方式 下 ， 系 统 会 为 某 个 对 象 提供 一 个 代理 对 象 ， 并 由 代理 对 象 控制 对 源 对 象 的 引用 。 
代理 就 是 一 个 Java 对 象 代表 另 一 个 Java 对 象 来 采取 行动 。 在 某 些 情况 下 ， 客 户 端 代码 不 想 或 不 能 够 
直接 调用 被 调用 者 ， 代 理 对 象 可 以 在 客户 和 目标 对 象 之 问 起 到 中 介 的 作用 。 

对 客户 端 而 言 ， 它 不 能 分 辨 出 代理 对 象 与 真实 对 象 的 区 别 ， 它 也 无 须 分 辨 代理 对 象 和 真实 对 象 的 
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区 别 。 客 户 端 代码 并 不 知道 真正 的 被 代理 对 象 ， 客 户 端 代码 面向 接口 编程 ， 它 仅仅 持 有 一 个 被 代理 对 
象 的 接口 。 

总 而 言 之 ， 只 要 客户 端 代码 不 能 或 不 想 直 接 访问 被 调用 对 象 一 一 这 种 情况 有 很 多 原因 ， 比 如 需要 
创建 一 个 系统 开销 很 大 的 对 象 ， 或 者 被 调用 对 象 在 远程 主机 上 ， 或 者 目标 对 象 的 功能 还 不 足以 满足 需 
求 ……， 而 是 额外 创建 一 个 代理 对 象 返 回 给 客户 端 使 用 ， 那 么 这 种 设计 方式 就 是 代理 模式 。 

下 面 示范 一 个 简单 的 代理 模式 , 程序 首先 提供 了 一 个 Image 接口 , 代表 大 图 片 对 象 所 实现 的 接口 。 

程序 清单 : codes\09\9.3\Proxy\Image.java 


public interface Image 
{ 
void show(); 
} 
该 接口 提供 了 一 个 实现 类 , 该 实现 类 模拟 了 一 个 大 图 片 对 象 ,该 实现 类 的 构造 器 使 用 Thread.sleepO 
方法 来 暂停 3s。 下 面 是 该 BigImage 的 程序 代码 。 
程序 清单 ; codes\09\9.3\Proxy\BigImage.java 
// 使 用 该 BigImage 模拟 一 个 很 大 图 片 
public class BigImage implements Image 
{ 
public BigImage() 
{ 
try 
{ 
// 程 序 暂停 3s 模式 模拟 系统 开销 
Thread. sleep (3000) ; 
System.out .printlin ("图片 装载 成 功 ..."); 


} 
catch (InterruptedExcepti6n ex) 
{ 
ex.printstackTrace (); 
} 


} 
// 实 现 Image 里 的 show() 方 法 
public void show() 


{ 
i out .println(" 绘 制 实际 的 大 图 片 ") 7 
} 
上 面 程序 的 粗 体 字 代 码 暂 停 了 3s， 这 表明 创建 一 个 BigImage 对 象 需要 3s 的 时 间 开 销 一 一 程序 使 
用 这 种 延迟 来 模拟 装载 此 图 片 所 导致 的 系统 开销 。 如 果 不 采 用 代理 模式 ， 当 程序 中 创建 BigImage 时 ， 
系统 将 会 产生 3s 的 延迟 。 为 了 避免 这 种 延迟 ， 程 序 为 BigImage 对 象 提 供 一 个 代理 对 象 ，BigImage 类 
的 代理 类 如 下 所 示 。 


程序 清单 : codes\09\9.3\Proxy\ImageProxy.java 
public class ImageProxy implements Image 


// 组 合 一 个 image 实例 ， 作 为 被 代理 的 对 象 
private Image image; 
// 使 用 抽象 实体 来 初始 化 代理 对 象 
Public ImageProxy(Image image) 
{ 
this.image = image; 
i 
* 重 写 Image 接口 的 show () 方 法 
* 该 方法 用 于 控制 对 被 代理 对 象 的 访问 ， 
2 


public void show() 
{ 
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条 9 


// 只 有 当真 正 需要 调用 image 的 show 方法 时 才 创建 被 代理 对 象 
if (image 一 null) 


image = new BigImage(); 


image.show() 7 
上 面 的 ImageProxy 代理 类 实现 了 与 BigImage 相同 的 show0 方 法 ， 这 使 得 客户 端 代码 获取 到 该 代 
理 对 象 之 后 ， 可 以 将 该 代理 对 象 当成 BigImage 来 使 用 。 
在 ImageProxy 类 的 show0 方 法 中 增加 了 粗 体 字 代码 的 控制 逻辑 , 这 段 控制 逻辑 用 于 控制 当 系统 真 
正 调用 image 的 showO 时 , 才 会 真正 创建 被 代理 的 BigImage 对 象 。 下 面 程序 需要 使 用 BigImage 对 象 ， 
但 程序 并 不 是 直接 返回 BigImage 实例 ， 而 是 先 返回 BigImage 的 代理 对 象 ， 如 下 面 的 程序 所 示 。 
程序 清单 : codes\09\9.3\Proxy\BiglmageTest.java 
public class BigImageTest 
public static void main(String[] args) 
long start = System,currentTimeMil1lis()7 
// 程 序 返回 一 个 Image 对 象 ， 该 对 象 只 是 BigImage 的 代理 对 象 
Inage = new (nol1) ; 
System.out .println ("系统 得 到 Image i 
{System.currentTimeMillis() -~ start)) 
// 只 有 当 实 际 调用 image 代理 的 show () 方法 时 ， 程序 才 会 真正 创建 被 代理 对 多。 
image .show() 7 
汪 肖 
上 面 的 程序 初始 化 image 非常 快 , 因为 程序 并 未 真正 创建 BigImage 对 象 , 只 是 得 到 了 ImageProxy 
代理 对 象 一 一 直到 程序 调用 image.show0 方 法 时 ， 程 序 需 要 真正 调用 BigImage 对 象 的 show0 方 法 , 程 
序 此 时 才 真 正 创建 BigImage 对 象 。 运 行 上 面 程序 ， 看 到 如 图 9.4 所 示 的 结果 。 
看 到 如 图 9.4 所 示 的 运行 结果 ， 读 者 应 该 能 认同 : 使 用 代理 模式 提高 了 获取 Image 对 象 的 系统 性 
能 。 但 可 能 有 读者 会 提出 疑问 : 程序 调用 ImageProxy 对 象 的 show0 方 法 时 一 样 需 要 创建 BigImage 对 
象 啊 ， 系 统 开销 并 未 真正 减少 啊 ? 只 是 这 种 系统 开销 延迟 了 而 已 ? 


图 9.4 使 用 代理 模式 提高 性 能 


我 们 可 以 从 如 下 两 个 角度 来 回答 这 个 问题 : 
> ”把 创建 Biglmage 推迟 到 真正 需要 它 时 才 创 建 ， 这 样 能 保证 前 面 程序 运行 的 流畅 性 ， 而 且 能 
减少 Biglmage 在 内 存 中 的 存活 时 间 ， 从 宏观 上 节省 了 系统 的 内 存 开销 。 
> ”在 有 些 情况 下 ， 也 许 程序 永远 不 会 真正 调用 ImageProxy 对 象 的 show() 方 法 一 一 意味 着 系统 
根本 无 须 创建 Biglmage 对 象 。 在 这 种 情形 下 ,使 用 代理 模式 可 以 显著 地 提高 系统 运行 性 能 。 
第 二 种 情况 正 是 Hibernate 延迟 加 载 所 采用 的 设计 模式 ， 相 信 读 者 还 记得 前 面 介绍 Hibernate 关联 
映射 时 的 知识 ， 当 A 实体 和 B 实体 之 间 存 在 关联 关系 时 ，Hibernate 默认 启用 延迟 加 载 ， 当 系统 加 载 A 
实体 时 ，A 实体 关联 的 B 实体 并 未 被 加 载 出 来 ，A 实体 所 关联 的 B 实体 全 部 是 代理 对 象 一 一 只 有 等 到 
A 实体 真正 需要 访问 B 实体 时 ， 系 统 才 会 去 数据 库 里 抓 取 B 实体 所 对 应 的 记录 。 
Hibernate 的 延迟 加 载 充分 体现 了 代理 模式 的 优势 : 当 系统 加 载 A 实体 时 ， 也 许 只 需要 访问 A 实 
体 对 应 的 记录 ， 根 本 不 会 访问 A 的 关联 实体 。 如果 不 采用 代理 模式 ， 系 统 需要 在 加 载 A 实体 时 ,同时 
加 载 A 实体 的 所 有 关联 实体 一 一 这 是 多 么 大 的 系统 开销 啊 ! 
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除了 上 面 出 于 性 能 考虑 使 用 代理 模式 之 外 ， 代 理 模式 还 有 另 一 种 常用 场景 : 当 目标 对 象 的 功能 不 
足以 满足 客户 端 需 求 时 , 系统 可 以 为 该 对 象 创建 一 个 代理 对 象 , 而 代理 对 象 可 以 增强 原 目标 对 象 的 功能 。 
借助 于 Java 提供 的 Proxy 和 InvocationHandler， 可 以 实现 在 运行 时 生成 动态 代理 的 功能 ， 而 动态 
代理 对 象 就 可 作为 目标 对 象 使 用 ， 而 且 增 强 了 目标 对 象 的 功能 。 
由 于 JDK 动态 代理 只 能 创建 指定 接口 的 动态 代理 ， 所 以 下 面 先 提供 一 个 Dog 接口 ， 该 接口 代码 
非常 简单 ， 仅 仅 在 该 接口 里 定义 了 两 个 方法 。 
程序 清单 : codes\09\9.3\DynaProxy\Dog.java 
public interface Dog 
:| //info 方法 声明 
public void infotj7 
//run 方法 声明 
public void run(); 
} 


上 面 接口 里 只 是 简单 定义 了 两 个 方法 , 并 未 提供 方法 实现 。 下 面 程序 先 为 该 接口 提供 一 个 实现 类 ， 
该 实现 类 的 实例 将 会 作为 被 代理 的 目标 对 象 。 下 面 是 该 接口 实现 类 的 代码 。 
程序 清单 :codes\09\9.3\DynaProxy\GunDog.java 
public class GunDog implements Dog 
a 方法 实现 ， 仅 仅 打印 一 个 字符 惠 
public void infof) 


{ 
System.out .printlin ("我 是 一 只 猎狗 ") ; 


/全 方法 实现 ， 仅 仅 打印 一 个 字符 串 
public void run() 


{ 
System.out .println ("我 奔跑 迅速 ") ; 
} 
} 


上 面 的 代码 没有 丝毫 的 特别 之 处 ,该 Dog 的 实现 类 仅仅 为 每 个 方法 提供 了 一 个 简单 实现 。 现在 假 
设 该 目标 对 象 《GunDog) 实例 的 两 个 方法 不 能 满足 实际 需要 ， 因 此 客户 端 不 想 直 接 调用 该 目标 对 象 。 
假设 客户 端 需要 在 GunDog 为 两 个 方法 增加 事务 控制 : 在 目标 方法 被 调用 之 前 开始 事务 ， 在 目标 方法 
被 调用 之 后 结束 事务 。 
为 了 实现 该 功能 ， 我 们 可 以 为 GunDog 对 象 创建 一 个 代理 对 象 ， 该 代理 对 象 提供 与 GunDog 对 象 
相同 的 方法 ， 而 代理 对 象 增强 了 GunDog 对 象 的 功能 。 
下 面 先 提供 一 个 TxUtil 类 〈 这 个 类 通常 被 称 为 拦截 器 )， 该 类 里 包含 两 个 方法 ， 分 别 用 于 开始 事 
务 、 提 交 事 务 ， 下 面 是 TxUtil 类 的 源 代码 。 
程序 清单 :codes\09\9.3\DynaProxy\TxUtiljava 
public class TxUtil 


// 第 一 个 拦截 器 方法 :模拟 事务 开始 
public void beginTx() 


System.out .println ("====- 模 拟 开始 事务 -=") ; 


} 
// 第 二 个 拦截 器 方法 :模拟 事务 结束 
public void endTx() 


{ 
System.out .println ("===== 模 拟 结束 事务 =====") 7 


} 
} 


借助 于 Proxy 和 InvocationHandler 就 可 以 实现 : 当 程 序 调用 info0 方 法 和 run0 方 法 时 ， 系 统 可 以 
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“自动 ”将 beginTx0 和 endTx0 两 个 通用 方法 插入 info0 和 run0 方 法 执行 中 。 
JDK 动态 代理 的 关键 在 于 下 面 的 MyInvokationHandler 类 ， 该 类 是 一 个 InvocationHandler 实现 类 ， 
该 实现 类 的 invoke 方法 将 会 作为 代理 对 象 的 方法 实现 。 
程序 清单 : codes\09\9.3\DynaProxy\MyInvokationHandlerjava 
public class MyInvokationHandler 
implements InvocationHandler 


// 需 要 被 代理 的 对 象 

Private Object target; 

Public void setTarget (Object target) 
{ 


. 


this.target = target; 


} 
// 执 行动 态 代理 对 象 的 所 有 方法 时 ， 都 会 被 替换 成 执行 如 下 的 invoke 方法 
public Object invoke (Object proxy, Method method, Object[] args) 
throws Exception 
{ 
TXUtil tx = new TxUtil(); 
// 执 行 Tx0til 对 象 中 的 beginTx。 
tx.beginTx(); 
// 以 target 作为 主 调 来 执行 method 方法 
Object result = method.invoke (target , args); 
// 执 行 TxUtil 对 象 中 的 endTx。 
tx.endTx () ; 
return result; 
} 
} 


上 面 的 invoke0 方 法 将 会 作为 动态 代理 对 象 的 所 有 方法 的 实现 体 。 上 面 方法 中 第 一 行 粗 体 字 代码 
调用 了 开始 事务 的 方法 ， 第 二 行 粗 体 字 代 码 通 过 反射 回调 了 被 代理 对 象 的 目标 方法 ， 第 三 行 粗 体 字 代 
码 调用 了 结束 事务 的 方法 。 通 过 这 种 方式 ， 使 得 代理 对 象 的 方法 既 回 调 了 被 代理 对 象 的 方法 ， 并 为 被 
代理 对 象 的 方法 增加 了 事务 功能 。 

下 面 再 为 程序 提供 一 个 MyProxy Factory 类 ， 该 对 象 专 为 指定 的 target 生成 动态 代理 实例 。 

程序 清单 : codes\09\9.3\DynaProxy\MyProxyFactoryjava 

public class MyProxyFactory 
// 为 指定 target 生成 动态 代理 对 象 
public static Object getProxy(Object target) 
throws Exception 
// 创 建 一 个 MyInvokationHandler 对 象 
MyInvokationHandler handler = 
new MyInvokationHandler (); 
// 为 MyInvokationHandler 设置 target 对象 
handler.setTarget (target); 
// 创 建 、 并 返回 一 个 动态 代理 
return Proxy.newProxyInstance (target.getClass() .getClassLoader() 
, target.getClass() .getInterfaces(), handler); 
} 
} 

上 面 的 动态 代理 工厂 类 提供 了 一 个 getProxy 方法 ， 该 方法 为 target 对 象 生 成 一 个 动态 代理 对 象 ， 
这 个 动态 代理 对 象 与 target 实现 了 相同 的 接口 ， 所 以 具有 相同 的 public 方法 一 一 从 这 个 意义 上 来 看 ， 
动态 代理 对 象 可 以 当成 target 对 象 使 用 。 当 程序 调用 动态 代理 对 象 的 指定 方法 时 ， 实 际 上 将 变 为 执行 
MyInvokationHandler 对 象 的 invoke 方法 .例如 调用 动态 代理 对 象 的 info0 方 法 , 程序 将 开始 执行 invoke 
方法 ， 其 执行 步骤 如 下 : 

人 @ 创建 TxUtil 实例 。 
人 @ 执行 TxUtil 实例 的 beginTx0 方 法 。 
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人 @ 使 用 反射 以 target 作为 调用 者 执行 info0 方 法 。 

@ 执行 TxUtil 实例 的 endTx 0 方法 。 

看 到 上 面 的 执行 过 程 ， 读 者 应 该 已 经 发 现 : 当 我 们 使 用 动态 代理 对 象 来 代替 被 代理 对 象 时 ， 代 理 
对 象 的 方法 就 实现 了 前 面 的 要 求 : 程序 执行 info0、run0 方 法 时 增加 事务 功能 。 而 且 这 种 方式 有 一 个 
额外 的 好 处 : GunDog 的 方法 中 没有 以 硬 编码 的 方式 调用 beginTx0 和 endTx() 一 一 这 就 为 系统 扩展 增加 
了 无 限 可 能 性 ， 当 系统 需要 扩展 GunDog 实例 的 功能 时 ， 程 序 只 需要 提供 额外 的 拦截 器 类 ， 并 在 
MyInvokationHandler 的 invoke0 方 法 中 回调 这 些 拦截 器 方法 即 可 。 

下 面 提供 一 个 主 程序 来 测试 动态 代理 的 结果 。 

程序 清单 : codes\09\9.3\DynaProxy\Testjava 

ee class Test 


public static void main(String[] args) 
throws Exception 


/ /创建 一 个 原始 的 GunDog 对 象 ， 作 为 target 

Dog target = new GunDog(); 

// 以 指定 的 target 来 创建 动态 代理 

Dog dog = (Dog)MyProxyFactory.getProxy (target); 
// 调 用 代理 对 象 的 info() 和 run() 方 法 

dog.info(); 

dog. run(); 


{ 


} 
了 


上 面 程序 中 的 dog 对 象 实际 上 是 动态 代理 对 象 ， 只 是 该 动态 代理 对 象 也 实现 了 Dog 接口 ， 所 以 也 可 以 
当成 Dog 对 象 使 用 。 程 序 执行 dog 的 info0 和 run0 方 法 时 , 实际 上 会 先 执行 TxUtil 的 beginTx0, 再 执行 target 
对 和 象 的 info0 和 run0 方 法 ， 最 后 再 执行 TxUtil 的 endTx0。 执 行 上 面 的 程序 ， 看 到 如 图 9.5 所 示 结 果 。 


图 9.5 动态 代理 


通过 如 图 9.5 所 示 的 运行 结果 来 看 ， 不 难 发 现 采用 动态 代理 可 以 非常 灵活 地 实现 解 耦 。 通 过 使 用 
这 种 动态 代理 ， 程 序 就 为 被 代理 对 象 增加 了 额外 的 功能 。 

这 种 动态 代理 在 AOP (Aspect Orient Program， 面 向 切面 编程 ) 里 被 称 为 AOP 代理 ，AOP 代理 可 
代替 目标 对 象 ，AOP 代理 包含 了 目标 对 象 的 全 部 方法 。 但 AOP 代理 中 的 方法 与 目标 对 象 的 方法 存在 
差异 ，AOP 代理 里 的 方法 可 以 在 执行 目标 方法 之 前 、 之 后 插入 一 些 通用 处 理 。 

AOP 代理 所 包含 的 方法 与 目标 对 象 所 包含 的 方法 示意 图 如 图 9.6 

和 所 示 。 
es 看 到 此 处 ,相信 读者 应 该 对 Spring 的 AOP 框架 有 点 感觉 了 : 当 Spring 
容器 中 的 被 代理 Bean 实现 了 一 个 或 多 个 接口 时 ，Spring 所 创建 的 AOP 
加 汪 目 标 时 银 的 方法 | 代理 就 是 这 种 动态 代理 。Spring AOP 与 此 示例 应 用 的 区 别 在 哪里 呢 ? 
Spring AOP 更 灵活 ， 当 Sping 定义 InvocationHandler 类 的 invoke0 时 ， 它 
fag | 并 没有 以 硬 编码 方式 决定 调用 哪些 拦截 器 ， 而 是 通过 配置 文件 来 决定 在 
AOp 代 理 的 方法 目标 evoke0 方 法 中 要 调用 哪些 拦截 器 ， 这 就 实现 了 更 彻底 的 解 坷 一 当 程 序 
出 亲 失 这 需要 为 目标 对 象 扩展 新 功能 时 ， 根 本 无 须 改变 Java 代理 ， 只 需要 在 配置 

文件 中 增加 更 多 的 拦截 器 配置 即 可 。 


识 斗 号 淆 二 dOV 
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9 


>>9.3.5 命令 模式 


考 虚 这 样 一 种 场景 ， 某 个 方法 需要 完成 某 一 个 功能 ， 完 成 这 个 功能 的 大 部 分 步骤 已 经 确定 了 ,但 
可 能 有 少量 具体 步骤 无 法 确定 ， 必 须 等 到 执行 该 方法 时 才 可 以 确定 。 具 体 一 点 : 假设 有 个 方法 需要 遍 
历 某 个 数组 的 数组 元 素 ， 但 无 法 确定 在 遍历 数组 元 素 时 如 何 处 理 这 些 元 素 ， 需 要 在 调用 该 方法 时 指定 
具体 的 处 理 行为 。 

这 个 要 求 看 起 来 有 点 奇怪 : 这 个 方法 不 仅 要 求 参 数 可 以 变化 ， 甚 至 要 求 方法 执行 体 的 代码 也 可 以 
变化 ， 难 道 我 们 能 把 “处 理 行为 ”作为 一 个 参数 传 入 该 方法 ? 


暂时 还 不 支持 代码 块 作 为 参数 ， 这 可 能 是 现 阶段 Java 存在 的 一 个 小 小 的 缺陷 。 


对 于 这 样 的 需求 ， 我 们 必须 把 “处 理 行为 ”作为 参数 传 入 该 方法 ， 而 “处 理 行为 ”用 编程 来 实现 
就 是 一 段 代码 。 那 如 何 把 这 段 代码 传 入 某 个 方法 呢 ? Java 暂时 又 不 支持 代码 块 参数 。 

因为 Java 不 允许 代码 块 单独 存在 ， 因 此 我 们 必须 把 该 代码 块 封装 成 一 个 方法 。 在 Java 语言 中 ， 
类 才 是 一 等 公民 ， 方 法 也 不 能 独立 存在 ， 所 以 我 们 实际 传 入 该 方法 的 应 该 是 一 个 对 象 ， 该 对 象 通常 是 
某 个 接口 的 匿名 实现 类 的 实例 ， 该 接口 通常 被 称 为 命令 接口 ， 这 种 设计 方式 也 被 称 为 命令 模式 。 

下 面 的 程序 先 定义 一 个 ProcessArray 类 ， 该 类 里 包含 一 个 each() 方 法 用 于 处 理 数组 ， 但 具体 如 何 

处 理 暂时 不 能 确定 ， 所 以 each() 方 法 里 定义 了 一 个 Command 参数 。 

程序 清单 :codes\09\9.3\Command\ProcessArrayjava 

public class ProcessArray 


{ 
// 定 义 一 个 each () 方 法， 用 于 处 理 数组 ， 
Public void each(int[] target , Command cmd) 
{ 


md.process (target) ; 
} 
) 


上 面 我 们 定义 each() 方 法 时 ,指定 了 一 个 Command 形 参 ,这 个 Command 接口 用 于 定义 一 个 process() 
方法 ， 该 方法 用 于 封装 对 数组 的 “处 理 行为 "。 下 面 是 该 Command 接口 代码 。 
程序 清单 :codes\09\9.3\Command\Command.java 
public interface Command 
{ 
// 接 口 里 定义 的 process 方法 用 于 封装 “处 理 行为” 


void process (int[] target); 
i 


上 面 的 Command 接口 里 定义 了 一 个 process 方法 ， 这 个 方法 用 于 封装 “处 理 行为 ” 但 这 个 方法 
没有 方法 体 一 一 因为 现在 还 无 法 确定 这 个 处 理 行为 。 

当主 程序 调用 ProcessArray 对 象 的 each0 方 法 来 处 理 数组 时 ， 每 次 处 理 数组 需要 传 入 不 同 的 “处 
理 行为 ” 也 就 是 要 为 each0 方 法 传 入 不 同 的 Command 对 象 ， 不 同 的 Command 对 象 封装 了 不 同 的 
“处 理 行为 ”。 

下 面 是 主 程序 调用 ProcessArray 对 象 each0 方 法 的 程序 。 

程序 清单 : codes\09\9.3\Command\CommandTestjava 


public class CommandTest 
{ 


public static void main(String[] args) 
{ 


ProcessArray pa = new ProcessArray(); 
int[] target = {3, -4, 6, 4}; 
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// 第 一 次 处 理 数组 ， 具 体 处 理 行为 取决 于 Command 对 象 


Pa.each (target , new Command() 


// 重 写 Process() 方 法 ， 决 定 具体 的 处 理 行为 
Public void process (int[] target) 
{ 


for (int tmp : target ) 


{ 
System.out.println(" 先 代 输 出 目标 数组 的 元 素 :" + tmp); 
} 
) 

Ds 
System.out .println ("~ 
// 第 二 次 处 理 数组 ， 具 体 处 理 
pa.each(target , new Command() 


{ 
// 重 写 process 方法 ， 决 定 具体 的 处 理 行为 
Public void Process (int[] target) 
{ 


int sum = 0; 
for (int tmp : target ) 
2 om += tmp; 
} 
| System .out.Println{(" 数 组 元 素 的 总 和 是 : ”+ sum) ; 
Ds 
} 
} 
正如 上 面 的 程序 中 两 段 粗 体 字 代码 所 示 ， 程 序 两 次 调用 ProcessArray 对 象 的 each0 方 法 来 处 理 数 
组 对 象 ， 每 次 调用 each0 方 法 时 传 入 不 同 的 Command 匿名 实现 类 的 实例 ， 不 同 的 Command 实例 封装 
了 不 同 的 “处 理 行为 ”。 
运行 上 面 程序 ， 看 到 如 图 9.7 所 示 的 结果 。 


图 9.7 两 次 处 理 数组 的 结果 


图 9.7 显示 了 两 次 不 同 处 理 行为 的 结果 ， 也 就 实现 了 process 方法 和 “处 理 行为 ”的 分 离 ， 两 次 不 
同 的 处 理 行为 分 别 由 两 个 不 同 的 Command 对 象 来 提供 。 
理解 了 这 个 命令 模式 后 ， 相 信 读 者 对 Spring 框架 中 HibermateTemplate 的 executeXxx0 方 法 找到 了 
-点 感觉 ，HibernateTemplate 使 用 了 executeXxx0 方 法 弥补 了 HibernateTemplate 的 不 足 ， 该 方法 需要 
接受 一 个 HibernateCallback 接口 ， 该 接口 的 代码 如 下 : 
// 定 义 一 个 HibernateCallback 接口 ， 该 接口 封装 持久 化 处 理 行为 
interface HibernateCallback 
) 
上 面 的 HibernateCallback 接口 就 是 一 个 典型 的 Command 接口 ， 一 个 HibernateCallback 对 象 封装 
了 自 定义 的 持久 化 处 理 。 
对 HibernateTemplate 而 言 ， 大 部 分 持久 化 操作 都 可 通过 一 个 方法 来 实现 ，HibernateTemplate 对 象 
简化 了 Hibernate 的 持久 化 操作 ， 但 丢失 了 使 用 Hibemate 持久 化 操作 的 灵活 性 。 
通过 HibernateCallback 就 可 以 弥补 HibernateTemplate 灵活 性 不 足 的 缺点 , 当 调用 HibernateTemplate 


Object doInHibernate (Session session); 
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和 


的 executeXxx() 方 法 时 , 传 入 HibernateCallback 对 象 的 dolnHibernate0 方 法 就 是 自 定义 的 持久 化 处 理 一 
一 即将 自 定义 的 持久 化 处 理 传 入 了 executeXxx0 方 法 。 如 下 面 的 代码 片段 所 示 : 


List list = getHibernateTemplate() 
-executeFind (new HibernateCallback() 
{ 
// 实 现 Hibernatecallback 接口 必须 实现 的 方法 
public Object doInHibernate (Session session) 
throws HibernateException, SQLException 


// 执 行 Hibernate 分 页 查询 

List result = session.createQuery (hql) 
.setFirstResult (offset) 

.setMaxResults (PageSize) 

list(); 

return result; 


{ 


} 
return list; 


上 面 的 程序 中 粗 体 字 代码 块 将 直接 传 给 HibermatTemplate，HibernatTemplate 将 直接 使 用 该 代码 块 
来 执行 持久 化 查询 ， 并 将 查询 得 到 的 结果 作为 executeFind0 方 法 的 返回 值 。 


> >9.3.6 策略 模式 


策略 模式 用 于 封装 系列 的 算法 ， 这 些 算法 通常 被 封装 在 一 个 被 称 为 Context 的 类 中 ， 客 户 端 程序 
可 以 自由 选择 其 中 一 种 算法 ， 或 让 Context 为 客户 端 选 择 一 个 最 佳 的 算法 一 一 使 用 策略 模式 的 优势 是 
为 了 支持 算法 的 自由 切换 。 

考虑 如 下 场景 :现在 我 们 正在 开发 一 个 网 上 书店 ， 该 书店 为 了 更 好 地 促销 ， 经 常 需要 对 图 书 进行 
打折 促销 ， 程 序 需要 考虑 各 种 打折 促销 的 计算 方法 。 

为 了 实现 书店 现在 所 提供 的 各 种 打折 需求 ， 程 序 考虑 使 用 如 下 方式 来 实现 。 

// 一 段 实现 discount () 方 法 代码 

public double discount (double price) 


{ 
// 针 对 不 同情 况 采 用 不 同 的 打折 算法 
switch (getDiscountType()) 
{ 
case VIP_DISCOUNT: 
return vipDiscount (price) ; 
break; 
case OLD_DISCOUNT: 
return oldDiscount (price) ; 
break; 
case SALE_DISCOUNT: 
return saleDiscount (price); 
break; 


} 
} 


上 面 的 粗 体 字 代 码 会 根据 打折 类 型 来 决定 使 用 不 同 的 打折 算法 ， 从 而 满足 该 书店 促销 打折 的 要 
求 。 从 功能 实现 的 角度 来 看 ， 这 段 代码 没有 太 大 的 问题 。 但 这 段 代码 有 一 个 明显 的 不 足 ， 程 序 中 各 
种 打折 方法 都 被 直接 写 入 了 discount(double price) 方 法 中 。 如 有 一 天 ， 该 书店 需要 新 增 一 种 打折 类 型 
呢 ? 那 开 发 人 员 必 须 修改 至 少 3 处 代码 : 首先 需要 增加 一 个 常量 ， 该 常量 代表 新 增 的 打折 类 型 ， 其 
次 需要 在 switch 语句 中 增加 一 个 case 语句 ; 最 后 开发 人 员 需 要 实现 xxxDiscount0) 方 法 ， 用 于 实现 新 
增 的 打折 算法 。 

为 了 改变 这 种 不 好 的 设计 ， 下 面 将 会 选择 使 用 策略 模式 来 实现 该 功能 。 下 面 先 提供 一 个 打折 算法 
的 接口 ， 该 接口 里 包含 一 个 getDiscount 0 方法 ， 该 接口 代码 如 下 。 
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程序 清单 : codes\09\9.3\Strategy\DiscountStrategy.java 


public interface Discountstrategy 


{ 

// 定 义 一 个 用 于 计算 打折 价 的 方法 

double getDiscount (double originprice) 7 
} 


下 面 为 该 打折 接口 提供 两 个 策略 类 ， 它 们 分 别 实现 了 不 同 的 打折 算法 。 
程序 清单 :codes\09\9.3\Strategy\VipDiscountjava 
// 实 现 DiscountStrategy 接口 ， 实 现 对 VIP 打折 的 算法 
public class VipDiscount 
implements Discountstrategy 
{ 
// 重 写 getDiscount () 方 法 ,提供 VIP 打折 算法 
public double getDiscount (double originprice) 
{ 
System.out.Println(" 使 用 VIP 折扣 . .."); 
return originprice * 0.5; 
} 
1 


程序 清单 :codes\09\9.3\Strategy\OldDiscountjava 


public class OldDiscount 
implements Discountstrategy 
{ 


// 重 写 getDiscount () 方 法 ， 提 供 旧 书 打折 算法 
public double getDiscount (double originprice) 


{ 
System.out.printin(" 使 用 旧书 折扣 . . .") ; 
return originPrice * 0.77 
1 
} 


提供 了 如 上 两 个 折扣 策略 类 之 后 ， 程 序 还 应 该 提供 一 个 DiscountContext 类 ， 该 类 用 于 为 客户 端 代 
码 选择 合适 折扣 策略 ， 当 然 也 允许 用 户 自由 选择 折扣 策略 。 下 面 是 该 DiscountContext 类 的 代码 。 

程序 清单 : codes\09\9.3\Strategy\DiscountContextjava 
public class DiscountContext 
{ 

// 组 合 一 个 DiscountStrategy 对 象 

private DiscountStrategy strategy; 

// 构 造 器 ， 传 入 一 个 DiscountStrategy 对 象 

public DiscountContext(DiscountStrategy strategy) 

{ 

this.strategy = strategy; 


} 
// 根 据 实际 所 使 用 的 DiscountStrategy 对 象 得 到 折扣 价 
Public double getDiscountprice(double price) 
{ 


// 如 果 strategy 为 null， 系 统 自动 选择 OldDiscount 类 
if (strategy == null) 
{ 
strategy = new OldDiscount(); 
} 
return this.strategy.getDiscount (price); 


人 
// 提 供 切换 算法 的 方法 
public void changeDiscount (Discountstrategy strategy) 
{ 
this.strategy = strategy; 
} 
} 


从 上 面 的 程序 的 粗 体 字 代 码 可 以 看 出 ， 该 Context 类 扮演 了 决策 者 的 角色 ， 它 决定 调用 哪个 折扣 
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策略 来 处 理 图 书 打折 。 当 客户 端 代 码 没有 选择 合适 的 折扣 时 ,该 Context 会 自动 选择 OldDiscount 折扣 
策略 ， 用 户 也 可 根据 需要 选择 合适 的 折扣 策略 。 
下 面 的 程序 示范 了 使 用 该 Context 类 来 处 理 图 书 打 折 的 任何 情况 。 
程序 清单 : codes\09\9.3\Strategy\Strategy Test.java 
public class StrategyTest 
{ 


public static void main(String[] args) 


// 客 户 端 没有 选择 打折 策略 类 

DiscountContext dc = new DiscountContext (null); 

double pricel = 79; 

// 使 用 默认 的 打折 策略 

System.out .println("79 元 的 书 默认 打折 后 的 价格 是 : " 
+ dc.getDiscountPrice (pricel)); A 

// 客 户 端 选择 合适 的 VIP 打折 策略 

dc. changeDiscount (new VipDiscount()) 7 

double Price2 = 89; 

// 使 用 VIP 打折 得 到 打折 价格 

System.out .println ("89 元 的 书 对 VIP 用 户 的 价格 是 ，” 
+ dc.getDiscountPrice(price2)); 


} 
} 


上 面 的 程序 第 一 行 粗 体 字 代码 创建 了 一 个 DiscountContext 对 象 , 客户 端 并 未 指定 实际 所 需 的 打折 
策略 类 ， 故 程序 将 使 用 默认 的 打折 策略 类 ; 程序 第 二 行 粗 体 字 代 码 指定 使 用 VipDiscount 策略 类 ， 故 
程序 将 改 为 使 用 VIP 打折 策略 。 

再 次 考虑 前面 的 需求 ， 当 业务 需要 新 增 一 种 打折 类 型 时 ， 系 统 只 需要 新 定义 一 个 DiscountStrategy 
实现 类 ， 该 实现 类 实现 getDiscount0 方 法 ， 用 于 实现 新 的 打折 算法 即 可 。 客 户 端 程序 需要 切换 为 新 的 
打折 策略 时 ， 则 需要 先 调用 DiscountContext 的 changeDiscount0 方 法 切换 为 新 的 打折 策略 。 

从 上 面 的 介绍 中 可 以 看 出 ， 使 用 策略 模式 可 以 让 客户 端 代码 在 不 同 的 打折 策略 之 间 切 换 ， 但 也 有 
-个 小 小 的 遗憾 : 客户 端 代 码 需 要 和 不 同 的 策略 类 耦合 。 为 了 弥补 这 个 不 足 ， 我 们 可 以 考虑 使 用 配置 
文件 来 指定 DiscountContext 使 用 哪 种 打折 策略 一 一 这 就 彻底 分 离 客 户 端 代码 和 具体 打折 策略 类 。 

介绍 到 这 里 ， 相 信 读 者 对 Hibernate 的 Dialect 会 有 一 点 感觉 了 ， 这 个 Dialect 类 代表 各 数据 库 方言 
的 抽象 父 类 ， 但 不 同 数据 库 的 持久 化 访问 可 能 存在 一 些 差别 ， 尤 其 在 分 页 算法 上 存在 较 大 的 差异 
Dialect 不 同 子 类 就 代表 了 一 种 特定 的 数据 库 访问 策略 。 为 了 让 客户 端 代码 与 具体 的 数据 库 、 具 体 的 
Dialect 实现 类 分 离 ，Hibernate 需要 在 hibermnate.cfeg.xml 文件 中 指定 应 用 所 使 用 的 Dialect 子 类 。 

与 此 类 似 的 是 ，Spring 的 Resource 接口 也 是 一 个 典型 的 策略 接口 ， 不 同 的 实现 类 代表 了 不 同 的 资 
源 访问 策略 。 当 然 Spring 可 以 非常 “智能 ”地 选择 合适 的 Resource 实现 类 ， 通 常 来 说 ，Spring 可 以 根 
据 前 级 来 决定 使 用 合适 的 Resource 实现 类 ; 还 可 根据 ApplicationContext 的 实现 类 来 决定 使 用 合适 的 
Resource 实现 类 。 具 体 请 参考 本 书 8.3 节 的 介绍 。 


》》9.3.7 门面 模式 


随 着 系统 的 不 断 改进 和 开发 ， 它 们 会 变 得 越 来 越 复杂 ， 系 统 会 生成 大 量 的 类 ， 这 使 得 程序 流程 更 
难 被 理解 。 门 面 模式 可 为 这 些 类 提供 一 个 简化 的 接口 ， 从 而 简化 访问 这 些 类 的 复杂 性 ， 有 时 这 种 简化 
可 能 降低 访问 这 些 底层 类 的 灵活 性 ， 但 除了 要 求 特别 苛刻 的 客户 端 之 外 ， 它 通常 都 可 以 提供 所 需 的 全 
部 功能 ， 当 然 ， 那 些 苛刻 的 用 户 仍然 可 以 直接 访问 底层 的 类 和 方法 。 

门面 模式 〈Facade) 也 被 称 为 正面 模式 、 外 观 模式 ， 这 种 模式 用 于 将 一 组 复杂 的 类 包装 到 一 个 简 
单 的 外 部 接口 中 。 

现在 考虑 这 样 的 场景 : 我 们 有 一 个 顾客 需要 到 饭店 用 餐 ， 这 就 需要 定义 一 个 Customer 类 ， 并 为 该 
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类 定义 一 个 haveDinner() 方 法 。 考 虚 该 饭店 有 三 个 部 门 :收银 部 、 厨 师 部 和 服务 生 部 ， 用 户 就 餐 需 要 
这 三 个 部 门 协调 才能 完成 。 
本 示例 程序 先 定义 一 个 收银 部 ， 用 户 需 要 调用 该 部 门 的 pay0 方 法 来 支付 用 餐 费 。 
程序 清单 : codes\09\9.3\Facade\PaymentImpl.java 
public class PaymentImpl 
implements Payment 


// 模 拟 顾 客 支付 费用 的 方法 
public String pay() 
{ 


{ 


String food = "快餐 "; 
tn a 3 您 购买 的 食物 是 :" 
下 
return food; 
} 
} 


程序 接 下 来 要 定义 一 个 厨师 部 门 ， 用 户 需 要 调用 该 部 门 的 cook 0 方法 来 京 调 食物 。 
程序 清单 :codes\09\9.3\Facade\CookImpl.java 
public class CookImpl 

implements Cook 


// 模 拟 亮 调 食物 的 方法 
public String cook(String food) 
{ 


{ 


System.out .println ("厨师 正在 况 调 :" + food)} 
return food; 
) 
} 


程序 还 要 定义 一 个 服务 生 部 门 ， 用 户 需要 调用 该 部 门 的 serve 0 方法 来 得 到 食物 。 
程序 清单 :codes\09\9.3\Facade\WaiterImpl.java 
public class WaiterImpl 

implements Waiter 


// 模 拟 服务 员 上 菜 的 方法 
public void serve(String food) 
{ 


{ 


System.out .println ("服务 器 员 已 将 ”+ food 
: + " 端 过 来 了 ， 请 慢 用 .. .") 7 
} 


接 下 来 实现 Customer 类 的 haveDinner() 方 法 时 ， 系 统 将 有 如 下 代码 实现 。 
程序 清单 : codes\09\9.3\Facade\Customerjava 


public class Customer 
{ 
public void haveDinner() 
{ 
// 依 次 创建 三 个 部 门 实例 
Payment pay = new PaymentImpl(); 
Cook cook = new CookImp1(); 
Waiter waiter = new WaiterImpl (); 
// 依 次 调用 三 个 部 门 实例 的 方法 来 实现 用 餐 功能 
String food = pay.Ppay(); 
Food = cook.cook (food) ; 
waiter. serve (fo0d) ; t 
// 直 接 依赖 于 Facade 类 来 实现 用 餐 方法 
Facade £ = new Facade(); 
£.serveFood(); 
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正如 上 面 的 粗 体 字 代码 所 示 ，Customer 需要 依次 调用 三 个 部 门 的 方法 才 可 实现 这 个 havaDinnerO 
方法 。 实 际 上 ， 如 果 这 个 饭店 有 更 多 的 部 门 ， 那 么 程序 就 需要 调用 更 多 部 门 的 方法 来 实现 这 个 
haveDinner() 方 法 一 一 这 就 会 增加 haveDinner0 方 法 的 实现 难度 了 。 

为 了 解决 这 个 问题 ， 我 们 可 以 为 Payment、Cook、Waiter 三 个 部 门 提供 一 个 门面 (Facade)， 使 用 
该 Facade 来 包装 这 些 类 ， 对 外 提供 一 个 简单 的 访问 方法 。 下 面 是 该 Facade 类 的 代码 。 

程序 清单 : codes\09\9.3\Facade\Facade.java 

public class Facade 


// 定 义 被 Facade 封装 的 三 个 部 门 
Payment Pay 

Cook cook; 

Waiter waiter; 


7/ 构造 器 

public Facade() 

{ 
this.pay = new PaymentImpl(); 
this.cook = new CookImpl (); 
this.waiter = new WaiterImpl (); 


} 
public void serveFood() 
{ 


// 依 次 调用 三 个 部 门 的 方法 ， 封 装 成 一 个 serveFood() 方 法 
String food = pay.pay(); 
Food = cook .cook (food) ; 
waiter.serve(food); 
} 
} 
从 Facade 代码 可 以 看 出 ， 该 门面 类 保证 了 Payment、Cook、Waiter 三 个 部 门 ， 程 序 的 粗 体 字 代码 
对 外 提供 了 一 个 简单 的 serveFood( 方 法 ， 该 方法 对 外 提供 了 一 个 用 餐 的 方法 ， 而 底层 则 依赖 于 三 个 部 


门 的 pay0、cook0、serve0 三 个 方法 。 
- 旦 程序 提供 了 这 个 门面 类 Facade 之 后 ，Cutsomer 类 实现 haveDinner( 方 法 就 变 得 更 加 简单 了 。 
下 面 是 通过 Facade 类 实现 haveDinner() 方 法 的 代码 。 
public void haveDinner() 
{ 
// 直 接 依赖 于 Facade peg 


Facade £ = new Facade() 
£.serveFood(); 


} 

从 上 面 的 程序 可 以 看 出 ， 如 果 不 采用 门面 模式 ， 客 户 端 需 要 自行 决定 需要 调用 哪些 类 、 哪 些 方法 ， 
并 需要 按 合 理 的 顺序 来 调用 它们 才 可 实现 所 需 的 功能 。 不 采用 门面 模式 时 , 程序 有 如 图 9.8 所 示 的 结构 。 

从 图 9.8 中 可 以 看 出 ， 两 个 客户 端 需要 和 底层 各 对 象形 成 错综复杂 的 网 络 调用 ， 无 疑 增加 了 客户 
端 编程 的 复杂 度 。 使 用 正面 模式 后 的 程序 结构 如 图 9.9 所 示 。 


图 9.8 未 使 用 门面 模式 的 结构 图 
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从 图 9.9 可 以 看 出 ， 当 程序 使 用 了 门面 模式 之 后 ， 客 户 端 代码 只 需要 和 门面 类 进行 交互 ， 客 户 端 
代码 变 得 极为 简单 。 


图 9.9 使 用 门面 模式 的 程序 结构 图 


阅读 到 此 处 相信 读者 对 Spring 的 HibernateTemplate 类 有 点 感觉 了 ， 当 我 们 的 程序 使 用 
HibernateTemplate 的 find0 方 法 时 ， 程 序 只 要 此 一 行 代码 即 可 得 到 查询 返回 的 List。 但 实际 上 该 fnd0 
方法 后 隐藏 了 如 下 代码 : 


Session session = sf.openSession(); 
Query query = session.createQuery (hql); 
forlint i = 0 ; i < args.length ; i++) 
{ 

query. setParameter (i ,args[i]); 
} 
query.1ist (); 


因此 ， 我 们 可 以 认为 HibemateTemplate 是 SessionFactory、Session、Query 等 类 的 门面 ， 当 客户 端 
程序 需要 进行 持久 化 查询 时 , 程序 无 须 调用 这 些 类 , 而 是 直接 调用 HibemateTemplate 门面 类 的 方法 即 可 。 

除 此 之 外 ，Java EE 应 用 里 使 用 业务 逻辑 组 件 来 封装 DAO 组 件 也 是 典型 的 门面 模式 一 一 每 个 业务 
退 辑 组 件 都 是 众多 DAO 组 件 的 门面 ， 系统 的 控制 器 类 无 须 直接 访问 DAO 组 件 , 而 是 由 业务 逻辑 方法 
来 组 合 多 个 DAO 方法 以 完成 所 需 功能 , 而 Action 只 需 与 业务 逻辑 组 件 交互 即 可 。 在 这 种 设计 方式 下 ， 
Java EE 应 用 的 各 组 件 有 如 图 9.10 所 示 的 结构 图 。 


图 9.10 Java EE 应 用 结构 图 


>>9.3.8 桥接 模式 


桥接 模式 是 一 种 结构 型 模式 ， 它 主要 应 对 的 是 : 由 于 实际 的 需要 ， 某 个 类 具有 两 个 或 两 个 以 上 的 
维度 变化 ， 如 果 只 是 使 用 继承 将 无 法 实现 这 种 需要 ， 或 者 使 得 设计 变 得 相当 腔 肿 。 

举例 来 说 ， 假 设 现在 我 们 需要 为 某 个 餐厅 制造 菜单 ， 餐 厅 供应 牛肉 面 、 猪 肉 面 ……， 而 且 顾客 可 
根据 自己 的 口味 选择 是 否 添加 辣椒 。 此 时 就 产生 了 一 个 问题 ， 我 们 如 何 来 应 对 这 种 变化 ， 我 们 是 否 需 
要 定义 辣椒 牛肉 面 、 无 辣 牛 肉 面 、 辣 椒 猪 肉 面 、 无 辣 猪 肉 面 4 个 子 类 ? 如 果 和 餐厅 还 供应 羊肉 面 、 韭 
菜 面 …… 呢 ? 如 果 添 加 辣椒 时 可 选择 无 第 、 微 辣 、 中 辣 、 重 辣 …… 风 味 呢 ? 那 程 序 岂非 一 直人 忙于 定义 
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子 类 ? 
为 了 解决 这 个 问题 ， 我 们 可 以 使 用 桥接 模式 ， 桥 接 模式 的 做 法 是 把 变化 部 分 抽象 出 来 ， 使 变化 部 
分 与 主 类 分 离开 来 , 从 而 将 多 个 维度 的 变化 彻底 分 离 。 最 后 提供 一 个 管理 类 来 组 合 不 同 维度 上 的 变化 ， 
通过 这 种 组 合 来 满足 业务 的 需要 。 
下 面 以 一 个 简单 的 示例 来 示范 桥接 模式 的 使 用 。 程 序 首先 提供 了 一 个 Peppery 接口 ， 该 接口 代表 
了 面条 是 否 添加 辣椒 。 
程序 清单 : codes\09\9.3\Bridge\Peppery.java 
public interface Peppery 
; String style(); 
1 
接着 程序 为 该 接口 提供 两 个 实现 类 ， 第 一 个 实现 类 代表 辣椒 的 风格 。 
程序 清单 : codes\09\9.3\Bridge\PepperySytlejava 
public class PepperySytle implements Peppery 
{ 
// 实 现 "后 味 "风格 的 方法 
public String style() 
return “后 味 很 重 ， 很 过 闻 . - "7 


} 
} 


下 面 一 个 实现 类 代表 不 添加 辣椒 的 风格 。 
程序 清单 :codes\09\9.3\Bridge\PlainStyle.java 
public class Plainstyle implements Peppery 
{ 
7/ 实现 "不 辣 " 风 格 的 方法 
public String style() 
{ 
return "味道 清淡 ， 很 养 凡 . - . "7 


} 
本 


从 上 面 的 程序 可 以 看 出 ， 该 Peppery 接口 代表 了 面条 在 辣 味 风格 这 个 维度 上 的 变化 ， 不 论 面条 在 
该 维度 上 有 多 少 种 变化 ， 程 序 只 需要 为 这 几 种 变化 分 别提 供 实现 类 即 可 。 对 于 系统 而 言 ， 辣 味 风格 这 
个 维度 上 的 变化 是 固定 的 ， 程 序 必须 面 对 的 ， 程 序 使 用 桥接 模式 将 辣 味 风格 这 个 维度 的 变化 分 离 出 来 
了 ， 避 免 与 牛肉 、 猪 肉 材料 风格 这 个 维度 的 变化 耦合 在 一 起 。 

接着 程序 提供 了 一 个 AbstractNoodle 抽象 类 ， 该 抽象 类 将 会 持 有 一 个 Peppery 属性 ， 该 属性 代表 
该 面条 的 辣 味 风格 。 程 序 通过 AbstractNoodle 组 合 一 个 Peppery 对 象 ， 从 而 运行 了 面条 在 辣 味 风格 这 
个 维度 上 的 变化 ， 而 AbstractNoodle 本 身 可 以 包含 很 多 实现 类 ， 不 同 实现 类 则 代表 了 面条 在 材料 风格 
这 个 维度 上 的 变化 。 下 面 是 AbstractNoodle 类 的 代码 。 

程序 清单 :codes\09\9.3\Bridge\AbstractNoodle.java 


public abstract class AbstractNoodle 
{ 
// 组 合 一 个 Peppery 变量 ， 用 于 将 该 维度 的 变化 独立 出 来 
Protected Peppery style; 
// 每 份 Noodle 必须 组 合 一 个 Peppery 对象 
Public AbstractNoodle (Peppery style) 
{ 
this.style = style; 
} 
public abstract void eat(); 
} 


正如 上 面 的 程序 中 粗 体 字 代码 所 示 ， 上 面 的 AbstractNoodle 实例 将 会 与 一 个 Peppery 实例 组 合 ， 
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不 同 的 AbstractNoodle 实例 与 不 同 的 Peppery 实例 组 合 ， 就 可 完成 辣 味 风格 、 材 料 风格 两 个 维度 上 变 
化 的 组 合 了 。 

由 此 可 见 ，AbstractNoodle 抽象 类 可 以 看 做 是 一 个 桥 粱 ， 它 被 用 来 “桥接 ”面条 的 材料 风格 的 改 
变 与 辣 味 风格 的 改变 ， 使 面条 的 特殊 属性 得 到 无 绑 定 的 扩充 。 

接 下 来 为 AbstractNoodle 提供 一 个 PorkyNoodle 子 类 ， 该 子 类 代表 猪肉 面 。 

程序 清单 : codes\09\9.3\Bridge\PorkyNoodlejava 


public class PorkyNoodle extends AbstractNoodle 
{ 

public PorkyNoodle (Peppery style) 

{ 


super (style); 


} 
// 实 现 eat () 抽象 方法 
public void eat() 
{ 
System.out.println ("这 是 一 矿 稍 嫌 油 肛 的 猪肉 面条 。" 
+ super.style.style()); 
) 
} 


再 提供 一 个 BeefMoodle 子 类 ， 该 子 类 代表 牛肉 面 。 
程序 清单 ，codes\09\9.3\Bridge\BeefNoodlejava 
public class BeefNoodle extends AbstractNoodle 


public BeefNoodle (Peppery style) 
{ 
super (style) 7 


) 

7/ 实现 eat () 抽象 方法 

public void eat() 

{ 

System .out.Println(" 这 是 一 篇 美 味 的 牛肉 面条 。” 
+ super.style.style()); 
} 
} 


从 PorkyNoodlejava 和 BeefMoodle.java 中 可 以 看 出 ，AbstractNoodle 的 两 个 具体 类 实现 eat0 方 法 
时 ， 既 组 合 了 材料 风格 的 变化 ， 也 组 合 了 疗 味 风格 的 变化 ， 从 而 可 表现 出 两 个 维度 上 的 变化 。 桥 接 模 
式 下 这 些 接口 和 类 之 间 的 结构 关系 如 图 9.11 所 示 。 


PanSyle PeppeySyte | 
rp M0 Sree [rm med eg | 
Ead 
二 下 一 
人 
| 

4 i 
{oberec 
| we Poppery 
: En je 
ED Cr 
Consevdopy Potyhioodie Feppery sye) 上 TtConseucopy BeetNoodge (Peppery sya 
区 本 一 a 


图 9.11 桥接 模式 的 类 图 
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下 面 提供 一 个 主 程序 ， 可 以 分 别 产生 辣椒 牛肉 面 、 无 辣 牛 肉 面 、 辣 椒 猪肉 面 、 无 辣 猪 肉 面 4 种 风 


格 的 面条 。 
程序 清单 :codes\09\9.3\Bridge\Testjava 


public class Test 
{ 
public static void main(String[] args) 


{ 
// 下 面 将 得 到 “ 亲 昧 ”的 牛肉 面 
AbstractNoodle noodlel = new BeefNoodle( 
new PepperySytle())7 
noodlel.eat ()7 
// 下 面 将 得 到 “不 后 ”的 牛肉 面 
AbstractNoodle noodle2 = new BeefNoodle( 
new Plainstyle()); 
noodle2,eat (); 
// 下 面 将 得 到 “ 辣 味 ”的 猪肉 面 
AbstractNoodle noodle3 = new PorkyNoodle( 
new PepperySytle())7 
noodle3.eat (); 
// 下 面 将 得 到 “不 后 ”的 猪肉 面 
AbstractNoodle noodle4 = new PorkyNoodle( 
new Plainstyle()); 
noodle4 .eat (); 
上 
) 


上 面 程序 的 main 方法 中 得 到 了 4 种 面条 , 这 4 种 面条 就 满足 了 面条 在 两 个 维度 上 的 变化 , 但 程序 
结构 又 比较 简洁 。 

桥接 模式 在 Java EE 架构 中 有 非常 广泛 的 用 途 , 由 于 Java EE 应 用 需要 实现 跨 数 据 库 的 功能 , 程序 
为 了 在 不 同 数据 库 之 间 迁 移 ， 因 此 系统 需要 在 持久 化 技术 这 个 维度 上 存在 改变 ， 除 此 之 外 ， 系 统 也 需 
要 在 不 同业 务 逻 辑 实现 之 间 迁 移 ， 因 此 也 需要 在 逻辑 实现 这 个 维度 上 存在 改变 ， 这 正好 符合 桥接 模式 
的 使 用 场景 。 因 此 ，Java EE 应 用 都 会 推荐 使 用 业务 逻辑 组 件 和 DAO 组 件 分 离 的 结构 ， 让 DAO 组 件 
负责 持久 化 技术 这 个 维度 上 的 改变 , 让 业务 逻辑 组 件 负责 业务 逻辑 实现 这 个 维度 上 的 改变 。 由 此 可 见 ， 
Java EE 中 常见 的 DAO 模式 正 是 桥接 模式 的 应 用 。 


六 -和 


可 能 有 读者 会 感到 奇怪 ， 刚 才 我 们 还 提 到 用 业务 逻辑 组 件 来 包装 DAO 组 件 是 门面 
模式 ， 怎 么 现在 又 说 这 种 方式 是 桥接 模式 呢 ? 其 实 这 两 种 说 法 都 没有 问题 ， 称 这 种 方式 
为 门面 模式 ， 是 从 每 个 业务 还 辑 组 件 底层 包装 了 多 个 DAO 组 件 这 个 角度 来 看 的 ， 从 这 
个 角度 来 看 ， 业 务 还 辑 组 件 就 是 DAO 组 件 的 门面 ， 如 果 从 DAO 组 件 的 设计 初 囊 来 看 ， 
设计 DAO 组 件 是 为 了 让 应 用 在 不 同 持久 化 技术 之 间 自 由 切换 ， 也 就 是 分 离 系统 在 持久 
化 技术 这 个 维度 上 的 变化 ， 从 这 个 角度 来 看 ，Java EE 应 用 中 分 离 出 DAO 组 件 本 身 就 是 守 


遵循 桥接 模式 的 . 


不 要 以 为 每 段 代码 、 每 个 应 用 只 能 使 用 一 种 设计 模式 ! 实际 上 ， 一 个 设计 优良 的 项 目 ， 本 身 就 是 
设计 模式 最 好 的 教科 书 ， 例 如 Spring 框架 ， 当 你 深入 阅读 其 源 代码 时 ， 你 会 发 现 这 个 框架 处 处 充满 了 
设计 模式 的 应 用 场景 。 

笔者 在 此 处 介绍 设计 模式 ， 并 不 是 为 了 让 读者 满足 于 设计 模式 的 实现 方式 ， 而 是 希望 读者 能 掌握 
设计 模式 的 应 用 场景 ， 能 使 用 设计 模式 来 解决 实际 开发 问题 。 真 正 掌握 设计 模式 的 要 求 是 ， 当 进行 系 
统 开发 时 ， 无 须 刻意 思索 需要 运用 哪 种 设计 模式 ， 而 是 信 手 写 来 ， 而 整个 应 用 的 设计 充满 灵性 ， 大 量 
设计 模式 应 用 其 中 。 
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> >9.3.9 观察 者 模式 


观察 者 模式 定义 了 对 象 间 的 一 对 多 依赖 关系 ， 让 一 个 或 多 个 观察 者 对 象 观察 一 个 主题 对 象 。 当 主 
题 对 象 的 状态 发 生变 化 时 ， 系 统 能 通知 所 有 的 依赖 于 此 对 象 的 观察 者 对 象 ， 从 而 使 得 观察 者 对 象 能 够 
自动 更 新 。 

在 观察 者 模式 中 ， 被 观察 的 对 象 常常 也 被 称 为 目标 或 主题 (Subject)， 依 赖 的 对 象 被 称 为 观察 者 
(Observer)。 

下 面 以 一 个 简单 的 示例 来 示范 观察 者 模式 ， 程 序 先 提供 一 个 观察 者 接口 。 

程序 清单 : codes\09\9.3\Observer\Observerjava 


public interface Observer 


{ 
void update (Observable o , Object arg); 


} 
上 面 Observer 接口 是 一 个 观察 者 接口 , 程序 中 所 有 观察 者 都 应 该 实现 该 接口 。 在 该 接口 的 update0 
方法 中 包含 了 一 个 Observable 类 型 的 参数 ， 该 参数 代表 被 观察 对 象 ， 也 就 是 前 面 介绍 的 目标 或 主题 。 
此 处 的 Observable 是 一 个 抽象 基 类 , 程序 中 被 观察 者 应 该 继承 该 抽象 基 类 。Observable 类 的 代码 如 下 。 
程序 清单 : codes\09\9.3\Observer\Observable.java 
public abstract class Observable 
// 用 一 个 List 来 保存 该 对 象 上 所 有 绑 定 的 事件 监听 器 
List<Observer> observers = 
new ArrayList<Observer>(); 


// 定 义 一 个 方法 ， 用 于 从 该 主题 上 注册 观察 者 
publio void registObserver (Observer o) 
{ 


observers.add (0); 


上 

7/ 定义 一 个 方法 ， 用 于 从 该 主题 中 删除 观察 者 
public void removeObserver (Observer o) 
上 


observers.remove(o); 


} 
// 通 知 该 主题 上 注册 的 所 有 观察 者 
public void notifyObservers (Object value) 


// 遍 历 注册 到 该 被 观察 者 上 的 所 有 观察 者 
for (Iterator it = observers,iterator(); 
it.hasNext (); ) 


{ 
Observer o = (Observer)it.next(); 


// 显 式 每 个 观察 者 的 update 方法 
0-.update (this , value); 


本 

} 

该 Observable 抽象 类 是 所 有 被 观察 者 的 基 类 ， 它 主要 提供 了 registObserver0 方 法 用 于 注册 一 个 新 
的 观察 者 ， 并 提供 了 一 个 removeObserver0 方 法 用 于 删除 一 个 已 注册 的 观察 者 ， 当 具体 被 观察 对 象 的 
状态 发 生 改变 时 ， 具 体 被 观察 对 象 会 调用 notifyObservers 方法 来 通知 所 有 观察 者 。 

下 面 提供 一 个 具体 的 被 观察 者 类 : Product， 该 产品 有 两 个 属性 ， 它 继承 了 Observable 抽象 基 类 。 

程序 清单 : codes\09\9.3\Observer\Productjava 

public class Product extends Observable 

// 定 义 两 个 属性 


private String name; 
Private double price; 
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// 无 参数 的 构造 器 
public Product () {} 
public Product (String name , double price) 
{ 
this.name = name; 
this.price = price; 
} 
public String getName() 
{ 


return name; 


} 
// 当 程序 调用 name 的 setter 方法 来 修改 Product 的 name 属性 时 
// 程 序 自然 触发 该 对 象 上 注册 的 所 有 观察 者 
public void setName (String name) 
{ 
this.name = name; 


notifyObservers (name) ; 
} 
Ppublic double getPrice() 
return price; 


} 
// 当 程序 调用 price 的 setter 方法 来 修改 Product 的 price 属性 时 
// 程 序 自然 触发 该 对 象 上 注册 的 所 有 观察 者 
public void setPrice(double price) 
{ 
this.price = price; 
notifyObservers (price) ; 
) 


正如 程序 中 两 行 粗 体 字 代码 所 示 ， 当 程序 调用 Product 对 象 的 setName0、setPrice() 方 法 来 改变 
Product 的 name、price 属性 时 ， 这 两 个 方法 将 自动 触发 Observable 基 类 的 notifyObservers 方法 。 
接 下 来 程序 提供 两 个 观察 者 ， 一 个 用 于 观察 Product 对 象 的 name 属性 ， 另 一 个 用 于 观察 Product 
对 象 的 price 属性 。 
程序 清单 : codes\09\9.3\Observer\NameObserverjava 
public class NameObserver implements Observer 


// 实 现 观 察 者 必须 实现 的 update 方法 
public void update(Observable o , Object arg) 
人 

if (arg instanceof String ) 


// 产 品名 称 改变 值 在 name 中 
String name = (String)arg; 
7/ 启动 一 个 JFrame 窗口 来 显示 被 观察 对 象 的 状态 改变 
JFrame f = new JFrame(" 观 察 者 ") ; 
JLabel 1 = new JLabel ("名 称 改变 为 , ”+ mame) 7 
£f.add(1); 
£f.pack(); 
f.setVisible(true); 
System.out .println (" 名 称 观 察 者 :” + 
口 +“ 物 品名 称 已 经 改变 为 : ”+ name) 


} 
} 
程序 清单 : codes\09\9.3\Observer\PriceObserverjava 


public class PriceObserver implements Observer 


{ 
// 实 现 观察 者 必须 实现 的 update 方法 
public void update(Observable o , Object arg) 
{ 
if(arg instanceof Double) 
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System.out .println (" 价 格 观察 者 : ”+ 
0 + “物品 价格 已 经 改变 为 : ”+ arg); 


} 
上 
接着 主 程序 创建 一 个 Product 对 象 (被 观察 的 目标 对 象 )， 然 后 向 该 被 观察 对 象 上 注册 两 个 观察 者 
对 象 ， 当 主 程序 调用 Product 对 象 的 setter 方法 来 改变 该 对 象 的 状态 时 ， 注 册 在 Product 对 象 上 的 两 个 
观察 者 将 被 触发 。 主 程序 代码 如 下 。 
程序 清单 :codes\09\9.3\Observer\Testjava 


public class Test 
{ 
public static void main(String[] args) 


{ 
// 创 建 一 个 被 观察 者 对 象 
Product p = new Product ("电视 机 ”，176); 
// 创 建 两 个 观察 者 对 象 
NameObserver no ~ new NameObserver(); 
PriceObserver po = new PriceObserver(); 
// 向 被 观察 对 象 上 注册 两 个 观察 者 对 象 
p.registObserver (no); 
Pp:registObserver (po); 
// 程 序 调用 setter 方法 来 改变 Product 的 name 和 price 属性 
P.setName (" 书 府 ") 7 
p.setPrice (345£); 

} 

} 


运行 上 面 的 程序 ， 我 们 将 可 看 到 当 Product 的 属性 值 发 生 改变 时 ， 注 册 在 该 Product 上 的 
NameObserver 和 PriceObserver 将 被 触发 。 
纵 观 上 面 介绍 的 观察 者 模式 ， 我 们 发 现 观察 者 模式 通常 包含 如 下 4 个 角色 。 
> ”被 观察 者 的 抽象 基 类 : 它 通常 会 持 有 多 个 观察 者 对 象 的 引用 , Java 提供 了 java.util.Observable 
基 类 来 代表 被 观察 者 的 抽象 基 类 ， 所 以 实际 开发 中 无 须 自 己 开发 这 个 角色 。 
> 观察 者 接口 ， 该 接口 是 所 有 被 观察 对 象 应 该 实现 的 接口 ， 通 常 它 只 包含 一 个 抽象 方法 
update()。Java 同样 提供 了 java.util.Observer 接口 来 代表 观察 者 接口 ,实际 开发 中 也 无 须 开 
发 该 角色 。 
> ”被 观察 者 实现 类 ， 该 类 继承 Observable 基 类 。 
> ”观察 者 实现 类 :实现 Observer 接口 ， 实 现 update 抽象 方法 。 
理解 了 上 面 观 察 者 模式 的 实现 思路 之 后 ， 可 能 有 读者 会 感到 疑惑 ， 观察 者 模式 的 实现 方式 与 Java 
事件 机 制 的 底层 实现 何其 相似 啊 ? 实际 上 ， 我 们 完全 可 以 把 观察 者 接口 理解 成 事件 监听 接口 ， 而 被 观 
察 者 对 象 也 可 当成 事件 源 来 处 理 一 一 换个 角度 来 思考 : 监听 , 观察 , 这 两 个 词语 之 间 有 本 质 的 区 别 吗 ? 
Java 事件 机 制 的 底层 实现 ， 本 身 就 是 通过 观察 者 模式 来 实现 的 。 
除 此 之 外 ， 观 察 者 模式 在 Java EE 应 用 中 也 有 广泛 应 用 ， 主 题 /订阅 模式 下 的 JMS (Java Message 
Service，Java 消息 服务 ) 本 身 就 是 观察 者 模式 的 应 用 。 图 9.12 显示 了 主题 /订阅 模式 下 JMS 的 示意 图 。 
从 图 9.12 中 可 以 看 出 ， 当 Topic 主题 收 到 发 布 者 Publisher) 发 布 的 消息 时 ， 注 册 到 该 主题 的 所 
有 订阅 者 (Subscriber) 都 可 收 到 该 消息 。 实 际 上 ，Java EE 把 这 个 Topic 设计 成 一 个 被 观察 者 ， 而 所 
有 订阅 者 都 注册 到 该 被 观察 者 ， 当 发 布 者 发 布 消息 时 ， 该 消息 将 会 引起 Topic 主题 的 改变 ， 这 种 改变 
将 会 触发 注册 到 该 Topic 上 的 所 有 观察 者 。 
SS 如 果 读 者 希望 了 解 有 关 JMS 的 相关 内 容 以 及 编程 的 详细 步 又， 可 以 参考 本 书 的 姊妹 简 : 
《经 典 Java EE 企业 应 用 实战 》 该 书 专门 有 一 章 用 于 介绍 JMS。 | 
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图 9.12 主题 /订阅 模式 下 JMS 的 示意 图 


9.4 常见 的 架构 设计 策略 


目前 流行 的 轻 量 级 Java EE 应 用 的 架构 基本 比较 统一 ， 通 常会 使 用 Spring 作为 核心 ， 向 上 整合 
MVC 框架 ， 向 下 整合 ORM 框架 。 使 用 Spring 的 IoC 容器 来 管理 各 组 件 之 间 的 依赖 关系 时 ，Spring 
的 声明 事务 将 负责 业务 逻辑 层 组 件 的 事务 管理 。 

虽然 大 体 的 结构 设计 保持 相似 ， 但 在 具体 的 技术 组 合 上 可 能 存在 较 小 的 变化 ， 当 我 们 决定 采用 某 
种 架构 设计 时 ， 我 们 主要 考虑 这 种 架构 是 否 成 功 地 将 规范 和 实现 分 离 了 ， 从 而 可 以 提供 较 好 的 可 扩展 
性 、 可 修改 性 。 最 理想 的 情况 是 ， 当 我 们 修改 企业 级 应 用 的 某 个 组 件 时 ， 应 用 中 其 他 组 件 受 到 影响 很 
小 ， 或 者 不 受 任何 影响 一 一 这 就 为 整个 系统 后 期 的 扩展 提供 了 无 限 可 能 性 。 


> >9.4.1 贫血 模型 


贫血 模型 是 最 常用 的 应 用 架构 ,也 是 最 容易 理解 的 架构 ,为 了 让 读者 通过 本 书 顺利 进入 轻 量 级 Java 
EE 企业 应 用 开发 ， 本 书后 面 的 范例 都 将 采用 这 种 简单 的 架构 设计 。 

所 谓 贫血 ， 指 Domain Object 只 是 单纯 的 数据 类 ， 不 包含 业务 逻辑 方法 ， 即 每 个 Domain Object 
类 只 包含 相关 属性 , 并 为 每 个 属性 提供 基本 的 setter 和 getter 方法 。 所 有 的 业务 逻辑 都 由 业务 逻辑 组 件 
实现 ， 这 种 Domain Object 就 是 所 谓 的 贫血 的 Domain Object， 采 用 这 种 Domain Object 的 架构 即 所 谓 
的 贫血 模型 。 

下 面 以 一 个 简单 的 消息 发 布 系统 的 代码 为 例 来 介绍 贫血 模型 。 

在 贫血 模型 里 , 所 有 的 Domain Object 只 是 单纯 的 数据 类 , 只 包含 每 个 属性 的 setter 和 getter 方法 ， 
如 下 是 两 个 持久 化 类 。 

第 一 个 Domain Object 是 消息 ， 其 代码 如 下 : 


public class News 


{ 
// 主 键 
private Long id; 
// 消 息 标题 
private String title; 
// 消 息 内 容 
private String content; 
// 消 息 的 发 布 时 间 
private Date postDate; 
// 消 息 的 最 后 修改 时 间 
Private Date lastModifyDate; 
// 消 息 所 属 分 类 
private Category category; 
// 消 息 发 布 者 
private User poster; 
7/ 消 息 对 应 的 回复 
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private Set newsReviews; 


// 下 面 省 略 各 属性 的 setter 和 getter 方法 


// 重 写 Domain Object 的 equals 方 法 
public boolean equals(Object object) 
{ 
if(this == object) 
{ 
return true; 
} 
if (object != null sé 
object.getClass() == News.class) 
{ 
News rhs = (News) object; 
return this.poster.equals(rhs.getPoster()) 
&5 this.postDate.equals(rhs.getPostDate()); 
} 


return false; 


} 
// 重 写 News 类 的 hashCode 方法 
public int hashcode() 
{ 
return this.poster.hashCode() + 
this.postDate.hashCode () * 29; 


} 

// 重 写 News 类 的 tostring 方 法 

public String tostring() 

{ 

return new TostringBuilder (this) .append("id", this,.id) 

.append("title" , this.title) 
.append ("postDate" , this.postDate) 
:append("content" , this.content) 
-append("lastModifyDate" , this,lastModifyDate) 

.append ("poster" , this.poster) 

+append("category" , this.category) 

“append ("newsReviews" , this.newsReviews) 

-toString() 7 


} 
第 二 个 Domain Object 是 消息 对 应 的 回复 ， 其 代码 如 下 : 


public class NewsReview 


// 消 息 回复 的 主键 
private Long id; 


// 消 息 回复 的 内 容 
private String content; 


// 消 息 回复 的 回复 时 间 

Private Date postDate; 

// 回 复 的 最 后 修改 时 间 

Private Date lastModifyDate; 
// 消 息 回复 对 应 的 消息 

private News news; 


// 此 处 省 略 了 各 属性 的 setter 和 getter 方法 


// 重 写 NewsReview 的 equals 方法 
public boolean equals(Object object) 


if(this == object) 
{ 
return true; 
上 
if (object != null g& 


object.getClass() == NewsReview.class) 
{ 


NewsReview rhs = (NewsReview) object; 
return this.poster.equals(rhs.getPoster()) 
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55 this.postDate.equals (rhs.getPostDate()); 
} 
return false; 


3 
// 重 写 NewsReview 的 hashCode 方法 
public int hashcode () 
{ 
return this.poster.hashCode() 
+ this.postDate.hashCode() * 29; 


} 

// 重 写 NewsReview 的 toString 方法 

public String tostring() 

{ 

return new TostringBuilder (this) 

“append("id" , this.id) 
-append ("postDate" , this.postDate) 
‘append("lastModifyDate" , this.lastModifyDate) 
-append("content" , this.content) 
-append ("poster" , this.poster) 
append("news" , this.news).tostring(); 


) 
】 


从 上 面 贫血 模型 的 Domain Object 可 以 看 出 ， 其 类 代码 中 只 为 每 个 属性 提供 setter 和 getter 方法 ， 
这 种 Domain Object 只 是 单纯 的 数据 体 ， 类 似 于 C 语言 的 数据 结构 。 虽 然 它 的 名 字 是 Domain Object, 
却 没有 包含 任何 业务 对 象 的 相关 方法 。 Martin Fowler 认为 , 这 是 一 种 不 健康 的 建 模 方式 , Domain Model 
既然 代表 了 业务 对 象 ， 就 应 该 包含 相关 的 业务 方法 。 从 语义 的 角度 上 来 看 ，Domain Model 在 这 里 被 映 
射 为 持久 化 实体 〈 一 般 都 是 针对 ORM 框架 )， 这 种 Domain Object 应 该 是 数据 与 动作 的 集合 ， 贫 血 模 
型 相当 于 抛弃 了 Java 面向 对 象 的 性 质 。 

Rod Johnson 和 Martin Fowler 一 致 认为 : 贫血 的 Domain Object 实际 上 以 数据 结构 代替 了 对 象 。 他 
们 认为 Domain Object 应 该 是 个 完整 的 Java 对 象 ， 既 包含 基本 的 数据 ， 也 包含 操作 数据 相应 的 业务 罗 
辑 方法 。 

下 面 是 NewsDAOHibernate 的 源 代码 ， 该 DAO 对 象 用 于 操作 News 对 象 。 


//NewsDaoHibernate 继承 HibernateDaoSupport， 实 现 NewsDao 接口 
public class NewsDaoHibernate 
extends HibernateDaosupport implements NewsDao 


// 根 据 主键 加 载 消 息 
public News getNews(Long id) 
{ 


{ 


return (News)getHibernateTemplate() 
-get (News.class, id); 


) 
// 保 存 新 的 消息 
Public void saveNews (News news) 
{ 
getHibernateTemplate () .saveOrUpdate (news); 


} 
// 根 据 主键 删除 消息 
public void removeNews(Long id) 
{ 
getHibernateTemplate () .delete (getNews (id)); 


} 
// 查 找 全 部 的 消息 
public List findAll() 
{ 
getHibernateTemplate() .find ("from News"); 
} 
} 


既然 DAO 对 象 完成 具体 的 持久 化 操作 ， 因 此 基本 的 CRUD 操作 都 应 该 在 DAO 对 象 中 实现 . 但 
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DAO 对 象 应 该 包含 多 少 个 查询 方法 ， 并 不 是 确定 的 。 因 此 ， 根 据 业务 逻辑 的 不 同 需要 ， 不 同 的 DAO 
对 象 可 能 有 数量 不 等 的 查询 方法 。 


对 于 现实 中 News， 应 该 包含 一 个 业务 方法 (addNewsReviews 方法 )。 在 贫血 模型 下 ，News 类 的 
代码 并 没有 包含 该 业务 方法 ， 只 是 将 该 业务 方法 放 到 业务 逻辑 对 象 中 实现 。 下 面 是 业务 逻辑 对 象 实现 
addNewsReviews 的 代码 。 


public class FacadeManagerImpl 
implements FacadeManager 


// 业 务 逻 辑 对 象 依赖 的 DAO 对 象 
private CategoryDao categoryDao; 
private NewsDao newsDao; 

private NewsReviewDao newsReviewDao; 
private UserDao userDao; 


// 此 处 还 应 该 增加 依赖 注入 DAO 对 象 必需 的 setter 方法 
7/ 此 处 还 应 该 增加 其 他 业务 逻辑 方法 


/7 下 面 是 增加 新 闻 回复 的 业务 方法 
public NewsReview addNewsReview (Long newsId ，String content) 


{ 
// 根 据 新 闻 id 加 载 新 闻 


{ 


// 设 置 新 闻 与 新 闻 回复 之 间 的 关联 
review. setNews (news) ; 


// 设 置 新 闻 回 复 的 内 容 
review. setContent (content) ; 


// 设 置 回复 的 回复 时 间 
review. setPostDate (new Date()); 


// 设 置 新 闻 回 复 的 最 后 修改 时 间 
review. setLastModifyDate (new Date()); 


// 保 存 回复 
newsReviewDao. saveNewsReview (review) ; 
return review; 
} 
} 


在 贫血 模型 下 ， 业 务 逻 辑 对 象 作为 DAO 组 件 的 门面 ， 封 装 了 全 部 的 业务 逻辑 方法 ，Web 层 仅 与 
业务 逻辑 组 件 交互 即 可 ， 无 须 访问 底层 的 DAO 对 象 。Spring 的 声明 式 事务 管理 将 负责 业务 逻辑 对 象 
方法 的 事务 性 。 

贫血 模型 的 分 层 非常 清晰 。Domain Object 并 不 具备 领域 对 象 的 业务 逻辑 功能 ， 仅 仅 是 ORM 框架 
持久 化 所 需 的 持久 化 实体 类 ， 仅 是 数据 载体 。 贫 血 模型 容易 理解 ， 开 发 便捷 ， 但 背离 了 面向 对 象 的 设 
计 思 想 ， 所 有 的 Domain Object 并 不 是 完整 的 Java 对 象 。 

总 结 起 来 ， 贫 血 模型 存在 如 下 缺点 : 

> “项 目 需 要 书写 大 量 的 贫血 类 ， 当 然 也 可 以 借助 某 些 工具 自动 生成 。 

> ”Domain Object 的 业务 逻辑 得 不 到 体现 。 由 于 业务 逻辑 对 象 的 复杂 度 大 大 增加 ， 许 多 不 应 该 

由 业务 逻辑 对 象 实现 的 业务 逻辑 方法 ， 完 全 由 业务 逻辑 对 象 实现 ， 从 而 使 业务 逻辑 对 象 的 实 
现 类 变 得 相当 庞大 。 

贫血 模型 的 优点 是 : 开发 简单 、 分 层 清 晰 、 架 构 明晰 且 不 易 混 淆 ; 所 有 的 依赖 都 是 单 向 依赖 ， 解 

耦 优秀 。 适 合 于 初学 者 及 对 架构 把 握 不 十 分 清晰 的 开发 团队 。 


> >9.4.2 领域 对 象 模型 


根据 更 完整 的 面向 对 象 规则 ， 每 个 Java 类 都 应 该 提供 其 相关 的 业务 方法 ， 如 果 我 们 在 系统 中 设计 
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更 完备 的 Domain Object 对 象 ， 则 Domain Object 不 再 是 单纯 的 数据 载体 ，Domain Object 包含 了 相关 
的 业务 逻辑 方法 。 例 如 ，News 类 包含 了 addNewsView 方法 等 。 
下 面 是 修改 后 的 News 类 的 源 代码 。 
public class News 


{ 
// 此 处 省 略 了 其 他 的 属性 
// 此 处 省 略 了 属性 对 应 的 setter 和 getter 方法 


/7 增加 新 闻 回复 的 业务 逻辑 方法 
Public NewsReview addNewsReview (String content) 
{ 


// 以 默认 构造 器 创建 新 闻 回复 实例 
NewsReview review = new NewsReview(); 


// 设 置 回复 内 容 
review. setContent (content) ; 


// 设 置 回复 的 发 布 日 其 
review. setPostDate (new Date()); 


// 设 置 回复 的 最 后 修改 日 期 


review. setLastModifyDate (new Date()); 


// 设 置 回复 与 消息 的 关联 
review. setNews (this) 7 
return review; 


/此 处 省 略 了 重 写 的 hashCode，equals 等 方法 
: wy 
在 上 面 的 Domain Object 中 ， 包 含 了 相应 的 业务 逻辑 方法 ， 这 是 一 种 更 完备 的 建 模 方 法 。 
人 
带 - 注意 : 
不 要 在 Domain Object 中 对 消息 回复 完成 持久 化 ， 如 需 完成 持久 化 ， 必 须 调用 DAO 


组 件 ; 一旦 调用 DAO 组 件 ,将 造成 DAO 对 象 和 Domain Object 的 双向 依赖 ; 另外, Domain 
Object 中 的 业务 远 辑 方 要 在 业务 逻辑 组 件 中 代理 ， 才 能 真正 实现 持久 化 。 


业务 逻辑 方法 中 ， 并 没有 进行 持久 化 。 如 果 抛 开 DAO 层 ， 这 种 Domain Object 也 可 以 独 
立 测试 ， 只 是 没有 进行 持久 化 。DAO 对 象 是 变化 最 小 的 对 象 ， 它 们 都 是 进行 基本 的 CRUD 操作 ， 在 
两 种 模型 下 的 DAO 对 象 没 有 变化 。 

另外 还 需要 对 业务 逻辑 对 象 进行 改 写 ， 虽 然 Domain Object 包含 了 基本 业务 逻辑 方法 ， 但 业务 多 
辑 对 象 还 需 代 理 这 些 方法 。 修 改 后 的 业务 逻辑 对 象 的 代码 如 下 : 


public class FacadeManagerImpl 
implements FacadeManager 


// 业 务 逻辑 对 象 依赖 的 DAO 对 象 

private CategoryDao categoryDao; 

private NewsDao newsDao; 

Private NewsReviewDao newsReviewDao; 
private UserDAO userDao; 

// 此 处 还 应 该 增加 依赖 注入 DAO 对 象 必 需 的 setter 方法 


7/7/ 此 处 还 应 该 增加 其 他 业务 逻辑 方法 


// 下 面 是 增加 新 闻 回复 的 业务 方法 
public NewsReview addNewsReview (Long newsId , String content) 


{ 
// 根 据 新 闻 id 加 载 新 闻 
News news = newsDao.getNews (newsId); 
// 通 过 News 的 业务 方法 添加 回复 
NewsReview review = news.addNewsReview (content); 
// 此 处 必须 显示 持久 化 消息 回复 
newsReviewDao .saveNewsReview (review) ; 


{ 
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return review; 
上 
} 


从 上 面 粗 体 字 代码 可 以 看 出 ,此 时 FacadeManagerImpl 组 件 的 addNewsReview() 方 法 由 News 领域 
对 象 的 addNewsReview() 方 法 提供 实现 ， 而 业务 逻辑 对 象 仅 对 该 方法 进行 简单 的 包装 ， 执 行 必要 的 持 
久 化 操作 。 

在 这 里 存在 一 个 问题 : 业务 逻辑 方法 很 多 ， 哪 些 业务 罗 辑 方法 应 该 放 在 Domain Object 对 象 中 实 
现 ， 而 哪些 业务 逻辑 方法 完全 由 业务 逻辑 对 象 实现 昵 ? Rod Johnson 认为 ， 可 重用 度 高 ， 与 Domain 
Object 密切 相关 的 业务 方法 应 放 在 Domain Object 对 象 中 实现 。 

业务 逻辑 方法 是 否 需 要 由 Domain Object 实现 的 标准 ， 从 一 定 程度 上 说 明了 采用 Rich Domain 
Object 模型 的 原因 。 由 于 某 些 业务 方法 只 是 专 一 地 属于 某 个 Domain Object, 因此 将 这 些 方法 由 Domain 
Object 实现 ， 能 提供 更 好 的 软件 复 用 ， 能 更 好 地 体现 面向 对 象 的 封装 性 。 

Rich Domain Object 模型 的 各 组 件 之 间 的 关系 大 致 如 图 9.13 所 示 。 


Rich Domain 
| Objects 模式 


EA、 


Doman Oect— Doman Otect= Doman Olect= 


图 9.13 Rich Domain Object 的 组 件 关系 图 


这 种 Rich Domain Object 模型 主要 的 问题 是 业务 逻辑 组 件 比较 复杂 : 业务 逻辑 组 件 继续 需要 作为 
DAO 组 件 的 门面 ， 而 且 还 需要 包装 Domain Object 里 的 业务 逻辑 方法 ， 暴 露 这 些 业务 逻辑 方法 ， 让 
Action 组 件 可 以 调用 这 些 方法 。 

为 了 简化 业务 逻辑 对 象 的 开发 ，Rich Domain Object 模型 可 以 有 如 下 两 个 方向 的 改变 : 

> ”合并 业务 逻辑 对 象 与 DAO 对 象 。 

> ”合并 业务 逻辑 对 象 和 Domain Object。 


> >》9.4.3 合并 业务 逻辑 对 象 与 DAO 对 象 


在 这 种 模型 下 DAO 对 象 不 仅 包含 了 各 种 CRUD 方法 , 而且 还 包含 各 种 业务 逻辑 方法 .此 时 的 DAO 
对 象 ， 已 经 完成 了 业务 逻辑 对 象 所 有 任务 ， 变 成 了 DAO 对 象 和 业务 逻辑 对 象 混合 体 。 此 时 ， 业 务 胃 
辑 对 象 依赖 Domain Object， 既 提供 基本 的 CRUD 方法 ， 也 提供 相应 的 业务 逻辑 方法 。 

下 面 是 这 种 架构 设计 的 代码 〈 此 处 News 类 的 实现 与 前 面 的 领域 对 象 模型 中 的 News 类 代码 一 样 ， 
此 处 不 再 给 出 )。 
// NewsServiceHibernate 继承 HibernateDaoSupport， 
// 实 现 NewsService 接口 ， 它 既是 DAO 组 件 ， 也 是 业务 逻辑 组 件 


public class NewsServiceHibernate 
extends HibernateDaoSupport implements NewsService 


// 根 据 主键 加 载 消息 
public News getNews(Long id) 
{ 
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return (News)getHibernateTemplate() 
.get (News.class, id); 


} 
// 保 存 新 的 消息 


public void saveNews (News news) 


{ 
getHibernateTemplate () .saveOrUpdate (news); 


} 
// 根 据 主键 删除 消息 
public void removeNews (Long id) 


getHibernateTemplate () .delete (getNews (id)); 


) 
// 查 找 全 部 的 消息 
public List findAll() 


getHibernateTemplate() .find("from News"); 


} 

// 下 面 是 增加 新 闻 回 复 的 业务 方法 

public NewsReview addNewsReview (Long newsId 
,String content) 


// 根 据 新 闻 id 加 载 新 闻 

News news = newsDao.getNews (newsId) 7 

// 通 过 News 的 业务 方法 添加 回复 

NewsReview review = news.addNewsReview(content); 
// 此 处 必须 显示 持久 化 消息 回复 

newsReviewService. saveNewsReview (review) ; 

return review; 


{ 


} 
上 


正如 上 面 见 到 的 , DAO 对 象 和 业务 逻辑 对 象 之 间 容 易 形成 交叉 依赖 (可 能 某 个 业务 逻辑 方法 的 实 
现 ， 必须 依赖 于 原来 的 DAO 对 象 )。 当 DAO 对 象 被 取消 后 ， 业 务 逻辑 对 象 取 代 了 DAO 对 象 ， 因 此 变 
成 了 一 个 业务 逻辑 对 象 依赖 多 个 业务 逻辑 对 象 。 而 每 个 业务 逻辑 对 象 都 可 能 包含 需要 多 个 DAO 对 象 
协作 的 业务 方法 ， 从 而 导致 业务 逻辑 对 象 之 间 的 交叉 依赖 。 

业务 逻辑 对 象 和 DAO 对 象 合并 后 的 组 件 关系 如 图 9.14 所 示 。 


合并 DAO 组 件 和 
生 务 刘 加 相 件 


站 Y 
全 时 全 
pe bo bo 


图 9.14 合并 DAO 对 象 和 业务 逻辑 对 象 


这 种 模型 也 导致 了 DAO 方法 和 业务 逻辑 方法 混合 在 一 起 ， 显 得 职责 不 够 单一 ， 软 件 分 层 结 构 不 
够 清晰 。 而 且 使 业务 未 辑 对 象 之 间 交 叉 依赖 ， 容 易 产生 混乱 ， 未 能 做 到 彻底 的 简化 。 


和 9.4.4 合并 业务 未 辑 对 象 和 Domain Object 

在 这 种 架构 下 ， 所 有 的 业务 逻辑 都 应 该 被 放 在 Domain Object 里 面 ， 而 此 时 的 业务 迎 辑 层 不 再 是 
传统 的 业务 逻辑 层 ， 它 仅仅 封装 了 事务 和 少量 逻辑 ， 不 再 提供 任何 业务 逻辑 的 实现 。 而 Domain Object 
依赖 于 DAO 对 象 执 行 持久 化 操作 ， 此 处 Domain Object 和 DAO 对 象形 成 双向 依赖 。 在 这 种 设计 思路 
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下 ， 业 务 逻 辑 层 变 得 非常 “ 薄 ”"， 它 的 功能 也 变 得 非常 微弱 。 
在 这 种 设计 架构 下 ,几乎 不 再 需要 业务 逻辑 层 ,， 而 Domain Object 则 依赖 DAO 对 象 完成 持久 化 操 
作 。 下 面 是 在 这 种 架构 设计 下 的 News 类 代码 。 
public class News 
{ 
// 此 处 省 略 了 其 他 的 属性 
/7 /此 处 省 略 了 属性 对 应 的 setter 和 getter 方法 


/7/ 增 加 新 闻 回复 的 业务 逻辑 方法 
public NewsReview addNewsReview (String content) 


{ 
// 以 默认 构造 器 创建 新 闻 回复 实例 
NewsReview review = new NewsReview(); 
// 设 置 回复 内 容 
review.setContent (content); 
// 设 置 回复 的 发 布 日 期 
review.setPostDate (new Date()); 
// 设 置 回 复 的 最 后 修改 日 期 
review.setLastModifyDate (new Date()); 
联 


// 设 置 回复 与 消息 的 关 
.review. setNews (this) 7 


// 直 接 调 用 newsReviewsDao 完成 消息 回复 的 持久 化 
newsReviewsDao .save (review) ; 
return review; 


/此 外 省略 了 重 写 的 hashCode、equals 等 方法 
) 
正如 上 面 程序 中 粗 体 字 代 码 所 示 ， 此 时 Domain Object 对 象 直接 调用 了 DAO 组 件 的 持久 化 方法 ， 
从 而 使 得 Domain Object 本 身 就 可 实现 整个 业务 逻辑 功能 。 
在 这 种 设计 下 ,Domain Object 必须 使 用 DAO 对 象 完成 持久 化 , 因此 Domain Object 必须 接收 loC 
容器 的 注入 ， 而 Domain Object 获取 容器 注入 的 DAO 对 象 ， 通 过 DAO 对 象 完成 持久 化 操作 。 
合并 业务 罗 辑 对 象 和 Domain Object 后 各 组 件 的 关系 如 图 9.15 所 示 。 


会 并 本 务 迎 辑 组 件 和 
es 


EE 
YY 入 
全 全 全 


图 9.15 合并 业务 逻辑 组 件 和 Domain Object 


这 种 架构 的 优点 是 : 业务 逻辑 对 象 非常 简单 ， 只 提供 简单 的 事务 操作 ， 业 务 逻 辑 对 象 无 须 依赖 于 
DAO 对 象 。 
但 这 种 架构 也 存在 如 下 缺点 : 
> DAO 对 象 和 Domain Object 形成 了 双向 依赖 ， 其 复杂 的 双向 依赖 会 导致 很 多 潜在 的 问题 。 
> ”业务 逻辑 层 和 Domain 层 的 逻辑 混淆 不 清 ， 在 实际 项 目 中 ， 极 容易 导致 架构 混乱 。 
> ”由 于 使 用 业务 逻辑 对 象 提供 事务 封装 特性 ， 业 务 逻 辑 层 必须 对 所 有 的 Domain Object 的 逻辑 提 
供 相应 的 事务 封装 ， 因 此 业务 逻辑 对 象 必须 重新 定义 Domain Object 实现 的 业务 逻辑 ， 其 工作 
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>>9.4.5 抛弃 业务 远 辑 层 


在 Rich Domain Object 架构 的 各 种 变化 中 , 虽然 努力 简化 业务 逻辑 对 象 , 但 业务 逻辑 对 象 依然 存在 ， 
使 用 业务 逻辑 对 象 始终 是 DAO 组 件 访问 的 门面 。 下 面 介 绍 两 种 更 彻底 的 简化 ， 彻 底 放弃 业务 逻辑 层 。 

抛弃 业务 逻辑 层 也 有 两 种 形式 : 

> ”Domain Object 彻底 取代 业务 逻辑 对 象 。 

> ”由 控制 器 直接 调用 DAO 对 象 。 

1.，Domain Object 完全 取代 业务 逻辑 对 象 

这 种 架构 设计 是 9.4.4 节 所 介绍 的 架构 的 更 激进 的 演化 , 由 于 在 那 种 架构 中 业务 逻辑 对 象 的 作用 仅 
仅 只 提供 事务 封装 ， 因 此 业务 逻辑 对 象 存在 的 必要 性 不 是 很 大 ， 考 虑 对 Domain Object 的 业务 逻辑 方 
法 增加 事务 管理 ， 而 Web 层 的 控制 器 则 直接 依赖 于 Domain Object。 

这 种 架构 设计 更 加 简化 , Domain Object 与 DAO 组 件 形成 双向 依赖 , 而 Web 层 的 控制 器 直接 调用 
Domain Object 的 业务 逻辑 方法 。 这 种 架构 设计 与 Ruby On Rails 框架 的 设计 极为 相似 ，Ruby On Rails 
应 用 也 使 用 Domain Object 完整 地 实现 了 业务 逻辑 方法 。 

这 种 架构 设计 的 优点 是 ， 分 层 少 ， 代 码 实现 简单 。 但 也 存在 如 下 缺点 : 

> ”业务 逻辑 对 象 的 所 有 业务 逻辑 都 将 在 Domain Object 中 实现 ,势必 引起 Domain Object 的 混乱 。 

> ”Domain Object 必须 直接 传递 到 Web 层 ， 从 而 将 持久 化 API 直接 传递 到 Web 层 ， 因 此 可 能 

引发 一 些 意 想不到 的 问题 。 

在 这 种 架构 设计 下 ，Domain Object 相当 不 稳定 。 如 果 业 务 逻 辑 需 要 改变 ，Domain Object 也 需要 
发 生 改 变 ， 而 且 DAO 对 象 与 Domain Object 形成 双向 依赖 ， 这 将 导致 底层 的 Domain Object 和 DAO 
对 象 都 需要 修改 ， 从 而 导致 这 种 架构 设计 的 分 层 失去 意义 。 各 层 之 间 以 强 耦 全 方式 组 合 在 一 起 ， 各 层 
对 象 互 人 可 扩展 性 较 差 。 


流利 ， 己 
Rails 项 目 与 Java EE 项 目 不 一 样 ， 因为 Rails 项 目 中 的 Domain Object 会 继承 
ActiveRecord::Base 类 ， 而 且 Ruby 是 一 门 动态 语言 ， 这 就 使 得 Domain Object 本 身 直接 
具有 了 持久 化 操作 访问 ， 相当 于 Domain Object 本 身 就 具有 了 所 有 DAO 方法 ; 而 且 由 于 
和 开发 Rails 项 目 WA DAO 组 件 ， 因 而 Rails 项 目 采用 


2. 控制 器 完成 业务 逻辑 


在 这 种 模型 里 ， 控 制 器 直接 调用 DAO 对 象 的 CRUD 方法 ， 通 过 调用 基本 的 CRUD 方法 ， 完 成 对 
应 的 业务 逻辑 方法 。 在 这 种 模型 下 ,业务 逻辑 对 象 的 功能 由 控制 器 完成 。 事务 则 推迟 到 控制 器 中 完成 ， 
因此 对 控制 器 的 execute0 方 法 增加 事务 控制 即 可 。 

对 于 基本 的 CRUD 操作 ， 控 制 器 可 直接 调用 DAO 对 象 的 方法 ， 省 略 了 业务 逻辑 对 象 的 封装 ， 这 
就 是 这 种 模型 的 最 大 优势 。 对 于 业务 逻辑 简单 〔 当 业务 逻辑 只 是 大 量 的 CRUD 操作 时 ) 的 项 目 ， 使 用 
这 种 模型 也 未 尝 不 是 一 种 好 的 选择 。 

但 这 种 模型 将 导致 控制 器 变 得 腑 肿 ， 因 为 每 个 控制 器 除了 包含 原 有 的 execute 方法 之 外 ， 还 必须 
包含 所 需要 的 业务 逻辑 方法 的 实现 。 极 大 地 省 略 了 业务 逻辑 层 的 开发 ， 避 免 了 业务 逻辑 对 象 不 得 不 大 
量 封 装 基本 的 CRUD 方法 的 整 端 。 

这 种 模型 的 缺点 极为 明显 ， 实 际 上 这 种 架构 模型 极 少 被 使 用 : 

> ”因为 没有 业务 逻辑 层 ， 对 于 那些 需要 多 个 DAO 参与 的 复杂 业务 逻辑 ， 在 控制 器 中 必须 重复 


761 


http://52pdf.taobao.com 
攻 旺 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


实现 ， 其 效率 低 ， 也 不 利于 软件 重用 。 
> ”Web 层 的 功能 不 再 清晰 ，Web 层 的 控制 器 相当 复杂 。Web 层 不 仅 负责 实现 控制 器 巡 辑 ， 还 
需要 完成 业务 逻辑 的 实现 ， 因 此 必须 精确 控制 何 时 调用 DAO 方法 控制 持久 化 。 
这 种 架构 模型 还 扩大 了 事务 的 影响 范围 。 大 部 分 情况 下 ， 只 有 业务 逻辑 方法 需要 增加 事务 控制 ， 
而 execute 方法 无 须 增加 事务 控制 。 但 如 果 execute 方法 直接 调用 了 DAO 对 象 的 CRUD 方法 ， 则 会 导 
致 这 些 方法 不 在 事务 环境 下 执行 。 为 了 让 数据 库 访问 都 在 事务 环境 下 进行 ， 不 得 不 将 事务 范围 扩大 到 
整个 execute 方法 。 这 必然 导致 性 能 降低 。 


9.5 本章 小 结 


本 章 主要 介绍 了 笔者 在 架构 设计 方面 的 一 些 经 验 。 本 章 从 企业 应 用 开发 面临 的 困难 讲 起 ， 并 给 出 
了 面 对 这 些 困 难 时 应 该 采用 怎样 的 应 对 策略 。 本 章 重点 介绍 了 Java EE 应 用 中 常用 的 设计 模式 ， 本 章 
并 没有 全 面 介绍 23 种 设计 模式 , 也 不 是 仅仅 介绍 了 设计 模式 的 实现 方法 ; 而 是 侧重 于 介绍 设计 模式 在 
Spring、Hibernate 以 及 Java EE 应 用 中 的 用 途 ， 并 分 析 了 使 用 这 些 模式 的 优势 。 

本 章 最 后 还 介绍 了 Java EE 应 用 的 常用 架构 ， 如 贫血 模型 、 领 域 对 象 模 型 ， 以 及 领域 对 象 模型 的 
几 种 简化 方式 ， 并 深入 分 析 了 几 种 架构 各 自 的 优 缺点 ， 让 开发 者 对 这 些 架构 有 更 深刻 的 认识 。 
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第 10 章 
简单 工作 流 系统 


本 章 要 点 


节 工 作 流 的 背景 知识 和 概述 

他 系 统 需求 分 析 的 基本 思路 

节 轻 量 级 Java EE 应 用 的 分 层 模型 

划 轻 量 级 Java EE 应 用 的 总 体 架构 及 实现 方案 
他 根 据 系统 需求 提取 系统 实体 

节 实 现 Hibernate 持久 层 

苗 基 于 HibernateDaoSupport 的 DAO 实 现 
切实 现 业务 逻辑 层 

苗 基 于 AOP 的 声明 式 事务 Cy z 
和 在 Spring 中 使 用 Cuiarz 进行 任务 调度 
和 设计 Web 层 

节 使 用 拦截 器 进行 权限 检查 
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本 章 将 会 综合 运用 前 面 章节 所 介绍 的 知识 来 开发 一 个 简单 的 工作 流 系 统 。 本 章 的 工作 流 系统 没有 
使 用 任何 工作 流 引擎 ， 完 全 由 程序 自己 实现 公司 日 常 工作 的 流程 管理 ， 因 此 所 处 理 的 流程 比较 简单 。 
本 系统 可 以 完成 员工 每 日 上 下 班 打卡 ， 而 系统 将 负责 为 每 个 员工 进行 考勤 ， 当 员工 发 现 自己 的 考勤 异 
常 时 ， 可 以 向 其 经 理 申请 改变 考勤 。 除 此 之 外 ， 本 系统 还 可 根据 员工 的 考勤 自动 结算 工资 。 

本 系统 采用 前 面 介 绍 的 Java EE 架构 : Struts 2.2 + Spring 3.0 + Hibernate 3.6， 该 系统 结构 成 熟 ， 性 
能 良好 ， 运 行 稳定 。Spring 的 IoC 容器 负责 管理 业务 逻辑 组 件 、 持 久 层 组 件 及 控制 层 组 件 ， 充 分 利用 
依赖 注入 的 优势 ， 进 一 步 增强 系统 的 解 看 ， 提 高 应 用 的 可 扩展 性 ， 降 低 系 统 重 构 的 成 本 ， 系 统 后 台 的 
作业 调度 使 用 Qutarz 框架 完成 。 


10.1 项 目 背景 及 系统 结构 


本 章 将 以 一 个 简单 的 工作 流 系统 为 例 ， 为 读者 示范 如 何 开发 轻 量 级 Java EE 应 用 。 该 系统 包含 一 
个 公司 日 常 的 事务 ， 日常 考勤 、 工 资 结算 及 签 核 申请 等 。 


>>10.1.1 应 用 背景 


所 谓 工作 流 ， 就 是 企业 或 组 织 日 常 工作 的 固定 流程 ， 比 如 签 核 流程 及 外 贸 企 业 的 报关 流程 等 。 工 
作 流 是 Java EE 应 用 的 主要 应 用 方向 之 一 ， 在 计算 机 信息 系统 尚未 形成 主流 时 ， 其 工作 流 都 是 由 人 工 
完成 的 ， 但 人 工 完成 存在 诸多 不 利 ， 如 工作 效率 低 (一 个 节点 的 延迟 将 导致 整个 工作 流 的 停 潜 )、 信 息 
传递 响应 速度 慢 ， 以 及 纸张 、 通 信 资 源 浪费 等 。 

在 20 世纪 80 年 代 中 ， 人 们 终于 找到 了 缓解 这 些 王 病 的 办 法 ， 就 是 依赖 网 络 的 工作 流 技术 。 

工作 流 是 完全 自动 化 的 流程 ， 避 免 了 使 用 各 种 申请 文件 的 人 工 传送 ， 而 申请 文件 都 是 以 电子 文件 
形式 ， 避 免 了 传送 延迟 ， 提 高 了 效率 等 。 

结合 了 网 络 技术 的 工作 流 功能 更 加 强大 ， 一 个 全 球 性 的 企业 信息 化 平台 ， 借 助 于 E-mail、 即 时 通 
信 工 具 以 及 自 定义 工作 流 ， 完 全 可 以 将 各 地 区 的 组 织 有 机 地 组 织 在 一 起 。 各 区 域 的 通信 、 各 种 流程 申 
请 等 完全 是 即时 响应 ， 避 免 等 待 。 

本 示例 应 用 的 签 核 系 统 ， 完 成 了 考勤 改变 申请 的 送 签 ， 以 及 对 申请 的 签 核 。 这 是 一 种 简单 的 工作 
流 ， 同 样 可 以 提高 企业 的 生产 效率 。 另 外 ， 本 应 用 额外 的 打卡 系统 、 自 动工 资 结算 等 ， 也 可 以 在 一 定 
程度 上 提高 企业 的 生产 效率 。 


>>10.1.2 系统 功能 介绍 


系统 的 用 户 分 为 两 个 角色 : 普通 员工 和 经 理 。 

普通 员工 的 功能 包括 : 系统 将 自动 完成 员工 每 天 上 下 班 的 考勤 记录 ， 包 括 迟 到 、 早 退 、 了 旷工 等 ; 
员工 也 可 以 查看 本 人 最 近 3 天 的 考勤 情况 ， 如 果 发 现 考勤 与 实际 不 符 〈 例 如 出 差 ， 或 者 病假 等 )， 则 可 
提出 申请 ， 该 申请 将 由 系统 自动 转发 给 员工 经 理 ， 如 果 经 理 通 过 核准 ， 则 此 申请 自动 生效 ， 系 统 将 考 
勤 改 为 实际 的 情况 ， 此 外 ， 员 工 还 可 查看 自己 的 工资 记录 。 

经 理 的 功能 除了 包括 普通 员工 的 功能 外 , 还 有 签 核 员 工 申 请 的 功能 ， 以 及 对 新 增 员工 的 查看 和 查看 员 
工 的 上 月 工资 等 功能 。 但 经 理 的 考勤 不 能 提出 申请 ， 在 实际 的 项 目 中 ， 经 理会 有 更 上 一 级 的 管理 者 ， 因 此 
经 理 也 可 以 对 考勤 异动 提出 申请 。 实 际 的 项 目 中 采用 树 形 组 织 结构 图 来 组 织 部 门 ， 每 个 员工 属于 部 门 。 


764 


http://52pdf.taobao.com 


第 10 章 10 


当然 ， 这 个 系统 与 实际 应 用 还 有 一 些 距离 ， 此 示例 仅 介绍 如 何 开发 轻 量 级 Java EE 应 用 ， 而 不 是 
介绍 如 何 开发 工作 流 系 统 。 


>>10.1.3 相关 技术 介绍 


本 系统 主要 涉及 三 个 开源 框架 ，Struts 2.2、Spring 3.0 和 Hibernate 3.6， 同 时 还 使 用 了 JSP 作为 表 
现 层 技术 。 本 系统 将 这 4 种 技术 有 机 地 结合 在 一 起 ， 从 而 构建 出 一 个 健壮 的 Java EE 应 用 。 

1. 传统 表现 层 技术 : JSP 

本 系统 使 用 JSP 作为 表现 层 ， 负 责 收集 用 户 请 求 数 据 ， 以 及 业务 数据 的 表示 。 

JSP 是 最 传统 也 最 有 效 的 表现 层 技术 。 本 系统 的 JSP 页 面 是 单纯 的 表现 层 ， 所 有 的 JSP 页 面 不 再 
使 用 Java 脚本。 结合 Struts 2.2 的 表现 层 标签 ， JSP 可 完成 全 部 的 表现 层 功能 一 一 数据 收集 、 数 据 表示 
和 输入 数据 校 验 。 

2. MVC 框架 

本 系统 使 用 Struts 2.2 作为 MVC 框架 。Struts 2.2 以 Struts 1.x 和 WebWork 为 基础 ， 迅 速成 长 为 
MVC 框架 中 新 的 王者 ， 一 经 推出 ， 立 即 赢得 了 广泛 的 市 场 支持 。 本 应 用 的 所 有 用 户 请 求 ， 包 括 系统 
的 超 链接 和 表单 提交 等 , 都 不 再 直接 发 送 到 表现 层 JSP 页 面 ,而 是 必须 发 送 给 Struts 2.2 的 Action, Struts 
2.2 控制 所 有 请 求 的 处 理 和 转发 。 

通过 Struts 2.2 拦 鹤 所 有 请 求 有 个 好 处 : 将 所 有 的 JSP 页 面 放 入 WEB-INF/ 路 径 下 ， 可 以 避免 用 户 
直接 访问 JSP 页 面 ， 从 而 提高 系统 的 安全 性 。 

本 应 用 使 用 基于 Struts 2.2 拦截 器 的 权限 控制 ， 应 用 中 控制 器 没有 进行 权限 检查 ,但 每 个 控制 器 都 
需要 重复 检查 调用 者 是 否 有 足够 的 访问 权限 ， 这 种 通用 操作 正 是 Struts 2.2 拦截 器 的 用 武之 地 。 整 个 应 
用 有 普通 员工 、 经 理 两 种 权限 检查 ， 只 需 在 Struts 2.2 的 配置 文件 中 为 两 种 角色 配置 不 同 拦截 器 ， 即 可 
完成 对 普通 员工 、 经 理 两 种 角色 的 权限 检查 。 

3. Spring 框架 的 作用 

Spring 框架 是 系统 的 核心 部 分 , Spring 提供 的 IoC 容器 是 业务 逻辑 组 件 和 DAO 组 件 的 工厂 , 它 负 
责 生成 并 管理 这 些 实例 。 

借助 于 Spring 的 依赖 注入 ， 各 组 件 以 松 耦 合 的 方式 组 合 在 一 起 ， 组 件 与 组 件 之 间 的 依赖 正 是 通过 
Spring 的 依赖 注入 管理 。 其 Service 组 件 和 DAO 对 象 都 采用 面向 接口 编程 的 方式 ， 从 而 降低 了 系统 重 
构 的 成 本 ， 极 好 地 提高 了 系统 的 可 维护 性 、 可 修改 性 。 

本 应 用 扩展 了 Spring 的 HibemnateDaoSupport 基 类 ， 提 供 了 一 个 YeekuHibernateDaoSupport， 该 扩 
展 类 主要 提供 了 三 个 用 于 分 页 的 查询 方法 ， 从 而 可 以 非常 方便 地 完成 分 页 查询 。 

本 应 用 的 所 有 DAO 组 件 都 继承 YeekuHibernateDaoSupport， 借 助 于 Spring 的 IoC 容器 和 DAO 支 
持 ， 程 序 开发 者 无 须 管理 Hibernate 的 SessionFactory 及 Session 等 对 象 ， 直 接 使 用 Spring 提供 的 
HibernateTemplate 即 可 完成 数据 库 操作 。 

应 用 事务 采用 Spring 的 声明 式 事务 框架 。 通 过 声明 式 事务 ， 无须 将 事务 策略 以 硬 编码 的 方式 与 代 
码 耦 合 在 一 起 ， 而 是 放 在 配置 文件 中 声明 ， 使 业务 逻辑 组 件 可 以 更 加 专注 于 业务 的 实现 ， 从 而 简化 开 
发 。 同 时 ， 声 明 式 事务 降低 了 不 同事 务 策略 的 切换 代价 。 

该 系统 的 工资 自动 结算 和 自动 考勤 等 都 采用 Qutarz 框架 ， 该 框架 使 用 Cron 表达 式 触发 来 调度 作 
业 ， 从 而 完成 任务 自动 化 。 

4. Hibernate 的 作用 

Hibernate 作为 O/R Mapping 框架 使 用 , 其 O/R Mapping 功能 简化 了 数据 库 的 访问 , 并 在 JDBC 层 
上 提供 了 更 好 的 封装 。 以 面向 对 象 的 方式 操作 数据 库 ， 更 加 符合 面向 对 象 程序 设计 的 思路 。 


765 


http://52pdf.taobao.com 
米 量 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


Hibernate 以 优雅 及 灵活 的 方法 操作 数据 库 ， 无 须 开发 者 编写 烦琐 的 SQL 语句 ， 执 行 元 长 的 多 表 
查询 ， 而 通过 对 象 与 对 象 之 间 的 关联 来 操作 数据 库 ， 为 底层 的 DAO 对 象 的 实现 提供 了 支持 。 


》>》>10.1.4 系统 结构 


本 系统 采用 严格 的 Java EE 应 用 结构 ， 主 要 有 如 下 几 个 分 层 。 
> ”表现 层 : 由 JSP 页 面 组 成 。 
MVC 层 : 使 用 MVC 框架 技术 。 
业务 逻辑 层 ， 主 要 由 Spring loC 容器 管理 的 业务 逻辑 组 件 组 成 。 
DAO 层 : 由 7 个 DAO 组 件 组 成 。 
领域 对 象 层 : 由 7 个 PO 组 成 ， 并 在 Hibernate Session 管理 下 ， 完 成 数据 库 访问 。 
> ”数据 库 服务 层 ， 使 用 MySQL 数据 库存 储 持久 化 数据 。 
因为 本 应 用 采用 的 是 第 9 章 所 介绍 的 贫血 模式 设计 ， 所 以 本 应 用 中 的 领域 对 象 实际 上 只 是 一 些 简 
单 的 Java Bean 类 ， 并 未 提供 任何 业务 逻辑 方法 ， 所 有 业务 逻辑 方法 由 系统 的 业务 逻辑 组 件 来 提供 。 
贫血 模式 简单 、 直 接 ， 系 统 分 层 清晰 ， 比 较 适 用 于 实际 开发 。 
整个 系统 的 结构 图 如 图 10.1 所 示 。 


bt 


用 户 界面 
和 


MR 
uP 


图 10.1 系统 结构 图 


在 图 10.1 中 黑色 大 方 框 内 的 业务 逻辑 、DAO 组 件 和 领域 对 象 等 组 件 ， 都 由 Spring IoC 容器 负责 
生成 ， 并 管理 组 件 的 实例 。 


》>》>10.1.5 系统 的 功能 模块 


本 系统 可 以 大 致 分 为 两 个 模块 ， 经 理 模块 和 员工 模块 ， 其 主要 业务 逻辑 通过 EmpManager 和 
MgrManagere 两 个 业务 逻辑 组 件 实现 ， 因 此 可 以 使 用 这 两 个 业务 逻辑 组 件 来 封装 DAO 组 件 。 
pe 生 汪 7 抽 半生 aa 
所 通常 建议 按 细 粒 度 的 模块 来 设计 Service 组 件 ， 让 业务 逻辑 组 件 来 作为 DAO 组 件 的 门 : 
面 ， 这 符合 门面 模式 的 设计 。 同时 让 DAO 组 件 来 负责 系统 持久 化 逻辑 ， 可 以 将 系统 在 持 | 
| 。 和 久 化 技术 这 个 维度 上 的 变化 独立 出 去 ， 而 业务 逻辑 组 件 负责 业务 逻辑 这 个 维度 上 的 改变 。 ] 
系统 以 业务 逻辑 组 件 作为 DAO 组 件 的 门面 ， 正面 封装 这 些 DAO 组 件 , 业务 逻辑 组 件 底层 依赖 于 
这 些 DAO 组 件 ， 向 上 实现 系统 的 业务 逐 辑 功能 
本 系统 主要 有 如 下 7 个 DAO 对 象 。 
> ”ApplicationDao: 提供 对 app_table 表 的 基本 操作 。 
> AttendDao: 提供 对 attend_table 表 的 基本 操作 。 
> AttendTypeDao: 提供 对 type_table 表 的 基本 操作 。 
> ”CheckBackDao: 提供 对 check_table 表 的 基本 操作 。 
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> ”EmployeeDao: 提供 对 emp_table 表 的 基本 操作 。 

> ”ManagerDao: 提供 对 mgr_table 表 的 基本 操作 。 

> ”PaymentDao: 提供 对 pay_table 表 的 基本 操作 。 

本 系统 还 提供 了 如 下 两 个 业务 逻辑 组 件 。 

> ”EmpManager: 提供 Employee 角色 所 需 业 务 逻 辑 功 能 的 实现 。 

> ”MgrManager: 提供 Manager 角色 所 需 业 务 逻 辑 功 能 的 实现 。 

本 应 用 的 中 间 层 主要 由 这 9 个 组 件 组 成 ，9 个 组 件 之 间 的 结构 关系 如 图 10.2 所 示 。 


2 3 
图 10.2 系统 组 件 结构 图 


10.2 Hibernate 持久 层 


通过 使 用 Hibernate 持久 层 ， 可 以 避免 使 用 传统 的 JDBC 方式 来 操作 数据 库 ， 通 过 利用 Hibernate 
提供 的 O/R Mapping 支持 ， 从 而 允许 程序 使 用 面向 对 象 的 方式 来 操作 关系 数据 库 ， 保 证 了 整个 软件 开 
发 过 程 以 面向 对 象 的 方式 进行 ， 即 面向 对 象 分 析 、 面 向 对 象 设计 、 面 向 对 象 编程 。 


10.2.1 设计 持久 化 实体 


面向 对 象 分 析 ， 是 指 根据 系统 需求 提取 应 用 中 的 对 象 ， 将 这 些 对 象 抽 象 成 类 ， 再 抽取 出 需要 持久 
化 保存 的 类 ， 这 些 需要 持久 化 保存 的 类 就 是 持久 化 对 象 (PO )。 该 系统 并 没有 预先 设计 数据 库 ， 而 是 
完全 从 面向 对 象 分 析 开 始 ， 设 计 了 7 个 持久 化 类 。 
本 系统 一 共 包含 如 下 7 个 持久 化 类 。 
> ”Application: 对 应 普通 员工 的 考勤 提出 申请 ， 包 括 申请 理由 、 是 否 被 批复 及 申请 改变 的 类 型 
等 属性 。 
> ”Attend: 对 应 每 天 的 考勤 ， 包 含 考勤 时 间 、 考 勤 员 工 、 是 否 上 班 及 考勤 类 别 等 信息 。 
> ”AttendType: 对 应 考勤 的 类 别 ， 包 含 考勤 的 名 称 ， 如 迟到 、 早 退 等 名 称 。 
> ”CheckBack: 对 应 批复 ， 包 含 该 批复 对 应 的 申请 ， 是 否 通过 申请 ， 由 哪个 经 理 完成 批复 等 属性 。 
> ”Employee: 对 应 系统 的 员工 信息 ， 包 含 员工 的 用 户 名 、 密 码 、 工 资 以 及 对 应 的 经 理 等 属性 。 
> ”Manager: 对 应 系统 的 经 理 信息 , 仅 包含 经 理 管 理 的 部 门 名 。 实 际 上 ,Manager 继承 Employee 
类 ， 因 此 该 类 同样 包含 Employee 的 所 有 属性 。 
> ” Payment: 对 应 每 月 所 发 的 薪水 信息 ， 包 含 发 薪 的 月 份 、 领 薪 的 员工 及 薪资 数 等 信息 。 
在 富 领域 模式 的 设计 中 ， 这 7 个 PO 对 象 也 应 该 包含 系统 的 业务 逻辑 方法 ， 也 就 是 使 用 领域 对 象 
来 为 它们 建 模 ， 但 因为 本 应 用 采用 贫血 模式 来 设计 它们 ， 所 以 我 们 不 打算 为 它们 提供 任何 业务 逻辑 方 
法 ， 而 是 将 所 有 业务 逻辑 方法 放 到 业务 有 逻辑 组 件 中 实现 。 
当 采 用 贫血 模式 的 架构 模型 时 ， 系 统 中 的 领域 对 象 十 分 简洁 ， 它 们 都 是 单纯 的 数据 类 ， 不 需要 考 
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虑 到 底 应 该 包含 哪些 业务 逻辑 方法 ， 因 此 开发 起 来 非常 便捷 ， 而 系统 的 所 有 业务 逻辑 都 由 业务 逻辑 组 
件 负责 实现 ， 从 而 避免 将 业务 逻辑 的 变化 限制 在 业务 逻辑 层 内 ， 避 免 扩 散 到 两 个 层 ， 从 而 降低 了 系统 
的 开发 难度 。 

客观 世界 中 的 对 象 不 是 孤立 存在 的 ， 以 上 7 个 PO 类 也 不 是 孤立 存在 的 ， 它 们 之 间 存在 复杂 的 关 
联 关 系 。 分 析 关 联 关 系 既是 面向 对 象 分 析 的 必要 步骤 ， 也 是 Hibermate 进行 持久 化 操作 的 必 经 之 路 。 
这 7 个 PO 的 关联 关系 如 下 : 


> 


bs 
> 


> 


> 
> 


> 


Employee 是 Manager 的 父 类 , 同时 Manager 和 Employee 之 间 存在 1 一 NN 的 关系 ， 即 一 个 
Manager 对 应 多 个 Employee， 但 每 个 Employee 只 能 对 应 一 个 Manager。 

Employee 和 Payment 之 间 存 在 1 一 N 的 关系 ， 即 每 个 员工 可 以 多 次 领取 薪水 。 

Employee 和 Attend 之 间 存 在 1 一 N 的 关系 ， 即 每 个 员工 可 以 参与 多 次 考勤 ， 但 每 次 考勤 只 
对 应 一 个 员工 。 

Manager 继承 了 Employee 类 ， 因 此 具有 Employee 的 全 部 属性 。 另 外 ，Manager 还 与 
CheckBack 之 间 存在 1 一 N 的 关系 。 

Application 与 Attend 之 间 存 在 N 一 1 的 关系 ， 即 每 个 Attend 可 以 被 对 应 多 次 申请 。 
Application 与 AttendType 之 间 存在 N 一 1 的 关系 ， 即 每 次 申请 都 有 明确 的 考勤 类 型 ， 而 一 
个 考勤 类 型 可 包含 多 个 申请 。 

Attend 与 AttendType 之 间 存 在 N 一 1 的 关系 ， 即 每 个 Attend 只 属于 一 个 AttendType。 


图 103 7 个 PO 之 间 的 类 关系 图 
》>》>10.2.2 创建 持久 化 实体 类 


从 图 10.3 可 以 看 出 ， 持 久 化 对 象 之 间 的 关联 关系 以 属性 的 方式 表现 出 来 ， 当 然 ， 这 些 属性 同样 需 
要 setter 和 getter 方法 的 支持 ， 持 久 化 类 之 间 的 关联 关系 通常 对 应 数据 库 里 的 主 、 外 键 约束 。 

除 此 之 外 ， 持 久 化 对 象 还 有 自己 的 普通 属性 ， 这 些 普通 属性 通常 对 应 数据 库 的 字段 。 

Hibernate 对 于 持久 化 对 象 并 没有 太 多 额外 的 要 求 ， 只 要 求 持久 化 对 象 提供 无 参数 的 构造 器 ， 如 果 
需要 将 这 些 对 象 放 入 HashSet 集合 中 ， 还 应 该 根据 实际 需要 重 写 hashCode() 和 equals() 两 个 方法 。 

下 面 是 Employee 持久 化 的 源 代码 。 

程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Employee.java 

public class Employee 


{ 
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implements Serializable 


private static final long serialVersionUID = 48L; 
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// 标 识 属性 

private Integer id; 

// 员 工 姓名 

private String name; 

// 员 工 密码 

private String pass; 

// 员 工 工 资 

private double salary; 

// 员 工 对 应 的 经 理 

private Manager manager; 

// 员 工 对 应 的 出 勤 记 录 

Private Set<Attend> attends = new HashSet<httend> ()7 
// 员 工 对 应 的 工资 支付 记录 

private Set<Payment> payments = new HashSet<Payment>(); 
// 无 参数 的 构造 器 

public Employee() 

{ 


} 

// 初 始 化 全 部 属性 的 构造 器 

public Employee(Integer id , string name , String pass , 
double salary , Manager manager , 
Set<Attend> attends , Set<Payment> payments) 


this.id = id; 
this.name = name; 
this.pass = pass; 
this.salary = salary; 
this.manager = manager; 
this.attends = attends， 
this.payments ~ payment: 


} 
// 省 略 普通 属性 的 setter 和 getter 方法 


//manager 属性 的 setter 和 getter 方法 
public void setManager (Manager manager) 
{ 


this.manager = manager; 


} 
public Manager getManager() 
{ 


return this.manager; 


//attends 属性 的 setter 和 getter 方法 
public void setAttends(Set<Attend> attends) 
{ 

this.attends = attends; 


} 
public Set<Attend> getAttends() 
return this.attends; 


} 
//payments 属性 的 setter 和 getter 方法 
public void setPayments (Set<Payment> payments) 
{ 
this.payments = payments; 
} 
public Set<Payment> getPayments() 
{ 


return this.payments; 


// 量 写 equals 0 方法 ， 只 要 name、pass 相同 的 员工 即 认为 相等 。 
ess boolean equals (Object obj) 


if (this 一 obj) 
{ 

return true; 
} 
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if (obj != null 5 
obj .getClass () 一 Employee.class) 
{ 
Employee employee = (Employee)obj; 
return this.getName() .equals (employee. getName()) 
55 this.getPass() .equals (employee.getPass()); 
} 
return false; 


} 
// 根 据 员工 的 name、pass 来 计算 hashcode 值 
public int hashCode() 
return name.hashCode() 
+ pass.hashCode() * 17; 
} 
} 


对 Hibernate 而 言 ， 完 全 支持 将 普通 的 POJO 映射 成 PO， 但 这 些 POJO 应 尽量 遵守 如 下 规则 : 

> ”提供 实现 一 个 默认 的 〈 无 参数 的 ) 构造 器 。 

> ”提供 一 个 标识 属性 (identifier property) 用 于 标识 该 实例 。 

> ”使 用 非 final 的 类 。 尽 量 避免 将 POJO 声明 成 fnal， 这 将 导致 其 性 能 下 降 一 一 因为 Hibernate 

无 法 为 final 类 的 对 象 创建 动态 代理 ， 也 就 无 法 使 用 代理 模式 来 提高 性 能 了 。 

除 此 之 外 , 因为 本 系统 中 Employee 对 象 里 的 用 户 名 是 唯一 的 , 所 以 我 们 可 以 根据 name 属性 类 重 写 
Employee 类 的 equals0 和 hashCode() 两 个 方法 。 正 如 前 面 我 们 介绍 Hibernate 时 提 到 的 ， 不 要 根据 标识 属 
性 来 重 写 equals0 和 hashCode0 方 法 ， 因 为 持久 化 对 象 处 于 瞬 态 时 ， 这 些 对 象 的 标识 属性 值 可 能 是 null。 

下 面 给 出 另外 两 个 持久 化 类 的 源 代码 ， 一 个 是 Employee 的 子 类 ， 和 需要 使 用 继承 映射 ， 另 一 个 是 
Employee 的 关联 类 ， 需 要 使 用 关联 映射 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Manager.java 


public class Manager 
extends Employee implements Serializable 


private static final long serialVersionUID = 48L; 
// 该 经 理 管理 的 部 门 
private String dept; 
// 该 经 理 对 应 的 所 有 员工 
private Set<Employee> employees = new HashSet<Employee>(); 
// 该 经 理 签署 的 所 有 批复 
private Set<CheckBack> checks ~ new Hashset<CheckBack>(); 
// 无 参数 的 构造 器 
public Manager() 
{ 
)} 
// 初 始 化 全 部 属性 的 构造 器 
public Manager (String dept , Set<Employee> employees 
， Set<CheckBack> checks) 
{ 
this.dept = dept; 
this.employees = employees; 
this.checks = checks; 


7 属性 的 setter 和 getter 方法 
Public void setDept(String dept) 
this.dept = dept; 

Mi String getDept () 

; return this.dept; 


} 
//employees 属性 的 setter 和 getter 方 法 
Public void setEmployees (Set<Employee> employees) 
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{ 
this.employees = employees; 


} 
public Set<Employee> getEmployees() 
{ 


return this.employees; 


} 
//checks 属性 的 setter 和 getter 方法 
Public void setChecks (Set<CheckBack> checks) 
{ 
this.checks = checks; 


public Set<CheckBack> getchecks() 
{ 


return this.checks; 
} 
} 


上 面 程序 中 的 粗 体 字 代码 提供 了 checks 和 employees 两 个 属性 的 setter 和 getter 方法 , 这 两 个 属性 
用 于 保留 Manager 所 关联 的 实体 ， CheckBack 和 Employee， 一 个 Manager 可 对 应 多 个 CheckBack， 一 
个 Manager 可 对 应 多 个 Employee。 
程序 清单 :codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Attend java 
public class Attend 


implements Serializable 


{ 
private static final long serialVersionUID = 48L; 


// 代 表 标 识 属性 
private Integer id; 


// 出 勤 日 期 
private String dutyDay; 


// 打 卡 时 间 
private Date punchTime; 


// 代 表 本 次 打卡 是 否 为 上 班 打卡 
private boolean isCome; 
// 本 次 出 惑 的 类 型 

private AttendType type; 
// 本 次 出 勤 关联 的 员工 

private Employee employee; 
// 无 参数 的 构造 器 

public Attend() 


{ 


} 

// 初 始 化 全 部 属性 的 构造 器 

public Attend(Integer id , String dutyDay ， 
Date punchTime , boolean isCome ， 


AttendType type , Employee employee) 
this.id = id 
this.dutyDay = dutyDay; 
this.punchTime = punchTime; 
this.isCome = isCome; 
this. type = type; 
this.employee = employee; 

} 

// 省 略 普通 属性 的 setter 和 getter 方法 


//type 属性 的 setter 和 getter 方法 
Public void setType (AttendType type) 
{ 


this. type = type; 
} 
Public AttendType getType() 
{ 

return this.type; 
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} 

//employee 属性 的 setter 和 getter 方法 

Public void setEmployee (Employee employee) 
{ 


this employee = employee; 

i Employee getEmployee() 

b return this.employee; 

/根据 employee、isCome、dutyDay 来 重 写 equals 方法 


public boolean equals (Object obj) 
{ 


if (this == obj) 
{ 
return true; 
】 
if (obj != null 66 
obj.getClass() == Attend.class) 
{ 
Attend attend = (Attend)obj; 
return getEmployee() .equals (attend.getEmployee()) 
66 getDutyDay() .equals (attend.getDutyDay()) 
56 getIsCome() == attend.getIsCome(); 
} 
return false; 
} 
7/ 根据 employee、isCome、dutyDay 来 重 写 hashcode () 方 法 
public int hashCode () 
{ 
if (getIsCome()) 
{ 
return dutyDay.hashCode() + 
29 * employee.hashCode() + 17 
} 
return dutyDay.hashCode() + 
29 * employee.hashCode(); 
) 
} 


上 面 程序 中 两 段 粗 体 字 代码 也 用 于 提供 Attend 和 AttendType、Employee 之 间 的 关联 关系 ， 多 个 
Attend 对 象 对 应 一 个 AttendType 对 象 ， 多 个 Attend 对 象 对 应 一 个 Employee 对 象 。 


>>10.2.3 映射 持久 化 实体 


在 面向 对 象 分 析 的 阶段 中 ， 最 重要 的 任务 就 是 提取 类 ， 并 分 析 对 象 之 间 的 关联 关系 。 本 实例 中 的 
关联 关系 多 表现 为 1 一 N 关联 。 对 于 1 一 NN 的 关联 ， 假 设 要 实现 一 个 简单 的 从 Parent 到 Child 的 1 一 N 
关联 ， 其 映射 代码 如 下 : 

<!-- 关联 的 持久 化 对 象 集合 一 > 

<set name="children"> 
<!-- 胰 射 外 键 列 的 列 名 -> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 


如 果 采 用 如 下 代码 关联 Parent 与 Child 的 关系 : 
Parent p = new Person; 

Child ce = new Child(); 

p.getchildren() .add(c); 

session,.save(c); 

Session.flush(); 


Hibernate 会 产生 两 条 SQL 语句 : 
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> 一 条 INSERT 语句 ， 为 c 创建 一 条 记录 。 

> 一 条 UPDATE 语句 ， 创 建 从 p 到 c 的 关联 。 

采用 这 种 方式 不 仅 效率 低 ,而 且 违反 了 列 parent_id 非 空 的 约束 。 我 们 可 以 通过 在 集合 类 映射 上 指 
定 not-null="true" 来 解决 此 问题 : 


<set name="children"> 
<!-- 增加 非 空 约束 一 > 
<key column="parent_id" not-null="true"/> 
<one-to-many class="Child"/> 

</set> 


产生 这 种 现象 的 根本 原因 是 : 程序 保存 c 实体 时 ，p 到 e 的 关联 并 没有 成 为 Child 实体 的 一 部 分 ， 
因而 在 INSERT 语句 中 没有 创建 该 外 键 值 ， 解 决 的 办 法 是 将 关联 添加 到 Child 的 映射 中 。 


<many-to-one name="parent" 
column="parent_id" not-null="true"/> 


并 改 为 由 实体 Child 来 管理 关联 ， 为 了 使 Collection 不 更 新 连接 ， 设 置 inverse="true"， 如 下 所 示 : 
<!-- 1 的 一 端 不 再 管理 关联 --> 
<set name="children" inverse="true"> 
<key column="parent_id"/> 
<one-to-many class="Child"/> 
</set> 


下 面 的 代码 用 来 添加 一 个 新 的 Child: 
Parent p = new Parent(); 
Child c = new Child(); 
c.setParent (p); 
session.save (c); 
session,.flush{(); 


现在 ， 只 会 有 一 条 INSERT 语句 被 执行 。 为 了 让 Person 端 也 可 以 “管理 关联 "， 可 以 为 Parent 加 
-个 addChild0 方 法 。 
// 由 Parent 管理 关联 的 方法 
public void addchild (Child c) 


{ 
// 实 际 依然 由 Child 一 端 控 制 关联 
c.setParent (this); 
children.add(c); 

} 


另外 ， 也 可 以 通过 如 下 方式 来 增加 它们 之 间 的 关联 。 


Parent p = new Person 
Child c = new Child(); 
p.addchild(c); 
session. save (c); 
session.flush(); 


通过 上 面 的 讨论 , 对 于 1 一 N 的 关联 关系 , 通常 推荐 映射 成 双向 关联 , 而 且 由 N 的 一 端 控制 关联 关系 。 


i 
-得 -注意 :和 - 
对 所 有 1 -和 的 关联 关系 ， 建 议 不 要 使 用 “1” 的 一 端 控制 关系 ， 因 此 建议 为 <set.… 


元 素 增加 inverse="true" 属 性 ， 让 “N” 的 一 端 来 控制 关联 关 


除 此 之 外 ， 分 析 对 象 之 间 的 继承 层次 也 是 非常 重要 的 任务 。 在 面向 对 象 设计 里 ， 继 承 是 软件 复 用 
的 重要 手段 (实际 上 ， 对 应 设计 良好 的 架构 ， 我 们 更 推荐 使 用 组 合 来 代替 继承 ， 因 为 继承 会 破坏 父 类 
的 封装 )。 在 本 系统 中 Manager 类 继承 Employee 类 。 

Hibernate 支持 如 下 三 种 继承 映射 策略 。 

> ”<subclass.…./> 元 素 映射 子 类 : 用 一 张 表 存 储 整个 继承 树 的 全 部 实例 。 
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> ”<joined-subclass.…/> 元 素 映射 子 类 : 继承 树 的 每 层 实例 对 应 一 张 表 ， 且 基 类 的 表 中 保存 所 有 
子 类 的 公有 列 ， 因 此 如 需 创建 子 类 实例 ,总 是 需要 查询 基 类 的 表 数据 ,其 子 类 所 在 深度 越 深 ， 
查询 涉及 的 表 就 越 多 。 
> ”<unioned-subclass..…/> 元 素 映 射 子 类 : 继承 树 的 每 层 实例 对 应 一 张 表 ， 每 层 的 实例 完整 地 保 
存在 对 应 的 表 中 ， 表 中 的 每 条 记录 即 可 对 应 一 个 实例 。 
关于 继承 策略 的 选择 , 本 示例 程序 使 用 <subclass... 人 > 继承 映射 策略 , 这 种 映射 策略 会 把 整 棵 继承 树 
的 所 有 实例 都 保存 在 一 张 数 据 表 内 ， 因 此 子 类 增加 的 数据 列 都 不 能 有 非 空 约束 ， 即 使 实际 需要 添加 非 
空 约束 也 不 行 。 但 这 种 映射 策略 的 性 能 最 好 ， 无 论 应 用 程序 是 需要 查询 子 类 的 实体 ， 还 是 进行 多 态 查 
询 ， 都 只 需要 在 一 个 表 中 进行 查询 即 可 。 
- 且 映 射 了 合适 的 继承 策略 ，Hibernate 完全 可 以 理解 多 态 查 询 ， 当 查询 Parent 类 的 实例 时 ， 所 有 
Parent 子 类 的 实例 也 可 被 查询 到 。 
下 面 是 本 系统 所 使 用 的 6 个 映射 文件 。 
Employee 和 Manager 的 映射 文件 如 下 。 
程序 清单 :codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Employee.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 

<!-- 指定 hibernate 映射 文件 的 DTD 信息 --> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 


"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- Hibernate 映射 文件 的 根 元 素 -> 
<hibernate-mapping package="org.crazyit.hrsystem.domain"> 
<class name="Employee" table="emp. table" 


<!-- 使 用 只 读 缓存 

<cache usage="read-on1y"/> 

<!-- 映射 标识 属性 --> 

<id name="id" type="integer" column="emp_id"> 
<!-- 指定 使 用 identity 主键 生成 策略 --> 
<generator class="identity"/> 

</id> 

<discriminator column="emp_type” type="int"/> 

<!-~ 映射 普通 属性 --> 

<property name="name" column="emp_name" type="string" 
not-null="true" length="50" unique="true"/> 

<property name="pass" column="emp_pass" type="string" 
not-null="t! length="50"/> 

<property name="salary" column="emp_salary" type="double" 
not-null="true" /> 

<!-- 映射 和 Manager 的 关联 关系 一 > 

<many-to-one name="manager" column="mgr_id" 


class="Manager" lazy="false"/> 
<!-- 映射 和 Attend 之 间 的 关联 关系 --> 
<set name="attends" inverse="true"> 
<key column="emp_id" /> 
<one-to-many class="Attend"/> 
</set> 
<!-- 映射 和 Payment 之 间 的 关联 关系 -> 
<set name="payments" inverse="true"> 
<key column="emp_id" /> 
<one-to-many class="Payment"/> 
</set> 
<!-- 映射 Employee 的 子 类 Manager --> 
<subclass name="Manager" discriminator-value="2"> 
<!-- 映射 Manager 的 普通 属性 -> 
<property name="dept" column="dept_name" 
type="string" length="50"/> 
<!-- 映射 和 Employee 之 间 的 关联 关系 --> 
<set name="employees" inverse="true"> 
<key column="mgr idn /> 
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<one-to-many class="Employee"/> 

</set> 

<!-- 映射 和 CheckBack 之 间 的 关联 关系 

<set name="checks" inverse="true"> 
<key column="mgr_id" /> 
<one-to-many class="CheckBack"/> 

</set> 

</subclass> 
</class> 
</hibernate-mapping> 


Attend 的 映射 文件 如 下 。 
程序 清单 :codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Attend.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- Hibernate 映射 文件 的 根 元 素 =--> 
<hibernate-mapping package="org.crazyit:hrsystem.domain"> 
<class name="Attend"” table="attend table"> 
<!-- 使 用 只 读 缓存 一 > 
<cache usage="read-only"/> 
<!-- 肌 射 标识 属性 --> 
<id name="id" type="integer" column="attend_id"> 
- 指定 使 用 identity 主键 生成 策略 -> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 -一 > 
<property name="dutyDay”" column="duty_day" 
type="string" not-null="true" length="50"/> 
<property name="punchTime" column="punch_time" 
type="java.util. Date" /> 
sCome" columne="is_come™ 
type="boolean" not-null="true"/> 
<!-- 映射 和 AttendType 之 间 的 关联 关系 --> 
<many-to-one name="type" column="type_id" 
class="AttendType" not-null="true" lazy="false"/> 
<!-- 映射 和 Employee 之 间 的 关联 关系 --> 
<many-to-one name="employee” column="emp_id" 
class="Employee" not-null="true" lazy="false"/> 


</class> 
</hibernate-mapping> 


AttendType 的 映射 文件 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\AttendType.hbm.xml 


<?xml version="l.0" encoding="GBK"?> 
<!-- 指定 Hibernate 映射 文件 的 DTD 信息 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3,0.dtd"> 
<!-- Hibernate 映射 文件 的 根 元 素 --> 
<hibernate-mapping Package="org.cr: 


it.hrsystem. domain"> 


<cache usage="read-only"/> 
<!-- 映射 标识 属性 -> 

<id name="id" type="integer" column="type_id"> i 
指定 使 用 identity 主键 生成 策略 --> 


<generator class="identity"/> 


<property name="name" column="type_name" 
tring" not-null="true" length="50"/> 
<property name="amerce" column="amerce_amount™ 
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type="double" not-null="true" /> 
</class> 
</hibernate-mapping> 


Application 的 映射 文件 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Application.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 映射 文件 的 DTD 信息 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN” 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">. 
<!-- Hibernate 映射 文件 的 根 元 素 一 > 
<hibernate-mapping package="org.crazyit.hrsystem.domain"> 
<class name="Application" table="app. table"> 
<!-- 使 用 只 读 缓存 --> 
<cache usage="read-only"/> 
<!-- 映射 标识 属性 -> 
<id name="id" type="integer" column: 
<!-- 指定 使 用 identity 主键 生成 策略 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 --> 
<property name="reason" column="app_reason" 
type="string" length="50"/> 
<property name="result" column="app_result” 
type="boolean"/> 
<!-- 肌 射 和 attendType 的 关联 关系 --> 
<many-to-one name="type" column="type_id" 
class="AttendType" not-null="true" lary="false"/> 
<!-- 映射 和 Attend 的 关联 关系 --> 
<many-to-one name="attend" column="attend_id" 
class="Attend" not-null="true" lazy="false"/> 
<!-- 映射 和 CheckBack 的 关联 关系 --> 
<one-to-one name="check" property-ref="app"/> 
</class> 
</hibernate-mapping> 


CheckBack 的 映射 文件 如 下 。 
程序 清单 :， codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\CheckBack.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN™ 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- Hibernate 映射 文件 的 根 元 素 --> 
<hibernate-mapping package="org.crazyit.hrsystem.domain"> 
<class name="CheckBack" table="check_table"> 
<!-- 使 用 只 读 缓存 一 > 
<cache usage="read-only"/> 3 
<!-~ 映射 标识 属性 --> 
<id name="id" type="integer" column="check_id"> 
<!-~ 指定 使 用 identity 主键 生成 策略 --> 
<generator class="identity"/> 
</id> 
<!-- 映射 普通 属性 -> 
<property name="reason” column="check_reason" 
type="string" length="50"/> 
<property name="result" column="check_result™ 
type="boolean" length="50" not-null="true"/> 
<!-- 映射 和 Application 的 关联 关系 --> 
<many-to-one name="app" column="app_id" not-null="true" 
class="Application" unique="true" lazy="false"/> 
<!-- 映射 和 Manager 的 关联 关系 --> 
<many-to-one name="manager" column="mgr_id" 
class="Manager" not-null="true" lazy="false"/> 


"app_id"> 
> 
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</class> 
</hibernate-mapping> 


Payment 的 映射 文件 如 下 。 
程序 清单 :codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\domain\Payment.hbm.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Hibernate 映射 文件 的 DTD 信息 --> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate’ Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
<!-- Hibernate 映射 文件 的 根 元 素 -> 
<hibernate-mapping package="org.crazyit.hrsystem. donain"> 
‘<class name="Payment" table="pay_table"> 
<!-- 使 用 只 读 缓存 -> 
<cache usage="read-only"/> 
<!-~ 映射 标识 属性 --> 
<id name="id" type="integerw column="pay_id"> 
<!-- 指定 使 用 identity 主键 生成 策略 --> 
<generator class="identity"/> 


<property name="payMonth" column="pay_month" 
type="string" not-null="true" length="50"/> 

<property name="amount" column="pay_amount™ 
type="double" not-null="true"/> 

<!-- 映射 和 Employee 的 关联 关系 一 > 

<many-to-one name="employee" column="emp_id" 
class="Employee" not-null="true" lazy="false"/> 

</class> 
</hibernate-mapping> 


正如 前 面 所 介绍 的 ， 所 有 的 set 元 素 都 被 加 上 inverse="true" 声 明 ， 让 “N” 的 一 端 控 制 关联 关系 ， 
而 不 要 让 “1” 的 一 端 控制 关联 关系 。 


10.3 实现 DAO 层 


在 Hibernate 持久 层 之 上 ， 可 使 用 DAO 组 件 再 次 封装 数据 库 操作 ， 这 也 是 Java EE 应 用 里 常用 的 
DAO 模式 。 当 使 用 DAO 模式 时 ， 既 体现 了 业务 逻辑 组 件 封 装 DAO 组 件 的 门面 模式 ， 也 可 分 离 业务 
逻辑 组 件 和 DAO 组 件 的 功能 : 业务 逻辑 组 件 负责 业务 逻辑 的 变化 ， 而 DAO 组 件 负责 持久 化 技术 的 变 
化 ， 这 正 是 桥接 模式 的 应 用 。 

引入 DAO 模式 后 ， 每 个 DAO 组 件 包含 了 数据 库 的 访问 逻辑 ， 每 个 DAO 组 件 可 对 一 个 数据 库 表 
完成 基本 的 CRUD 等 操作 。 

DAO 模式 的 实现 至 少 需要 如 下 三 个 部 分 : 

> DAO 工厂 类 。 

> ”DAO 接口 。 

> ”DAO 接口 的 实现 类 。 

DAO 模式 是 一 种 更 符合 软件 工程 的 开发 方式 ， 使 用 DAO 模式 有 如 下 理由 : 

> ”DAO 模式 抽象 出 数据 访问 方式 , 业务 逻辑 组 件 无 须 理会 底层 的 数据 库 访问 细节 , 而 只 专注 于 

业务 逻辑 的 实现 ， 业 务 逻 辑 组 件 只 负责 业务 功能 的 改变 。 
> ”DAO 将 数据 访问 集中 在 独立 的 一 层 , 所 有 的 数据 访问 都 由 DAO 对 象 完成 , 这 层 独立 的 DAO 
分 离 了 数据 访问 的 实现 与 其 他 业务 逻辑 ， 使 得 系统 更 具 可 维护 性 。 

> ”DAO 还 有 助 于 提升 系统 的 可 移植 性 。 独 立 的 DAO 层 使 得 系统 能 在 不 同 的 数据 库 之 间 轻 易 切 
换 ， 底 层 的 数据 库 实现 对 于 业务 逻辑 组 件 是 透明 的 。 数 据 库 移植 时 仅仅 影响 DAO 层 ， 不 同 
数据 库 的 切换 不 会 影响 业务 逻辑 组 件 ， 因 此 提高 了 系统 的 可 复 用 性 。 
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> ”对 于 不 同 的 持久 层 技术 ,Spring 的 DAO 提供 一 个 DAO 模板 ,将 通用 的 操作 放 在 模板 里 完成 ， 
而 对 于 特定 的 操作 ， 则 通过 回调 接口 完成 。 
Spring 为 Hibernate 提供 的 DAO 支持 类 是 : HibernateDaoSupport。 


>>10.3.1 DAO 组 件 的 定义 


DAO 组 件 提供 了 各 持久 化 对 象 的 基本 的 CRUD 操作 。 而 在 DAO 接口 里 则 对 DAO 组 件 包 含 的 各 
种 CRUD 方法 提供 了 声明 , 但 有 一 些 IDE 工具 也 可 以 生成 基本 的 CRUD 方法 。 使 用 DAO 接口 的 原因 
是 : 避免 业务 逻辑 组 件 与 特定 的 DAO 组 件 耦合 

由 于 DAO 组 件 中 的 方法 不 是 一 开始 就 设计 出 来 的 ， 其 中 的 很 多 方法 可 能 会 随 着 业务 逻辑 的 需求 
而 增加 ， 但 以 下 几 个 方法 是 通用 的 。 

> ”get(Serializable id): 根据 主键 加 载 持久 化 实例 。 
save(Object entity): 保存 持久 化 实例 。 
update(Object entity): 更 新 持久 化 实例 。 
delete(Object entity): 删除 持久 化 实例 。 
delete(Serializable id): 根据 主键 来 删除 持久 化 实例 。 
findAIl(): 获取 数据 表 中 全 部 的 持久 化 实例 。 

DAO 接口 无 须 给 出 任何 实现 ， 仅 仅 是 DAO 组 件 包含 的 CRUD 方法 的 定义 , 这 些 方法 定义 的 实现 
取决 于 底层 的 持久 化 技术 ，DAO 组 件 的 实现 既 可 以 使 用 传统 JDBC， 也 可 以 采用 Hibernate 持久 化 技 
术 ， 以 及 iBATIS 等 技术 。 下 面 是 关于 DAO 接口 的 源 代码 。 

ApplicationDao 的 接口 定义 如 下 。 

程序 清单 :，codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\ApplicationDao.java 

public interface ApplicationDao 


YR 


La 
* 根据 标识 属性 来 加 载 Application 实例 

* eparam id 需要 加 载 的 Application 实例 的 标识 属性 值 
* Breturn 指定 标识 属性 对 应 的 application 实例 

wp 

Application get(Integer id); 

Wr 


* 持久 化 指定 的 Application 实例 

* @param application 需要 被 持久 化 的 Application 实例 
* @return Application 实例 被 持久 化 后 的 标识 属性 值 

a 
Integer save (Application application); 
as 

* 修改 指定 的 Application 实例 ry 
* @param application 和 需要 被 修改 的 Application 实例 
sf 
void update (Application application); 

2 


* 删除 指定 的 Application 实例 
* eparam application 需要 被 删除 的 Application 实例 
区 
void delete (Application application); 
J 
* 根据 标识 属性 删除 Application 实例 
* Bparam id 需要 被 咕 除 的 Application 实例 的 标识 属性 值 
i 
void delete(Integer id); 
Je» 
* 查询 全 部 的 Application 实例 
* return 数据 库 中 全 部 的 Application 实例 
*/ v 


List<Application> findAl1(); 
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Ja 
蜀 ed 和 
* Bparam emp 需要 查询 的 员 
* @return 度 员 了 对 让 的 处 的 异动 申请 
bt 
List<Application> findByEmp (Employee emp); 
+ 


AttendDao 的 接口 定义 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\AttendDao.java 


public interface AttendDao 
{ 
us 
* 根据 标识 属性 来 加 载 Attend 实例 
* @param id 需要 加 载 的 Attend 实例 的 标识 属性 值 
* areturn 指定 标识 属性 对 应 的 Attend 实例 
NR 


Attend get{(Integer id); 

/us 

* 持久 化 指定 的 Attend 实例 

* @param attend 需要 被 持久 化 的 Attend 实例 
* @return Attend 实例 被 持久 化 后 的 标识 属性 值 
ay 

Integer save(Rttend attend); 

/un 

* 修改 指定 的 Attend 实例 

* Bparam attend 需要 被 修改 的 Attend 实例 
eh 

void update (Attend attend); 

/us 

* 删除 指定 的 Attend 实例 

* eparam attend 需要 被 刷 除 的 Attend 实例 
a 

void delete(Attend attend); 

/un 

* 根据 标识 属性 删除 Attend 实例 

* @param id 需要 被 制 除 的 Attend 实例 的 标识 属性 值 
证 


void delete(Integer id); 
us 
* 查询 全 部 的 Attend 实例 
* @return 数据 库 中 全 部 的 Attend 实例 
*) 


List<Attend> findAl1(); 

a 

* 根据 员工 查询 该 员工 的 打卡 记录 
* @param emp 员工 

* @return 该 员工 的 全 部 出 勤 记 录 
2 


List<Attend> findByEmp (Employee emp); 
pe 

* 根据 员工 、 日 期 查询 该 员工 的 打卡 记录 集合 

* @param emp 员工 

* Bparam dutyDay 日 期 

和 > 该 员工 的 某 天 的 打卡 记录 集合 


i findByEmpAndDutyDay (Employee emp 
, String dutyDay); 

J 

* 根据 员工 、 日 期 、 上 下 班 查询 该 员工 的 打卡 记录 集合 

* 8@param emp 员工 

* eparam dutyDay 日 期 

* eparam isCome 是 否 上 班 

2 该 员工 的 某 天 上 班 或 下 班 的 打卡 记录 
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Attend findByEmpAndDutyDayAndCome (Employee emp , 
String dutyDay , boolean isCome); 

7 

* 查看 员工 前 三 天 的 非 正常 打卡 

* @param emp 员工 

* Breturn 该 员工 的 前 三 天 的 非 正 常 打卡 

7 

List<Attend> findByEmpUnAttend (Employee emp 
, AttendType type); 

} 


AttendTypeDao 的 接口 定义 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\AttendTypeDao.java 


public interface AttendTypeDao 
{ 

J 

* 根据 标识 属性 来 加 载 AttendType 实例 
* @param id 需要 加 载 的 AttendType 实例 的 标识 属性 值 
* @return 指定 标识 属性 对 应 的 AttendType 实例 

Wd 

AttendType get(Integer id); 

Ju 

* 持久 化 指定 的 AttendType 实例 
* @param attendType 需要 被 持久 化 的 AttendType 实例 
* Breturn AttendType 实例 被 持久 化 后 的 标识 属性 值 
id 

Integer save(AttendType attendType); 

/us 
* 修改 指定 的 AttendType 实例 
* Bparam attendType 需要 被 修改 的 AttendType 实例 
* 

void update (AttendType attendType); 

/us 
* 删除 指定 的 AttendType 实例 
* 8param attendType 需要 被 剿 除 的 AttendType 实例 
“f 

void delete(AttendType attendType); 

/es 
* 根据 标识 属性 删除 AttendType 实例 
* Bparam id 需要 被 删除 的 AttendType 实例 的 标识 属性 值 


void delete(Integer id); 
/us 
* 查询 全 部 的 AttendType 实例 
* @return 数据 库 中 全 部 的 AttendType 实例 
w/e 
List<AttendType> findAll(); 
} 


CheckBackDao 的 接口 定义 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\CheckBackDao.java 


public interface CheckBackDao 
| us 
* 根据 标识 属性 来 加 载 CheckBack 实例 
* @param id 需要 加 载 的 CheckBack 实例 的 标识 属性 值 
* @return 指定 标识 属性 对 应 的 CheckBack 实例 
4 
CheckBack get(Integer id)7 
/ex 
* 持久 化 指定 的 CheckBack 实例 
* 8param checkBack 需要 被 持久 化 的 CheckBack 实例 
* Qreturn CheckBack 实例 被 持久 化 后 的 标识 属性 值 
*/ 
Integer save (CheckBack checkBack)7 
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/a 

* 修改 指定 的 CheckBack 实例 

* Eparam checkBack 需要 被 修改 的 CheckBack 实例 

#/ 
void update (CheckBack checkBack); 

/a 

* 删除 指定 的 CheckBack 实例 

* @param checkBack 需要 被 届 除 的 CheckBack 实例 

ei 
void delete (CheckBack checkBack)7 

At 

* 根据 标识 属性 删除 checkBack 实例 

* Gparam id 需要 被 删除 的 CheckBack 实例 的 标识 属性 值 
*/ 
void delete(Integer id); 

* 查询 全 部 的 checkBack 实例 

* 8return 数据 库 中 全 部 的 CheckBack 实例 

人 

List<checkBack> findAll(); 

} 


EmployeeDao 的 接口 定义 如 下 。 
程序 清单 :codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\EmployeeDao.java 


public interface EmployeeDao 
{ 

ux 

* 根据 标识 属性 来 加 载 Employee 实例 

* eparam id 需要 加 载 的 Employee 实例 的 标识 属性 值 

ne 指定 标识 属性 对 应 的 Employee 实例 
Employee get(Integer id); 
/时 


* 持久 化 指定 的 Employee 实例 


* @param employee 需要 被 持久 化 的 Employee 实例 
* ereturn Employee 实例 被 持久 化 后 的 标识 属性 值 


“/ 
Integer save (Employee employee); 
us 

* 修改 指定 的 Employee 实例 " 
res employee 需要 被 修改 的 Employee 实例 = 
void update (Employee employee); 

/J 


* 删除 指定 的 Employee 实例 
ne employee 需要 被 蓟 除 的 Employee 实例 
void delete (Employee employee): 

bo 


* 根据 标识 属性 删除 Employee 实例 

* @param id 需要 被 副 除 的 Employee 实例 的 标识 属性 值 
8 

void delete(Integer id); 

/en 

* 查询 全 部 的 Employee 实例 

* ereturn 数据 库 中 全 部 的 Employee 实例 
好 

List<Employee> findAl1(); 

/ss 

* 根据 用 户 名 和 密码 查询 员工 

* 8param emp 包含 指定 用 户 名 、 密 码 的 员工 
人 符合 指定 用 户 名 和 密码 的 员工 集合 


List<Employee> findByNameAndPass (Employee, emp)} 


J 
* 根据 用 户 名 查询 员工 
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* eparam name 员工 的 用 户 名 

* 8return 符合 用 户 名 的 员工 

*/ 

Employee findByName (String name); 

as 

* 根据 经 理 查询 员工 

* eparam mgr 经 理 

* Breturn 该 经 理 对 应 的 所 有 员工 

?4 

List<Employee> findByMgr (Manager mgr); 
} 


ManagerDao 的 接口 定义 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\ManagerDao.java 


public interface ManagerDao 
{ 
us 
* 根据 标识 属性 来 加 载 Manager 实例 
* eparam id 需要 加 载 的 Manager 实例 的 标识 属性 值 
* 8@return 指定 标识 属性 对 应 的 Manager 实例 
ata 


Manager get(Integer id); 
/+e 
* 持久 化 指定 的 Manager 实例 
* eparam manager 需要 被 持久 化 的 Manager 实例 
* Breturn Manager 实例 被 持久 化 后 的 标识 属性 值 
op 
String save (Manager manager); 
/es 
* 修改 指定 的 Manager 实例 
* 8param manager 需要 被 修改 的 Manager 实例 
4 
void update (Manager manager)7 
/a 
* 删除 指定 的 Manage 实例 
* eparam manager 需要 被 副 除 的 Manager 实例 
void delete (Manager manager); 
Ju 
* 根据 标识 属性 删除 Manager 实例 
* @param id 种 要 被 删除 的 Manager 实例 的 标识 属性 值 
*/ 
void delete(Integer id); 
/en 
* 查询 全 部 的 Manager 实例 
二 数据 库 中 全 部 的 Manager 实例 
List<Manager> findAll(}; 
Lu 
* 根据 用 户 名 和 密码 查询 经 理 
* 8param emp 包含 指定 用 户 名 、 密 码 的 经 理 
* Breturn 符合 指定 用 户 名 和 密码 的 经 理 
List<Manager> findByNameAndPass {Manager mgr); 
us 
* 根据 用 户 名 查找 经 理 
* eparam name 经 理 的 名 字 
* 8return 名 字 对 应 的 经 理 
*/ 
Manager findByName (String name); 
} 


PaymentDao 的 接口 定义 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\PaymentDao.java 
public interface PaymeritDao 
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{ 
/Ja 
* 根据 标识 属性 来 加 载 Payment 实例 
* @param id 需要 加 载 的 Payment 实例 的 标识 属性 值 
* ereturn 指定 标识 属性 对 应 的 Payment 实例 
wa/ 


Payment get(Integer id); 
J 
* 持久 化 指定 的 Payment 实例 
* Bparam payment 需要 被 持久 化 的 Payment 实例 
* ereturn Payment 实例 被 持久 化 后 的 标识 属性 值 
4 
Integer save(Payment payment); 
ae 
* 修改 指定 的 Payment 实例 
* @param payment 需要 被 修改 的 Payment 实例 
7 
void update (Payment payment)7 
AL 
* 删除 指定 的 Payment 实例 
* 8param payment 需要 被 制 除 的 Payment 实例 
4 


void delete(Payment payment); 

/us 

* 根据 标识 属性 删除 Payment 实例 

* eparam id 需要 被 删除 的 Payment 实例 的 标识 属性 值 
Ww 

void delete(Integer id)7 

J 

* 查询 全 部 的 Payment 实例 

* @return 数据 库 中 全 部 的 Payment 实例 
mf 

List<Payment> findAll(); 

/a 

* 根据 员工 查询 月 结 薪水 

* Breturn 该 员工 对 应 的 月 结 薪水 集合 

二 人 

List<Payment> findByEmp (Employee emp)} 
Lu 

* 根据 员工 和 发 薪 月 份 来 查询 月 结 薪水 

* @param payMonth 月 份 

* @param emp 领 薪 的 员 : 

A 指定 员工 、 指定 月 份 的 月 结 吉水 


Payment findByMonthRndEmp (String payMonth , Employee emp); 
)》 


正如 上 面 DAO 接口 中 看 到 的 , 每 个 DAO 接口 都 包含 了 前 面 提 到 的 6 个 基本 方法 ， 并 在 这 些 方法 
的 基础 上 提供 了 许多 额外 的 查询 方法 ， 这 些 查询 方法 是 实现 业务 逻辑 方法 的 基础 。 

DAO 接口 只 定义 了 DAO 组 件 应 该 实现 的 方法 ， 但 如 何 实现 这 些 DAO 方法 则 没有 任何 限制 ， 程 
序 可 以 使 用 任何 持久 化 技术 来 实现 它们 , 这样 就 可 让 DAO 组 件 来 负责 持久 化 技术 这 个 维度 上 的 变化 ， 
当 系 统 需 要 在 不 同 的 持久 化 技术 之 间 迁 移 时 ， 应 用 只 需要 提供 不 同 的 DAO 实现 类 即 可 ， 程 序 其 他 部 
分 无 须 进行 任何 改变 一 一 这 就 很 好 地 提高 了 系统 的 可 扩展 性 。 


>>10.3.2 实现 DAO 组 件 


借助 于 Spring 的 DAO 支持 , 可 以 很 方便 地 为 DAO 组 件 提供 实现 类 ,Spring 为 各 种 常用 的 持久 化 
技术 都 提供 了 很 好 的 支持 ,例如 为 JDBC 持久 化 技术 提供 了 JdbcDaoSupport， 为 JDO 持久 化 技术 提供 
了 JdoDaoSupport， 为 JPA 持久 化 技术 提供 了 JpaDaoSupport， 为 TopLink 提供 了 TopLinkDaoSupport 
等 ， 通 过 这 些 DaoSupport 基 类 ， 我 们 可 以 在 程序 中 非常 方面 地 实现 各 种 DAO 组 件 。 

Spring 为 Hibernate 提供 的 DAO 基 类 是 : HiberanteDaoSupport, 该 类 只 需要 传 入 一 个 SessionFactory 


783 


http://52pdf.taobao.com 
狐 旺 级 Java EE 企业 应 用 实战 (第 3 版 ) 一 


引用 ， 即 可 得 到 一 个 HibemateTemplate 实例 ，HibernateTemplate 的 功能 非常 强大 ， 可 以 很 容易 实现 数 
据 库 的 大 部 分 操作 。 

本 应 用 还 扩展 了 HibernateDaoSupport， 提 供 了 一 个 YeekuHibernateDaoSupport 子 类 ， 该 子 类 主要 
还 包含 了 大 量 分 页 查询 的 方法 ， 可 以 更 好 地 完成 分 页 查询 。 关 于 YeekuHibernateDaoSupport 的 介绍 ， 
可 参看 本 书 第 8 章 的 介绍 。 

应 用 中 实际 的 DAO 实现 类 都 要 继承 HibemateDaoSupport， 并 实现 相应 的 DAO 接口 ,而 业务 逻辑 
对 象 则 面向 接口 编程 ， 无 须 关心 DAO 的 实现 细节 。 通 过 这 种 方式 ， 就 可 实现 让 应 用 程序 在 不 同 的 持 
久 化 技术 之 间 自 由 切换 。 

如 下 是 ApplicationDaoHibernate 实现 类 的 源 代码 。 

程序 清单 :codes\10\HRSystem\WWEB-INF\src\org\crazyithrsystem\dao\impI\ApplicationDaoHibernate:java 

public class ApplicationDaoHibernate 


extends YeekuHibernateDaoSupport 
implements ApplicationDao 


Lu 
* 根据 标识 属性 来 加 载 Application 实例 
* eparam id 需要 加 载 的 Application 实例 的 标识 属性 值 
* @return 指定 标识 属性 对 应 的 Application 实例 
wh 
public Application get(Integer id) 
{ 
return getHibernateTemplate() 
.get (Application.class , id); 
a 
* 持久 化 指定 的 Application 实例 
* @param application 需要 被 持久 化 的 Application 实例 
* Breturn Application 实例 被 持久 化 后 的 标识 属性 值 
Wa 
public Integer save{(Application application) 
{ 


return (Integer)getHibernateTenplate() 
.save (application) ; 
} 
/us 
* 修改 指定 的 Application 实例 
* eparam application 需要 被 修改 的 Application 实例 
public void update (Application application) 
{ 
getHibernateTemplate () 
-update (application); 
} 
/us 
* 删除 指定 的 Application 实例 
* eparam application 需要 被 油 除 的 ApPlication 实例 
bd 
public void delete(Application application) 
{ 
getHibernateTemplate () 
delete (application) ; 
} 
J 
* 根据 标识 属性 删除 Application 实例 
* Eparam id 需要 被 删除 的 Application 实例 的 标识 属性 值 
本 
public void delete(Integer id) 
{ 
getHibernateTemplate{) 
-delete (get (id)); 
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Ai 
* 查询 全 部 的 application 实例 
* ereturn 数据 库 中 全 部 的 Application 实例 
2 
public List<Application> findAll() 
{ 
return (List<Application>)getHibernateTemplate() 
-find("from Application") ; 


} 
/us 
* 根据 员工 查询 未 处 理 的 异动 申请 


* eparam emp 需要 查询 的 员工 
* ereturn 该 员工 对 应 的 未 处 理 的 异动 申请 
od 


public List<Application> findByEmp (Employee emp) 
{ 
return (List<Application>)getHibernateTemplate() 
-find("from Application as a where " 


+ "a.attend.employee=?" , emp); 
} 


正如 上 面 粗 体 字 代 码 所 看 到 的 ， 当 DAO 实现 类 继承 了 HibernateDaoSupport 之 后 ， 就 可 非常 容易 
地 获得 HibernateTemplate 实例 ， 一 旦 拥有 了 HibernateTemplate 实例 ， 大 部 分 持久 化 操作 都 可 通过 一 行 
代码 来 

下 面 再 提供 一 个 DAO 组 件 的 实现 类 。 

程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\dao\impl\AttendDaoHibernate.java 


public class AttendDaoHibernate 
extends YeekuHibernateDaoSupport 
implements AttendDao 


Jen 
* 根据 标识 属性 来 加 载 Attend 实例 

* @param id 需要 加 载 的 Attend 实例 的 标识 属性 值 
* 8return 指定 标识 属性 对 应 的 Attend 实例 

+ 


public Attend get (Integer id) 
{ 
return getHibernateTemplate() 
:get (Attend.class , id); 
} 
/us 
* 持久 化 指定 的 Attend 实例 
* eparam attend 需要 被 持久 化 的 Attend 实例 
* Breturn Attend 实例 被 持久 化 后 的 标识 属性 什 
*/ 
public Integer save(Attend attend) 
{ 
return (Integer)getHibernateTemplate() 
.Save (attend); 
} 
/rx 
* 修改 指定 的 Attend 实例 
* 8param attend 需要 被 修改 的 Attend 实例 
*/ 
Public void update (Attend attend) 
{ 


/a 
* 删除 指定 的 Attend 实例 


* eparam attend 需要 被 删除 的 Attend 实例 
好 | 
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public void delete(Rttend attend) 
和 


getHibernateTemplate() 
.delete (attend) ; 


} 
/a 
* 根据 标识 属性 删除 Attend 实例 
* Bparam id 需要 被 删除 的 Attend 实例 的 标识 属性 值 
了 
public void delete(Integer id) 
{ 
getHibernateTemplate () 
-delete (get (id)); 


} 
/a 

* 查询 全 部 的 Attend 实例 

* Breturn 数据 库 中 全 部 的 Attend 实例 

ed 
public List<Attend> findAll() 

{ 

return (List<Attend>)getHibernateTemplate() 
.find("from Attend"); 


和 
/es 
* 根据 员工 查询 该 员工 的 打卡 记录 
* eparam emp 员工 
* @return 该 员工 的 全 部 出 勤 记录 
public List<Attend> findByEmp (Employee emp) 
( 

return (List<Attend>)getHibernateTemplate() 

.find("from Attend as a where a.employee=?" , emp); 


} 
/un 
* 根据 员工 、 日 期 查询 该 员工 的 打卡 记录 集合 
* eparan emp 员工 
* @param dutyDay 
* @return 流入 天 的 打卡 记录 集合 
| 
public List<Attend> findByEmpAndDutyDay (Employee emp 
， String dutyDay) 
{ 
return (List<Attend>)getHibernateTemplate() 
.find("from Attend as a Where a.employee=? and " 
+ "a.dutyDay=?" , new Object[]{emp , dutyDay}); 
* 根据 员工 、 日 期 、 上 下 班 查询 该 员工 的 打卡 记录 集合 
* eparam emp 员工 
* @param Cy Ei 
* @param isCome 是 否 - 
+ @return RT Be gre 卡 记录 > 
入 
public Attend findByEmpAndDutyDayAndCome (Employee emp ， 
String dutyDay , boolean isCome) 
{ 
List<Attend> al = findByEmpAndDutyDay (emp , dutyDay); 
if (al != null 11 al.size() > 1) 
{ 
for (Attend attend : al) 
{ 
if (attend.getIsCome() == isCome ) 
{ 
return attend; 
} 
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return null; 

} 

Ju 

* 查看 员工 前 三 天 的 非 正常 打卡 

* eparam emp, 员 工 

* return 该 员工 的 前 三 天 的 非 正 常 打卡 

全 

public List<Attend> findByEmpUnRttend (Employee emp 
, AttendType type) 


SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd") ; 
Calendar c = Calendar.getInstance(); 
String end = sdf.format (c.getTime()); 
c.add(Calendar .DAY_OF_MONTH, -3); 
String start = sdf.format{(c.getTime()); 
Object[] args = {emp , type , start , end}; 
return (List<Attend>)getHibernateTemplate() 
.find("from Attend as a where a.employee=? and " 
+ "a.type != ? and a.dutyDay between ? and ?" , args); 


{ 


} 
} 


与 前 一 个 DAO 实现 类 完全 类 似 , 程序 中 大 部 分 DAO 方法 也 只 需 一 行 代码 即 可 实现 , 但 有 些 比较 
复杂 的 DAO 方法 ， 程 序 则 需要 提供 更 多 控制 逻辑 ， 才 可 实现 它们 。 但 无 论 如 何 ， 使 用 Spring 框架 的 
DapSupport 基 类 ， 都 可 让 系统 的 DAO 组 件 实现 类 更 加 简洁 ， 从 而 简化 了 DAO 组 件 的 开发 。 

这 种 简单 的 实现 较 之 传统 的 JDBC 持久 化 访问 ， 简 直 不 可 同日 而 语 。Hiberate 为 持久 化 访问 提供 
了 第 一 层 封装 ， 而 Spring 在 Hibernate 的 基础 上 再 次 简化 了 持久 层 的 访问 。 


es 学 习 框 架 的 过 程 中 也 许 会 有 少许 的 坎坷 ， 但 一 旦 掌握 了 框架 的 使 用 ， 将 大 幅度 地 提高 
应 用 的 开发 效率 ， 而 且 好 的 框架 所 倡导 的 软件 架构 还 会 提高 开发 者 的 架构 设计 知识 。 | 


>》10.3.3 部 署 DAO 屋 


前 面 的 学 习 ， 我 们 知道 ，HibernateDaoSupport 类 只 需要 一 个 SessionFactory 属性 ， 即 可 完成 
数据 库 的 数据 库 访问 由 模板 类 HibernateTemplate 完成 , 该 模板 类 提供 了 大 量 便捷 的 方法 ， 
简化 了 数据 库 的 访问 。 

1. DAO 组 件 运行 的 基础 

应 用 的 DAO 组 件 以 Hibernate 和 Spring 为 基础 , 由 Spring 容器 负责 生成 并 管理 DAO 组 件 。Spring 

容器 负责 为 DAO 组 件 注入 其 运行 所 需要 的 基础 SessionFactory 。 

Spring 为 整合 Hibernate 提供 了 大 量 工 具 类 ， 通 过 LocalSessionFactoryBean 类 ， 可 以 将 Hibernate 
的 SessionFactory 纳入 其 IoC 容器 内 。 

使 用 LocalSessionFactoryBean 配置 SessionFactory 之 前 ， 必 须 为 其 提供 对 应 的 数据 源 ， 本 应 用 使 
用 C3P0 数据 源 。Spring 容器 也 负责 管理 数据 源 ， 在 Spring 容器 中 配置 数据 源 的 代码 如 下 : 


<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 --> 
<!-- 设置 连接 数据 库 的 驱动 、URL、 用 户 名 、 天 码 
连接 池 最 大 连接 数 、 最 小 连接 数 、 初 始 连接 数 等 参数 一 -> 
<bean id="datasource" class="com.mchange.v2.c3p0.ComboPooledDatasource" 
destroy-method="close" 
p:driverclass="com.mysql.jdbc.Driver" 
Pp:jdbcUrl="jdbe:mysql://localhost:3306/hrSystem" 
p:user="root™" 
p:password="32147" 
Pp:maxPoolSize="40" 
p:minPoolSize="1" 
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p:initialpoolSize="1" 
p:maxIdleTime="20"/> 


一 旦 配置 了 应 用 所 需 的 数据 源 之 后 ， 程 序 就 可 在 此 数据 源 基础 之 上 配置 SessionFactory 对 象 了 。 
配置 SessionFactory Bean 的 配置 代码 如 下 : 


<!-- 定义 Hibernate 的 SessionFactory --> 

<!-~ 依赖 注入 数据 源 ， 注 入 正 是 上 面 定义 的 dataSource -> 

<bean id="sessionFactory" 

org .springframework.orm.hibernate3.LocalSessionFactoryBean" 
Source-ref="dataSource"> 

<!-- mappingResouces 属性 用 来 列 出 全 部 映射 文件 --> 

<property name="mappingResources"> 


<list> 
一 以 下 用 来 列 出 Hibernate 映射 文件 -> 
<value>org/crazyit/hrsystem/domain/Application.hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/Attend.hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/AttendType.hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/CheckBack.hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/Employee.hbm.xml</value> 
‘<value>org/crazyit/hrsystem/domain/Payment .hbm. xml</value> 
</list> 
</property> 
<!-- 定义 Hibernate 的 SessionFactory 的 属性 --> 
<property name="hibernateProperties"> 
<!-- 指定 数据 库 方言 、 是 否 自动 建 表 
是 否 生成 SQL 语句 等 we 
‘<value> 
hibernate. dialect=org.hibernate. dialect.MySQLInnoDBDialect 
hibernate .hbm2ddl .auto=update 
.Show_sql=true 


hibernate.cache.use_second_level_cache=true 
# 设 置 二 级 缓存 的 提供 者 
hibernate.cache.provider_class-org.hibernate.cache.EhCacheProvider 
</value> 
</property> 
</bean> 


-站 注意 :4 


Hibernate 属性 既 可 直接 在 LocalSessionFactoryBean Bean 内 配置 ,也 可 以 在 hibernate. 
cfg.xml 文件 中 配置 。 


2. 配置 DAO 组 件 


对 于 继承 HibernateDaoSupport 的 DAO 实现 类 ， 只 需要 为 其 注入 SessionFactory 即 可 ， 由 于 所 有 
DAO 组 件 都 需要 注入 SessionFactory 引用 ， 因 此 可 以 使 用 Bean 继承 简化 DAO 组 件 的 配置 。 本 应 用 将 
所 有 的 DAO 组 件 配置 在 单独 的 配置 文件 中 ， 下 面 是 DAO 组 件 的 配置 文件 代码 。 

程序 清单 : codes\10\HRSystem\WEB-INF\daoContext.xml 


<?xml version="1.0" encoding="GBK"?> 
<!-- 指定 Spring 配置 文件 的 Schema 信息 --> 
<beans xmlns="http;//www.springframework.org/schema/beansn 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance™ 
xmlns:p="http://www. springframework.org/schema/p" 
xsi:schemaLocation="http://wuw. springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd"> 
<!-~ 配置 DAO 组 件 的 模板 -> 
<bean id="daoTemplate" abstract="true" lazy-init="true" 
P:sessionFactory-ref="sessionFactory"/> 
<bean id="employeeDao" 
class="org.crazyit.hrsystem. dao. impl.EmployeeDaoHibernate" 
parent="daoTemplate"/> 
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<bean id="managerDaon 
class="org.crazyit.hrsystem.dao. impl.ManagerDaoHibernate" 
Parent="daoTemplate"/> 
<bean id="attendDao" 
class="org.crazyit.hrsystem. dao. impl.AttendDaoHibernate" 
"daoTemplate"/> 


<bean id="attendTypeDao" 
class="org. crazyit.hrsystem.dao. impl.AttendTypeDaoHibernate" 
Parent="daoTemplate"/> 

<bean id="appDao" 
class="org.crazyit.hrsystem. dao. impl.ApplicationDaoHibernate" 
parent="daoTenplate"/> 

<bean id="checkDao" 
class="org.crazyit.hrsystem.dao. impl.CheckBackDaoHibernate" 
parent="daoTemplate"/> 

<bean id="payDao" 
class="org.crazyit.hrsystem.dao. impl.PaymentDaoHibernate" 
Parent="daoTemplate"/> 

</beans> 


从 上 面 程序 粗 体 代码 可 以 看 出 ， 配 置 文件 首先 配置 了 一 个 DAO 组 件 的 模板 ， 配 置 文件 为 该 模板 
注入 了 SessionFactory， 而 其 他 DAO 组 件 都 继承 了 该 DAO 模板 ,因此 ， 其 他 实际 的 DAO 组 件 也 会 被 
注入 SessionFactory 对 象 。 


三- 注意 :w ee 
系统 的 DAO 实现 类 中 并 未 提供 setSessionFactory 方法 ， 该 方法 由 其 父 类 Hibernate | 
DaoSupport 提供 ， 用 于 依赖 注入 SessionFactory 对 象 。 该 配置 文件 中 也 并 未 配置 Session 本 


| Factory Bean， 应 用 的 DataSource 和 SessionFactory Bean 配置 在 另 一 个 文件 中 
外 


10.4 实现 Service 层 


本 系统 只 使 用 了 两 个 业务 逻辑 组 件 ， 分 别 为 系统 中 两 个 角色 模块 的 业务 逻辑 提供 实现 ，Manager 
和 Employee 模块 .这 两 个 模块 分 别 使 用 不 同 的 业务 逻辑 组 件 ,每 个 组 件 作为 门面 封装 7 个 DAO 组 件 ， 
系统 使 用 这 两 个 业务 逻辑 组 件 将 这 些 DAO 对 象 封装 在 一 起 。 


》>>10.4.1 业务 逻辑 组 件 的 设计 


业务 逻辑 组 件 是 DAO 组 件 的 门面 ， 所 以 也 可 理解 为 业务 逻辑 组 件 需 要 依赖 于 DAO 组 件 ，DAO 
对 象 与 业务 逻辑 组 件 之 间 的 关系 如 图 10.4 所 示 。 

在 EmpManager 接口 里 定义 了 大 量 的 业务 方法 ， 这 些 方法 的 实现 依赖 于 DAO 组 件 。 由 于 每 个 业 
务 方法 要 涉及 多 个 DAO 操作 ， 其 DAO 操作 是 单个 的 数据 记录 的 操作 ， 而 业务 逻辑 方法 的 访问 ， 则 需 
要 设计 多 个 DAO 操作 ， 因 此 每 个 业务 逻辑 方法 可 能 需要 涉及 多 条 记录 的 访问 。 

业务 逻辑 组 件 面向 DAO 接口 编程 ， 可 让 业务 逻辑 组 件 从 DAO 组 件 的 实现 中 分 离 。 因 此 业务 逻辑 
组 件 只 关心 业务 逻辑 的 实现 ， 无 须 关心 数据 访问 逻辑 的 实现 。 


>>10.4.2 实现 业务 膛 辑 组 件 


业务 逻辑 组 件 负责 实现 系统 所 需 的 业务 方法 ， 系 统 有 多 少 个 业务 需求 ， 业 务 逻辑 组 件 就 提供 多 少 
个 对 应 方法 。 本 应 用 采用 的 是 贫血 模式 的 架构 模型 , 因此 业务 逻辑 方法 完全 由 业务 逻辑 组 件 负责 实现 。 

业务 逻辑 组 件 只 负责 业务 逻辑 上 的 变化 ， 而 持久 层 上 的 变化 则 交 给 DAO 层 负责 ， 因 此 业务 逻辑 
组 件 必须 依赖 于 DAO 组 件 。 


789 


http://52pdf.taobao.com 


炉 量 钥 Java EE 企业 应 用 实战 (第 3 版 ) 一 


图 10.4 EmpManager 与 DAO 组 件 接口 的 类 图 


下 面 是 EmpManagerImpl 的 源 代码 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\service\impl\EmpManagerImpl.java 
Public class EmpManagerImpl 


{ 
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implements EmpManager 


e ApplicationDao appDao; 

e AttendDao attendDao; 

private AttendTypeDao typeDao; 
private CheckBackDao checkDao; 
Private EmployeeDao empDao; 

Private ManagerDao mgrDao; 

Private PaymentDao payDao; 

// 省 略 依赖 注入 7 个 DAO 组 件 所 需 的 setter 方法 


所 

* 以 经 理 身份 来 验证 登录 

* @param mgr 登录 的 经 理 身份 

A 登录 后 的 身份 确认 : 0 为 登录 失败 ，1 为 登录 emp 2 为 登录 mgr 


public int validLogin(Manager mgr) 


{ 
// 如 果 找 到 一 个 经 理 ， 以 经 理 登录 
if (mgrDao.findByNameAndPass (mgr) .size() 
>= 1) 
{ S 
return LOGIN_MGR; ， 


} 
// 如 果 找到 普通 员工 ， 以 普通 员工 登录 
else if (empDao. findByNameAndPass (mgr) 
-size() >= 1) 3 
{ S 
return LOGIN_EMP; 


} 
else 


return LOGIN_FAIL; 
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* 自动 打卡 ， 周 一 到 周 五 ， 早 上 7: 00 为 每 个 员工 插入 旷工 记录 
Wh 


public void autoPunch() 

{ 
System.out .println(" 自 动 插入 旷工 记录 ") 7 
List<Employee> emps = empDao. findAll(); 
// 获 取 当 前 时 间 
String dutyDay = new java.sql.Date( 

System.currentTimeMillis()).tostring(); 

for (Employee e : emps) 


{ 
// 获 取 旷 工 对 应 的 出 勤 类 型 
AttendType atype = typeDao.get (6); 
Attend a = new Attend(); 
a.setDutyDay (dutyDay); 
a.setType (atype) 7 
7/ 如 果 当前 时 间 是 是 早上 ， 对 应 于 上 班 打卡 
if (Calendar.getInstance() 
,get (Calendar .HOUR_OF_DAY) < RM_LIMIT) 


7/ 上 班 打卡 
asetISCome (true)7 
} 
else 


/7 下班 打卡 
a.setIsCome (false); 
了 
a.setEmployee (e); 
attendDao. save (a); 
】} 
} 


Ju 
ee 每 月 1 号 ， 结 算 上 个 月 工资 
* 

public void autopay() 


上 
System,out ,println ("自动 插入 工资 结算 ") ; 
List<Employee> emps = empDao. findAll(); 
// 获 取 上 个 月 时 间 
Calendar c = Calendar.getInstance(); 
c.add (Calendar. DAY_OF_MONTH, -15); 
SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM"); 
String payMonth = sdf.format (c.getTime()); 
// 为 每 个 员工 计算 上 个 月 工资 
for (Employee e : emps) 
{ 
Payment pay = new Payment(); 
// 获 取 该 员工 的 工资 
double amount = e.getSalary(); 
// 获 取 该 员工 上 个 月 的 出 勤 记 录 
List<Attend> attends = attendDao. findByEmp (e); 
7/ 用 工资 累积 其 出 勤 记 录 的 工资 
for ( Attend a : attends ) 
{ 


amount += a.getType() .getAmerce(); 


k 

// 添 加 工资 结算 

pay. setPayMonth (payMonth) ; 
pay. setEmployee (e); 


PpayDao. save Pay)7 


由 

As 

* 验证 某 个 员工 是 否 可 打卡 
* @param user 员工 名 
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* @param dutyDay 日 其 

* @return 可 打卡 的 类 别 

“7 

public int validPunch(String user , String dutyDay) 


{ 
// 不 能 查找 到 对 应 用 户 ， 返 回 无 法 打卡 
Employee emp = empDao. findByName (user); 
if (emp == null) 
人 
return NO_PUNCH; 


} 
// 找 到 员工 当前 的 出 勤 记录 
List<Attend> attends = attendDao.findByEmphndDutyDay (emp ，dutyDay)7 
// 系 统 没有 为 用 户 在 当天 插入 空 打卡 记录 ， 无 法 打卡 
if (attends == null || attends.size() <= 0) 
{ 
return NO_PUNCH; 


) 
// 开 始 上 班 打卡 
else if (attends.size() == 1 
65 attends.get (0) .getIsCome() 
&5 attends.get (0) .getPunchTime () == null) 


return COME_PUNCH; 


else if (attends.size() == 1 
&5 attends,get(0) .getPunchTime () == null) 


return LEAVE_PUNCH; 
else if (attends.size() == 2) 


// 可 以 上 班 、 下 班 打卡 
if (attends.get(0).getPunchTime() == null 

66 attends.get (1).getPunchTime() == null) 
{ 

return BOTH_PUNCH; 


} 
// 可 以 下 班 打卡 
else if (attends.get(1).getPunchTime{() == null) 
{ 
return LEAVE_PUNCH; 


return NO_PUNCH; 
) 
return NO_PUNCH; 
ax 
» 
* param user 员工 名 
* @param dutyDay 打卡 日 其 
* @param isCome 是 否 是 上 班 打卡 
* ereturn 打卡 结果 
A 
public int punch(String user , String dutyDay , boolean isCome) 
{ 
Employee emp = empDao. findByName (user); 
if (emp == null) 
{ 
return PUNCH_FAIL; 


本 
// 找 到 员工 本 次 打卡 对 应 的 出 勤 记录 


Attend attend = 
attendDao. findByEmpAndDutyDayAndCome (emp ， dutyDay , isCome); 
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We 


if (attend == null) 


4 
return PUNCH_FAIL; 


} 
// 已 经 打卡 
if (attend.getPunchTime() != null) 
{ 
return PUNCHED; 
System.out .println(™ 
// 获 取 打 卡 时 间 
int punchHour = Calendar.getInstance() 
.get (Calendar .HOUR_OF_DAY); 
attend. setPunchTime (new Date())7 
7/ 上 班 打卡 
if (isCome) 


人 
// 9 点 之 前 算 正常 
if (punchHour < COME_LIMIT) 
{ 


打卡 ==========") ; 


attend. setType (typeDao,get (1)); 


} 
// 9 一 11 点 之 间 算 迟到 
else if (punchHour < LATE_LIMIT) 
{ 
attend. setType (typeDao.get (4)); 


} 

/111 点 之 后 算 旷 工 ,无需 理会 
) 
VW/ 下 班 打卡 


else 
{ 

//18 点 之 后 算 正常 

if (punchHour > LEAVE_LIMIT) 


{ 
attend,.setType (typeDao.get (1)); 


} 
//16~18 点 之 同 算 早退 
else if (punchHour < EARLY_LIMIT) 


attend. setType (typeDao.get (5)); 
} 

} 

attendDao.update (attend); 

return PUNCH_SUCC; 
* 根据 员工 浏览 自己 的 工资 
* @param empName 员工 名 
* @return 该 员工 的 工资 列表 
es 
public List<PaymentBean> empsalary (String empName) 
{ 


7/ 获取 当前 员工 
Employee emp = empDao.findByName (empName); 
// 获 取 该 员工 的 全 部 工资 列表 
List<Payment> pays = payDao.findByEmp (emp); 
List<PaymentBean> result = new ArrayList<PaymentBean> () 
// 封 装 VO 集 合 
for (Payment p : pays ) 
{ 
result .add (new PaymentBean(p.getPayMonth() 
sp.getAmount ())); 
下 


return result; 


J 
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wt ee 

* @param empName 员 

* @return 各 归 闻 天 的 非 下 打卡 
wi 


public List<AttendBean> unRttend(String empName) 
刘 
// 找 出 正常 上 班 
AttendType type = typeDao.get(1)7 
Employee emp = empDao. findByName (empName); 
// 找 出 非 正常 上 班 的 出 勤 记录 
List<Attend> attends = attendDao.findByEmpUnAttend (emp, type); 
List<AttendBean> result = new ArrayList<AttendBean>(); 
// 封 装 VO 集 合 
for (Attend att : attends ) 
{ 
result.add (new AttendBean(att.getId() , att.getDutyDay() 
， att,getType() .getName() , att.getPunchTime())); 
} 
return result; 
} 
/uw 
* 返回 全 部 的 出 勤 类 别 
* @return 全 部 的 出 勤 类 别 
he 


public List<AttendType> getAllType() 
{ 
return typeDao. findAll(); 
} 
/us 
* 添加 申请 
w Bparam attId 申请 的 出 勤 ID 
* @param typeId 申请 的 类 型 ID 
* eparam reason 申请 的 理由 
* @return 添加 的 结果 
A 


public boolean addApplication(int attId , int typeId 
，String reason) 
{ 


// 创 建 一 个 申请 
Application app = new Application(); 


7/ 获取 申请 需要 改变 的 出 勤 记录 
Attend attend = attendDao.get (attId); 
AttendType type = typeDao.get (typeId); 
app.setAttend (attend) ; 
app.setType (type); 
if (reason != null) 
{ 
app. setReason (reason) ; 
上 
appDao. save (app); 
return true; 
} 


在 上 面 的 业务 逻辑 组 件 中 , 有 autoPunch 和 autoPay 两 个 方法 , 这 两 个 方法 并 不 由 客户 端 直接 调用 ， 
而 是 由 任务 调度 来 执行 ， 其 中 autoPunch 负责 每 天 为 员工 完成 自动 考勤 (为 员工 每 天 插入 旷工 考勤 记 
录 )， 以 及 每 月 3 日 为 所 有 员工 完成 工资 结算 。 

在 上 面 所 提供 的 儿 个 业务 逻辑 方法 中 ,大 部 分 方法 都 比较 容易 理解 ,但 对 autoPunch、validPunch 和 
punch 三 个 方法 则 可 能 有 些 迷惑 ， 对 它们 各 自 的 作用 不 是 十 分 明晰 。 

在 介绍 这 三 个 方法 详细 作用 之 前 ， 我 们 先 来 介绍 一 下 本 系统 中 打卡 考勤 的 实现 。 本 系统 会 在 每 天 
早上 7 点 、 下 午 12 点 时 自动 插入 两 条 “旷工 ”的 考勤 记录 ， 而 系统 中 的 autoPunch() 方 法 就 负责 插入 
这 样 的 旷工 记录 。 

可 能 有 读者 会 提出 疑问 : 为 什么 每 天 要 为 员工 插入 两 条 “旷工 ”记录 昵 ? 因为 本 系统 认为 每 天 开 
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始 时 ， 每 个 员工 默认 的 考勤 记录 是 “旷工 ”， 当 该 员工 上 班 打卡 、 下 班 打卡 时 ， 系 统 就 会 根据 员工 的 打 
时间 来 判断 该 员工 究竟 是 正常 上 班 、 迟 到 ， 还 是 早退 或 干脆 就 是 “旷工 ”。 每 当 员工 打卡 时 ， 系 统 并 
不 是 插入 考勤 记录 ， 只 是 修改 系统 自动 插入 的 考勤 记录 ， 上 面 的 punch 业务 逻辑 方法 用 于 实现 普通 员 
工 的 打卡 考勤 。 

程序 的 validPunch0 方 法 则 用 于 判断 当前 员工 可 进行 哪 种 考勤 : 上 班 或 下 班 ? 正常 上 班 时 间 内 , 系 
统 每 天 7 点 、12 点 会 为 所 有 员工 自动 插入 “旷工 ”考勤 记录 ，validPunch( 方 法 会 根据 员工 用 户 名 来 判 
断 当 天 上 班 “ 了 旷工 ”考勤 、 下 班 “ 了 旷工 ”是 否 存在 ， 且 该 考勤 记录 没有 打卡 时 间 ， 即 表明 该 员工 还 可 
打卡 考勤 ， 否 则 ， 该 员工 将 不 能 进行 打卡 考勤 。 


和 10.4.3 事务 管理 


与 所 有 Java EE 应 用 类 似 ， 本 系统 的 事务 管理 负责 管理 业务 逻辑 组 件 里 的 业务 逻辑 方法 ， 只 有 对 
业务 逻辑 方法 添加 事务 管理 才 有 实际 的 意义 ， 对 于 单个 DAO 方法 (基本 的 CRUD 方法 ) 增加 事务 管 
理 是 没有 太 大 实际 意义 的 。 

借助 于 Spring 2.x Schema 所 提供 的 k、aop 两 个 命名 空间 的 帮助 ， 系 统 可 以 非常 方便 地 为 业务 迪 
辑 组 件 配置 事务 管理 。 其 中 tx 命名 空间 下 的 <tx:advice.… 户 元素 用 于 配置 事务 增强 处 理 ， 而 aop 命名 空 
间 下 的 <aop:advisor..… 记 元素 用 于 配置 自动 代理 。 

下 面 是 本 应 用 中 事务 管理 的 配置 代码 。 

<!-- 配置 Hibernate 的 局 部 事务 管理 器 ， 使 用 HibernateTransactionManager 类 --> 
<!-- 该 类 实现 PlatformTransactionManager 接口 ， 是 针对 hibernate 的 特定 实现 --> 
<!-- 并 注入 SessionFactory 的 引用 --> 
<bean idr"transactionManager”classr 
springframework.orm.hibernate3. HibernateTransactionManager" 
sionFactory-ref="sessionFactory"/> 
务 增强 处 理 Bean, 指定 事务 管理 器 --> 
<tx:advice id="txAdvice" transaction-manager="transactionManager"> 
<!-- 用 于 配置 详细 的 事务 语义 一 > 
<tx:attributes> 
<!-- 所 有 以 'get' 开 头 的 方法 是 read-only 的 -> 
<tx:method name="get*" read-only="true"/> 
<!-~ 其 他 方法 使 用 默认 的 事务 设置 --> 
<tx:method name="*"/> 
</tx:attributes> 
</tx:advice> 
<aop:config> 
<!-~ 配置 一 个 切入 点 ， 匹 配 empManager 和 mgrManager 
两 个 Bean 的 所 有 方法 的 执行 ~-> 


<aop:pointcut id="leePointcut" 
expression="bean (empManager) | |bean (mgrManager) "/> 
<!-- 指定 在 leePointcut 切入 点 应 用 txAdvice 事务 增强 处 理 --> 
‘<aop:advisor advice-ref="txAdvice" 
pointcut-ref="leePointcut"/> 
</aop:config> 


通过 上 面 提供 的 配置 代码 ， 系 统 自动 会 为 empManager 和 mgrManager 两 个 Bean 的 所 有 方法 增加 
事务 管理 ， 这 样 事务 配置 方式 非常 简洁 ， 可 以 极 好 地 简化 Spring 配置 文件 。 


>>10.4.4 部 署 业务 还 辑 组 件 


单独 配置 系统 的 业务 逻辑 层 ， 可 避免 因 配置 文件 过 大 引起 配置 文件 难以 阅读 。 将 配置 文件 按 层 和 
模块 分 开 配 置 ， 可 以 提高 Spring 配置 文件 的 可 读 性 和 可 理解 性 。 

在 applicationContextxml 配置 文件 中 配置 数据 源 、 事 务 管理 器 、 业 务 逻 辑 组 件 和 事务 管理 器 等 
Bean。 具 体 的 配置 文件 如 下 。 
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程序 清单 : codes\10\HRSystem\WEB-INF\applicationContext.xml 


<2xml version="1.0" encoding="GBK"?> 


<!-- 指定 Spring 配置 文件 的 Schema 信息 一 > 
<beans xmlns="http://www.springframework.org/schema/beans" 
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xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:aop="http: //www. springframework.org/schema/aop™ 
xmlns:p="http: //www. springframework.org/schema/p" 
xmlns:tx="http://www. springframework.org/schema/tx" 
xsi:schemaLocation="http://wuw.springframework.org/schema/beans 
http://www. springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www. springframework.org/schema/tx 
http://www. springframework.org/schema/tx/spring-tx-3.0.xsd 
http://www.springframework.org/schema/aop 
http://www. springframework.org/schema/aop/spring-aop-3.0.xsd"> 
<!-- 定义 数据 源 Bean， 使 用 C3P0 数据 源 实现 -> 
<!-- 设置 连接 数据 库 的 驱动 、URL、 用 户 名 、 密 码 
连接 池 最 大 连接 数 、 最 小 连接 数 、 初 始 连接 数 等 参数 -> 
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close" 
p:driverclass="com.mysql.jdbc.Driver" 
jdbcUrl="jdbc:mysql://localhost:3306/hrSystem" 
p:user="root" 
assword="32147" 
xPoolSize="40" 
p:minpoolsize="1" 
nitialPoolsize="1" 
p:maxIdleTime="20"/> 
定义 Hibernate 的 SessionFactory --> 
依赖 注入 数据 源 ， 注 入 正 是 上 面 定义 的 datasource ~ 
<bean id="sessionFactory" 
class="org. springframework.orm.hibernate3.LocalSessionFactoryBean" 
p:dataSource-ref="dataSource"> 
<!-- mappingResouces 属性 用 来 列 出 全 部 映射 文件 -> 
<property name="mappingResources"> 
<list> 
<!-- 以 下 用 来 列 出 Hibernate 映射 文件 一 -> 
<value>org/crazyit/hrsystem/domain/Application.hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/Attend.hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/AttendType.hbm. xml</value> 
<value>org/crazyit/hrsystem/domain/CheckBack.hbm.xml</value> 
<value>org/crazyit /hrsystem/domain/Employee .hbm.xml</value> 
<value>org/crazyit/hrsystem/domain/Payment .hbm.xml</value> 
</list> 
</property> 
<!-- 定义 Hibernate 的 SessionFactory 的 属性 -~-> 
<property name="hibernateProperties"> 
<!-- 指定 数据 库 方言 、 是 否 自动 建 表 
是 否 生成 SQL 语句 等 ee 
<value> TF 
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect 
hibernate.hbm2ddl .auto=update 
hibernate. show_sql=true 
hibernate, format_sql=true 
# 开 启 二 级 缓存 
hibernate.cache.use_second level_cache=true 
# 设 置 二 级 缓存 的 提供 者 
hibernate.cache.provider_class=org.hibernate.cache.EhCacheProvider 
</value> f 
</Property> 
</bean> 
配置 Hibernate 的 局 部 事务 管理 器 ， 使 用 HibernateTransactionManager 类 一 -> 
该 类 实现 PlatformTransactionManager 接口 ， 是 针对 Hibernate 的 特定 实现 --> 
<!-- 并 注入 SessionFactory 的 引用 --> 
<bean id="transactionManager" class= 
"org. springframework.orm.hibernate3.HibernateTransactionManager" 
Pp:sessionFactory-ref="sessionFactory"/> 
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<!-- 配置 事务 增强 处 理 Bean, 指定 事务 管理 器 --> 
<tx:advice id="txAdvice" transaction-manager="transactionManager"> 
<!-- 用 于 配置 详细 的 事务 语义 一 > 
<tx:attributes> 
<!-- 所 有 以 "get "开头 的 方法 是 read-only 的 --> 
<tx:method name="get*" read-only="true"/> 
<!- 其 他 方法 使 用 默认 的 事务 设置 -> 
<tx:method name="*"/> 
</tx:attributes> 
</tx:advice> 
<aop:config> 
<!-- 配置 一 个 切入 点 ， 匹 配 empManager 和 mgrManager 
两 个 Bean 的 所 有 方法 的 执行 --> 
<aop:pointcut id="leePointcut™" 
expression="bean (empManager) | |bean (mgrManager) "/> 
<!-- 指定 在 leePointcut 切入 点 应 用 txAdvice 事务 增强 处 理 --> 
<aop:advisor advice-ref="txAdvice™ 
pointcut-ref="leePointcut"/> 
</aop: config> 
<!- 定义 业务 逻辑 组 件 模板 一- 
<!-- 为 之 注入 DAO 组 件 --> 
late" abstract="true" lazy-init="true" 


p:empDao-ref="employeeDao" 
Pp:mgrDao-ref="managerDao" 
Pp:payDao-ref="payDao"/> 
<!- 定义 两 个 业务 逻辑 组 件 ， 继 承 业务 逐 辑 组 件 的 模板 -一 > 
<bean id="empManager" 
class="org.crazyit.hrsystem. service, impl.EmpManagerImpl" 
parent="managerTemplate"/> 
<bean id="mgrManager" 
class="org.crazyit.hrsystem. service. impl.MgrManagerImpl" 
parent="managerTemplate"/> 
</beans> 


je pa 
总 光盘 里 的 applicationContextxml 文件 和 此 处 给 出 的 配置 文件 可 能 存在 一 些 差别 ， 因 为 
光 生 里 的 了 于 文件 里 还 包 全 任务 调 度 的 本 于 


从 上 面 的 配置 文件 可 以 看 出 ,使 用 Spring 容器 来 管理 各 个 组 件 之 间 的 依赖 关系 ， 将 各 组 件 之 间 耦 
合 从 代码 中 抽 离 处 理 ， 放 在 配置 文件 中 进行 管理 ， 这 确实 是 一 种 优秀 的 解 耦 方式 。 


10.5 实现 任务 的 自动 调度 


系统 中 常常 有 些 需 要 自动 执行 的 任务 ， 这 些 任务 可 能 每 隔 一 段 时 间 就 要 执行 一 次 ， 也 可 能 需要 在 
指定 时 间 点 自动 执行 ， 这 些 任务 的 自动 执行 必须 使 用 任务 的 自动 调度 。 

JDK 为 简单 的 任务 调度 提供 了 Timer 支持 ， 但 对 于 更 复杂 的 调度 ， 例 如 ， 需 要 在 某 个 特定 时 刻 调 
度 任务 时 ，Timer 就 有 点 力不从心 了 。 好 在 有 另 一 个 开源 框架 Quartz， 借 助 于 它 的 支持 ， 既 可 以 实现 
简单 的 任务 调度 ， 也 可 以 执行 复杂 的 任务 调度 。 


>>10.5.1 使 用 Quartz 


Quartz 是 opensymphony (WebWork、OSWorkflow 就 是 该 组 织 开发 的 ) 组 织 提供 的 一 个 任务 调度 框 
架 ， 具 有 简单 、 易 用 特性 的 任务 调度 系统 ， 借 助 于 Cron 表达 式 ，Quartz 可 以 支持 各 种 复杂 的 任务 调度 。 
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1. 下 载 和 安装 Quartz 

下 载 和 安装 Quartz 请 按 如 下 步骤 进行 。 

人 登录 http://www.quartz-scheduler.org/ 站 点 ， 下 载 Quartz 的 最 新 版 本 ， 笔 者 成 书 之 时 ，Quartz 的 
最 新 版 为 1.8.4， 笔 者 的 示例 程序 就 是 基于 该 版 本 完成 的 ， 建 议 读者 也 下 载 该 版 本 的 Quartz。 下 载 完成 
后 将 得 到 一 个 quartz-1.8.4.tar.gz 文件 ， 将 该 压缩 文件 解压 缩 ， 发 现 有 如 下 的 文件 结构 。 

> docs: 存放 Quartz 的 相关 文档 ， 包 括 API 等 文档 。 
examples: 存放 Quartz 的 示例 程序 。 
lb: 存放 Quartz 编译 或 运行 所 依赖 的 第 三 方 类 库 。 
quartz、quartz-all、quartz-jboss、quartz-oracle、quartz-weblogic: 存放 Quartz 的 源 文件 。 
quartz-1.8.4jar: Quartz 的 核心 类 库 。 
quartz-all-1.8.4.jar: Quartz 的 完全 类 库 ， 包 括 核心 类 库 及 其 他 可 选 类 库 。 
quartz-jboss-1.8.4.jar: 可 选 的 与 Jboss 相关 的 Quartz 类 库 。 
quartz-oracle-1.8.4.jar: 可 选 的 与 Oracle 相关 的 Quartz 类 库 。 
quartz-weblogic-1.8.4.jar: 可 选 的 与 Weblogic 相关 的 Quartz 类 库 。 
其 他 Quartz 相关 说 明文 档 。 


> 
> 
> 
> 
> 
- 
> 
> 
下 


现在 Quartz 已 经 交 给 terracotta.org 管理 ， 他 们 要 求 注册 用 户 才能 下 载 Quartz， 因 此 读 ， 
者 需要 准备 一 个 邮件 帐号 去 注册 terracotta .org 账号 、 并 准备 接收 邮件 来 激活 该 账号 | 


人 在 普通 情况 下 , 只 需 将 quartz-1.8.4.jar 或 quartz-all-1.8.4.jar 文件 添加 到 CLASSPATH 环境 变量 
中 , 让 JDK 编译 和 运行 时 可 以 访问 到 该 JAR 包 里 包含 的 类 文件 即 可 .当然 也 可 使 用 Ant, 或 者 其 他 IDE 
工具 来 管理 项 目的 类 库 ， 这 样 就 无 须 添加 任何 环境 变量 。 
人 @。” 如果 需要 在 Web 应 用 中 使 用 Quartz， 则 应 将 quartz-1.8.4.jar 或 quartz-all-1.8.4.jar 文件 复制 到 
Web 应 用 的 WEB-INF/lib 路 径 下 。 
SS" 实际 上 Quartz 还 使 用 了 SLF4] 作为 日 志 工具 ， 因 此 读者 还 需要 将 lib/slf4j-api-1.6.0jar : 
复制 到 项 目的 类 加 载 路 径 中 。 | 


2.， Quartz 运行 的 基本 属性 

Quartz 允许 提供 一 个 名 为 quartz.properties 的 配置 文件 ， 通 过 该 配置 文件 ， 可 以 修改 框架 运行 时 的 
环境 。 默 认 使 用 quartz-1.8.4.jar 里 的 quartz.properties 文件 〈 在 该 压缩 文件 的 org\quartz 路 径 下 )。 如 果 
需要 改变 默认 的 Quartz 属性 , 程序 可 以 自己 创建 一 个 quartz.properties 文件 , 并 将 它 放 在 系统 的 类 加 载 
路 径 下 ，ClassLoader 会 自动 加 载 并 启用 其 中 的 各 种 属性 。 下 面 是 quartz.properties 文件 的 示例 。 

程序 清单 ，codes\10\QuartzQs\src\quartz.properties 

# 配置 主 调度 器 属性 

org.quart2. scheduler. instanceName=QuartzScheduler 

org.quartz.scheduler. instanceId=AUTO 

# 配置 线程 池 


# Quartz 线程 池 的 实现 类 
org.quartz.threadPool.class=org.quartz.simpl.SimpleThreadPool 


# 线程 池 的 线程 数量 
org.quartz. threadPoo: 
# 线程 池 里 线程 的 优先 级 
org.quartz. threadPool. threadPriority=10 


# 配置 作业 存储 
org.quartz.jobstore.misfireThreshold=60000 


org.quartz. jobStore.class=org.quartz. simpl .RAMJobstore 


1 .threadCount=1 


798 


http://52pdf.taobao.com 


第 10 章 10 


Quartz 提供 两 种 作业 存储 方式 : 

> ”第 一 种 类 型 叫做 RAMJobStore, 它 利用 内 存 来 持久 化 调度 程序 信息 。 这 种 作业 存储 类 型 最 容 
易 配置 和 运行 。 对 许多 应 用 来 说 ， 这 种 存储 方式 已 经 足够 了 。 然 而 ， 由 于 调度 程序 信息 保存 
在 JVM 的 内 存 里 面 ， 因 此 ， 一 旦 应 用 程序 中 止 ， 则 所 有 的 调度 信息 将 被 丢失 。 

> 第 二 种 类 型 称 为 JDBC 作业 存储 。 需 要 JDBC 驱动 程序 和 后 台数 据 库 保 存 调度 程序 的 信息 ， 
由 需要 调度 程序 维护 调度 信息 的 用 户 来 设计 。 

大 部 分 时 候 , 我 们 使 用 Quartz 提供 的 RAMJobStore 存储 方式 就 足够 了 , 因此 上 面 属性 文件 中 粗 体 
字 代码 指定 了 本 示例 应 用 使 用 RAMJobStore 存储 方式 。 

除 此 之 外 ， 上 面 属性 文件 还 指定 了 Quartz 线程 池 的 线程 数 ，1， 这 表明 系统 Quartz 最 多 启动 一 条 
线程 来 执行 指定 任务 。 如 果 此 处 指定 更 多 线程 数 ， 程 序 将 会 启动 更 多 线程 来 执行 指定 任务 ， 这 意味 着 
系统 可 能 有 多 个 任务 并 发 执行 。 

3. Quartz 里 的 作业 

作业 是 一 个 执行 指定 任务 的 Java 类 ， 当 Quartz 调用 某 个 Java 任务 执行 时 ， 实 际 上 就 是 执行 该 任 
务 对 象 的 execute() 方 法 ，Quartz 里 的 作业 类 需要 实现 org.quartz.Job 接口 ， 该 Job 接口 包含 一 个 方法 
execute()，execute 方法 体 是 被 调度 的 作业 体 。 

一 旦 实现 了 Job 接口 和 execute( 方 法 ， 当 Quartz 调度 该 作业 运行 时 ， 该 execute0 方 法 就 会 自动 运 
行 起 来 。 

下 面 是 本 示例 程序 中 的 作业 ， 该 作业 实现 了 Job 接口 ， 并 实现 了 该 接口 里 的 execute() 方 法 ， 该 方 
法 循环 100 次 来 模拟 一 个 费时 的 任务 。 
程序 清单 :codes\10\QuartzQs\src\lee\TestJob.java 
public class TestJob 
implements Job 


// 判 断 作业 是 否 执行 的 旗 标 

Private boolean isRunning = false; 

public void execute (JobExecutionContext context) 
throws JobExecutionException 


// 如 果 作业 没有 被 调度 
if (!isRunning) 
{ 


{ 


System.out .println(new Date() + " 作业 被 调度 。"); 


7/ 循环 100 次 来 模拟 任务 的 执行 
for (int i = 0; 1 < 100 ; i++) 
{ 
System.out.println ("作业 完成 ”+ (i + 1) + "$m); 
try 
{ 
Thread. sleep (100); 


CS (InterruptedException ex) 
ex.printstackTrace (); 
} 
System.out.println(new Date() + "” 作业 调度 结束 。"); 
inf 和 即使 获得 调度 ， 也 立即 退出 
t 


System.out .println(new Date() + "任务 退出 "); 
上 


799 


http://52pdf.taobao.com 
蒋 县 龟 Java EE 企业 应 用 实战 (第 3 版 ) 一 


4. Quartz 里 的 触发 器 
Quartz 允许 作业 与 作业 调度 分 离 ，Quartz 使 用 触发 器 将 任务 与 任务 调度 分 离开 ，Quartz 中 的 触发 
器 用 来 指定 任务 的 被 调度 时 机 ， 其 框架 提供 了 一 系列 触发 器 类 型 ， 但 以 下 两 个 是 最 常用 的 : 
> ”SimpleTrigger: 主要 用 于 简单 的 调度 。 例 如 ， 如 果 需 要 在 给 定 的 时 间 内 重复 执行 作业 ， 或 者 
间隔 固定 时 间 执 行 作 业 ， 可 以 选择 SimpleTrigger。SimpleTrigger 类 似 于 JDK 的 Timer。 
> CronTrigger: CronTrigger 用 于 执行 更 复杂 的 调度 。 该 调度 器 基于 Calendar-like。 例 如 我 们 
需要 在 除 星期 六 和 星期 日 以 外 的 每 天 上 午 10: 30 调度 某 个 任务 时 , 则 应 该 使 用 CronTrigger。 
CronTrigger 是 基于 Unix Cron 的 表达 式 。 
Cron 表达 式 是 一 个 字符 串 ， 字 符 串 以 5 个 或 6 个 空格 隔 开 ， 分 成 6 个 或 7 个 域 ， 每 个 域 代表 一 个 
时 间 域 。Cron 表达 式 有 如 下 两 种 语法 格式 。 
Seconds Minutes Hours DayofMonth Month DayofWeek Year。 
上 面 是 包含 7 个 域 的 表达 式 ， 还 有 只 包含 6 个 域 的 Cron 表达 式 。 
Seconds Minutes Hours DayofMonth Month DayofWeek 
每 个 域 可 出 现 的 字符 如 下 。 
> ”Second: 可 出 现 ,、-、*、/4 个 字符 ， 有 效 范围 为 0~59 的 整数 。 
Minutes: 可 出 现 ,、-、*、/4 个 字符 ， 有 效 范围 为 0~59 的 整数 。 
Hours: 可 出 现 ,、-、*、/4 个 字符 ， 有 效 范围 为 0~23 的 整数 。 
DayofMonth: 可 出 现 ,、-、*、?、/、L、W、C 8 个 字符 ， 有 效 范围 为 1~31 的 整数 。 
Month: 可 出 现 ,、-、*、/4 个 字符 ， 有 效 范围 为 1~12 或 JAN-DEC。 
DayofWeek: 可 出 现 ,、-、*、?、/、L、C、 #8 个 字符 ， 有 效 范围 为 1~7 或 SUN-SAT 两 个 
范围 。 其 中 1 表示 星期 日 ，2 表示 星期 一 ， 依 次 类 推 。 
> Year: 可 出 现 ,、-、*、/4 个 字符 ， 有 效 范围 为 1970~2099 年 。 
每 个 域 通常 都 使 用 数字 ， 但 还 可 以 出 现 如 下 特殊 字符 ， 它 们 的 含义 如 下 。 
> “* : 表示 匹配 该 域 的 任意 值 。 假 如 在 Minutes 域 使 用 *， 即 表示 在 每 分 钟 都 会 触发 事件 。 
> ? : 只 能 用 在 DayofMonth 和 DayofWeek 两 个 域 。 它 也 匹配 该 域 的 任意 值 ， 但 实际 应 用 中 
则 不 会 ， 因 为 DayOfMonth 和 DayofWeek 会 互相 影响 。 例 如 ， 想 在 每 月 的 20 日 触发 调度 ， 
无 论 20 日 是 星期 几 ， 则 只 能 使 用 如 下 写法 : 13 13 15 20* ?， 其 中 最 后 一 位 只 能 使 用 ?， 而 
不 能 使 用 *;， 如 果 使 用 * 则 表示 无 论 星 期 几 都 会 触发 ， 但 实际 并 不 是 这 样 。 
> - : 表示 : 例如 ， 在 Minutes 域 使 用 5-20， 表 示 从 5 分 钟 到 20 分 钟 内 每 分 钟 触发 一 次 。 
> 1/ : 表示 从 起 始 时 间 开 始 触发 ， 然 后 每 隔 固定 时 间 触 发 一 次 。 例 如 ， 在 Minutes 域 使 用 5/20， 
则 意味 着 5 分 钟 触发 一 次 ， 而 在 25、45 等 分 钟 时 分 别 触发 一 次 。 
> ，: 表示 列 出 枚 举 值 。 例 如 ， 在 Minutes 域 使 用 5，20， 则 意味 着 在 5 和 20 分 钟 分 别 触发 
-次 。 
> L : 表示 最 后 。 只 能 出 现在 DayofWeek 和 DayofMonth 域 ， 如 果 在 DayofWeek 域 使 用 5L， 
则 意味 着 在 最 后 一 个 星期 四 触发 。 
> W : 表示 有 效 工作 日 〈 星 期 一 到 星期 五 ) 。 只 能 出 现在 DayofMonth 域 ， 系 统 将 在 离 指定 日 
期 最 近 的 有 效 工 作 日 触发 事件 。 例如， 在 DayofMonth 使 用 5W， 如 果 5 日 是 星期 六 ， 则 将 
在 最 近 的 工作 日 星期 一 ， 即 4 日 触发 。 如 果 5 日 是 星期 一 到 星期 五 中 的 一 天 ， 则 就 在 5 日 触 
发 。 需 要 注意 的 是 ，W 不 会 跨 月 寻找 , 例如 ，1W，1 日 恰好 是 星期 六 ， 系 统 不 会 在 上 月 的 最 
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后 一 天 触发 ， 而 是 到 3 日 触发 。 

> LW : 这 两 个 字符 可 以 连接 使 用 ， 表 示 某 个 月 最 后 一 个 工作 日 ， 即 最 后 一 个 星期 五 。 

> # : 用 于 确定 每 个 月 的 第 几 个 星期 几 ， 只 能 出 现在 DayofMonth 域 。 如 4# 5， 表 示 某 月 的 第 
五 个 星期 三 。 

下 面 的 Quartz Cron 表达 式 ， 表 示 在 周一 到 周 五 的 每 天 上 午 10 点 15 分 调度 该 任务 。 


0 15 10 ? * MON-FRI 


下 面 的 表达 式 则 表示 在 2002 一 2005 年 中 的 每 个 月 的 最 后 一 个 星期 五 上 午 10 点 15 分 调度 该 任务 。 
0 15 10 2? * 6L 2002-2005 
5.， Quartz 里 的 调度 器 
调度 器 用 于 将 任务 与 触发 器 关联 起 来 ， 一 个 任务 可 关联 多 个 触发 器 ， 一 个 触发 器 也 可 用 于 控制 多 
个 任务 。 当 一 个 任务 关联 多 个 触发 器 时 ， 每 个 触发 器 被 激发 时 ， 这 个 任务 都 会 被 调度 一 次 ， 当 一 个 触 
发 器 控制 多 个 任务 时 ， 此 触发 器 被 触发 时 ， 所 有 关联 到 该 触发 器 的 任务 都 将 被 调度 。 
Quartz 的 调度 器 由 Scheduler 接口 体现 。 该 接口 声明 了 如 下 方法 。 
> _ void addJob(JobDetail jobDetail, boolean replace): 将 给 定 的 JobDetail 实例 添加 到 调度 器 里 。 
> Date scheduleJob(JobDetail jobDetail, Trigger trigger): 将 指定 的 JobDetail 实例 与 给 定 的 
trigger 关联 起 来 ， 即 使 用 该 tigger 来 控制 该 任务 。 
> “Date scheduleJob(Trigger trigger): 添加 触发 器 tigger 来 调度 作业 。 
下 面 定义 一 个 主 程序 来 调度 前 面 所 定义 的 任务 ， 该 主 程序 代码 如 下 。 
程序 清单 : codes\10\QuartzQs\src\lee\MyQuartzServerjava 
public class MyQuartzServer 


{ 
Public static void main(String[] args) 
{ 


MyQuartzServer server ~ new MyQuartzServer(); 
a 

server.startScheduler()7 
(SchedulerException ex) 
ex.printStackTrace() 7 


} 
// 执 行 调度 
Private void startscheduler() throws SchedulerException 


{ 

// 使 用 工厂 创建 调度 器 实例 

Scheduler scheduler = si 
-getDefaultSscheduler () ; 

// 以 作业 创建 JobDetail 实例 

JobDetail jobDetail = new JobDetail ("dd", 
Scheduler. DEFAULT_GROUP , TestJob.class); 

// 创 建 trigger， 创 建 一 个 简单 的 调度 器 

// 指 定 该 任务 被 重复 调度 50 次 ， 每 次 间隔 20 秒 

Trigger trigger = new SimpleTrigger ("dd" , 
Scheduler .DEEPRULT ,50, 20000) ; 


// 调 度 器 将 作业 与 +rigger 关联 起 来 
scheduler .scheduleJob (jobDetail, trigger ) 7 
// 开 始 调度 


scheduler.start (); 
} 
} 


上 面 程序 中 粗 体 字 代 码 就 是 调度 任务 的 关键 代码 ， 程 序 并 没有 使 用 CronTrigger 来 控制 任务 的 调 
度 ， 只 是 使 用 了 一 个 SimpleTrigger 来 控制 任务 的 调度 。 当 程序 使 用 JobDetail 来 包装 指定 作业 时 ， 指 
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定 了 该 作业 的 名 称 、 作 业 所 在 的 组 。 


和 汪 - 注 意 :六 
使 用 JobDetail 包装 一 个 作业 , 在 包装 时 ， 包括 : 


运行 该 程序 ， 
我 们 看 到 的 是 使 用 Java 程序 来 调度 任务 , 实际 上 Quartz 完全 支持 使 用 配置 文件 进行 任务 调度 , 但 这 不 
是 本 书 介绍 的 重点 ， 故 此 处 不 再 著述 。 


>》>10.5.2 在 Spring 中 使 用 Quartz 


Spring 的 任务 调度 抽象 层 简化 了 任务 调度 ， 在 Quartz 基础 上 提供 了 更 好 的 调度 抽象 。 本 系统 使 用 
Qurtaz 框架 来 完成 任务 调度 ， 创 建 Qutarz 的 作业 Bean 有 以 下 两 个 方法 : 
> ”利用 JobDetailBean 包装 QuartzJobBean 子 类 的 实例 。 
> ”利用 MethodlnvokingJobDetailFactoryBean 工厂 Bean 包装 普通 Java 对 象 。 
采用 这 两 种 方法 都 可 创建 一 个 Quartz 所 需 的 JobDetailBean， 也 就 是 Quartz 所 需要 的 任务 对 象 。 
如 果 采 用 第 一 种 方法 来 创建 Qutarz 的 作业 Bean， 则 作业 Bean 类 必须 继承 了 QuartzJobBean 类 。 
QuartzJobBean 是 一 个 抽象 类 ， 包 含 如 下 抽象 方法 : 
executeInternal (JobExecutionContext ctx); 被 调度 任务 的 执行 体 。 
如 果 采 用 MethodInvokingJobDetailFactoryBean 包装 ， 则 无 须 继承 任何 父 类 ， 直 接 使 用 配置 即 可 。 
配置 MethodInvokingJobDetailFactoryBean， 需 要 指定 以 下 两 个 属性 : 
> targetObject， 指 定 包含 任务 执行 体 的 Bean 实例 。 
> ”targetMethod: 指定 将 指定 Bean 实例 的 该 方法 包装 成 任务 执行 体 。 
采用 JobDetailBean 包装 任务 Bean 的 配置 样 例如 下 : 


<!-- 定义 JobDetailBean Bean --> 
<bean name="quartzDetail" ¢ "org. springframework.scheduling. quartz. JobDetailBean"> 
<!-- 以 指定 QuartzJobBean 子 类 实例 的 executeInternal 
方法 作为 任务 执行 体 --> 
<property name="jobClass" value=" QuartzJobBean 于 类 "/> 
</bean> 
如 果 采 用 MethodInvokingJobDetailFactoryBean 包装 ， 格 式 如 下 : 
<!-- 定义 目标 Bean --> 
<bean id="testQuarz" class="lee.TestQuartz"/> 
<!-- 定义 MethodInvokingJobDetailFactoryBean Bean--> 
<bean id="quartzDetail™" 
class="org.springframework. scheduling.quartz.MethodInvokingJobDetailFactoryBean"> 
<!-- 指定 将 testQuarz 的 test ei -> 
<property name="targetObject" ref="testQuarz "/> 
name="targetMethod" value="test"/> 


</bean> 

完成 上 面 配置 之 后 ， 只 需要 以 下 两 个 步骤 即 可 完成 任务 的 调度 。 

人 @ 使 用 SimpleTriggerBean 或 CronTriggerBean 定义 触发 器 Bean。 

人 使 用 SchedulerFactoryBean 调度 作业 。 

下 面 是 介绍 本 系统 中 两 个 任务 调度 的 作业 类 。 

第 一 个 考勤 作业 :PunchJob。 系 统 每 天 为 员工 自动 插入 两 次 “旷工 ”考勤 记录 ， 而 每 次 员工 实际 
打卡 时 将 会 修改 对 应 的 考勤 记录 。 

程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\schedule\PunchJob.java 

public class PunchdJob 

extends QuartzJobBean 
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// 判 断 作业 是 否 执行 的 旗 标 
private boolean isRunning = false; 
7/ 该 作业 类 所 依赖 的 业务 逻辑 组 件 
private EmpManager empMgr; 
public void setEmpMgr (EmpManager empMgr) 
{ 
this.empMgr = empMgr; 


} 
// 定 义 任务 执行 体 
public void executeInternal (JobExecutionContext ctx) 
throws JobExecutionException 
{ 
if (!isRunning) 
{ 
SYstem.out.println ("开始 调度 自动 打卡 ") ; 
i 


pF 
} 


正如 从 上 面 粗 体 字 代 码 所 看 到 的 ， 该 任务 Bean 仅仅 在 executeInternal0 方 法 内 调用 了 业务 多 辑 方 
法 ， 这 使 得 该 任务 被 调度 时 ， 指 定 业务 逻辑 方法 将 可 以 获得 执行 的 机 会 。 
第 二 个 是 工资 结算 作业 : PayJob。 该 作业 在 每 月 3 日 自动 结算 每 个 员工 上 个 月 的 工资 。 
程序 清单 : codes\10\HRSystem\WWEB-INF\src\org\crazyit\hrsystem\schedule\PayJob.java 
public class PayJob 
extends QuartzJobBean 


// 判 断 作业 是 否 执行 的 旗 标 

private boolean isRunning ~ false; 

// 访 作业 类 所 依赖 的 业务 逻辑 组 件 

private EmpManager empMgr; 

public void setEmpMgr (EmpManager empMgr) 
{ 


{ 


this.empMgr = empMgr; 
} 
// 定 义 任务 执行 体 


public void executeInternal (JobExecutionContext ctx) 
throws JobExecutionException 

{ 
if (!isRunning) 
{ 


System.out .println ("开始 调度 自动 结算 工资 ") ; 
isRunning = true; 

// 调 用 业务 逻辑 方法 

empMgr .autoPay (); 

isRunning = false; 


} 
} 
其 实 我 们 发 现 这 两 个 作业 Bean 的 实现 几乎 完全 相似 ， 为 这 两 个 作业 分 别 定义 两 个 类 真是 太 浪 费 
了 ， 读 者 可 以 思考 如 何 改进 这 两 个 类 的 设计 。 
定义 了 上 面 两 个 任务 Bean 之 后 ， 接 下 来 只 要 在 Spring 配置 文件 中 增加 如 下 配置 ，Spring 将 会 为 
整个 应 用 提供 任务 调度 的 支持 。 
<bean id="cronTriggerpay" 
class="org. springframework. scheduling. quartz.CronTriggerBean"> 
<property name="jobDetail"> 


<!-~ 使 用 赚 套 Bean 的 方式 来 定义 任务 Bean 一 -> 
<bean 
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class="org.springframework-scheduling.quartz- JobpetailBean"> 
<!-- 指定 任务 Bean 的 实现 类 --> 
<property name="jobClass" 
value="org.crazyit.hrsystem. schedule. PayJob"/> 
<!-- 为 任务 Bean 注入 属性 --> 
<property name="jobDataAsMap"> 


<map> 
<entry key="empMgr" value-ref="empManager"/> 
</map> 
</property> 
</bean> 
</property> 


<!-- 指定 Cron 表达 式 : 每 月 3 日 2 时 启动 --> 
<property name="cronExpression" value="0 0 2 3 * ? *"/> 
</bean> 
<!-- 定义 触发 器 来 管理 任务 Bean --> 
<bean id="cronTriggerPunch" 
class="org. springframework.scheduling.quartz.CronTriggerBean"> 
<property name="jobDetail"> 
<!-- 使 用 幅 套 Bean 的 方式 来 定义 任务 Bean --> 
<bean 
class="org. springframework. scheduling.quartz.JobDetailBean"> 
<!-- 指定 任务 Bean 的 实现 类 --> 
<property name="jobClass" 
value="org. crazyit.hrsystem. schedule. PunchJob"/> 
<!-- 为 任务 Bean 注入 属性 --> 
<property name="jobDataAsMap"> 


<map> 
<entry key="empMgr" value-ref="empManager"/> 
</map> 
</property> 
</bean> 
</property> 


<!-- 指定 Cron 表达 式 ， 周 一 到 周 五 7 点 、12 点 执行 调度 -> 
<property name="cronExpression" 
value="0 0 7,12 ? * MON-FRI"/> 
</bean> 
<!-- 执行 实际 的 调度 调度 --> 
<bean 
class="org.springframework.scheduling.quartz.SchedulerFactoryBean"> 
<property name="triggers"> 
<list> 
<ref local="cronTriggerPayn/> 
<ref local="cronTriggerPunch"/> 
</list> 
</property> 
</bean> 


10.6 ”实现 系统 Web 层 


前 面部 分 已 经 实现 了 本 应 用 的 所 有 中 间 层 内 容 ， 系 统 的 所 有 业务 逻辑 组 件 也 都 部 署 在 Spring 容器 
中 了 ， 接 下 来 应 该 为 应 用 实现 Web 层 了 。 通 常 而 言 ， 系 统 的 控制 器 和 JSP 在 一 起 设计 。 因 为 当 JSP 页 
面 发 出 请 求 后 ， 该 请 求 被 控制 器 接收 到 ， 然 后 控制 器 负责 调用 业务 逻辑 组 件 来 处 理 请 求 。 从 这 个 意义 
上 来 说 ， 控 制 器 是 JSP 页 面 和 业务 逻辑 组 件 之 间 的 纽带 。 


>>10.6.1 Struts 2 和 Spring 的 整合 
为 了 在 应 用 中 启用 Struts 2， 首 先 必须 在 web.xml 文件 中 配置 Stmuts 2 的 核心 Filter， 让 该 Filter 拦 
截 所 有 用 户 请 求 。 我 们 在 web.xml 文件 中 增加 如 下 配置 片段 : 


<!-- 定义 Struts 2 的 核心 Filter --> 
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<filter> 
<filter-name>struts2</filter-name> 
<filter-class>org.apache. struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter 
</filter-class> 
</filter> 
<!-- 让 Struts 2 的 核心 filter 拦截 所 有 请 求 --> 
<filter-mapping> 
<filter-name>struts2</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


启动 了 Struts 2 的 核心 Filter 之 后 ， 用 户 请 求 将 被 纳入 Struts 2 管理 之 内 ， 而 FilterDispatcher 就 会 
调用 用 户 实现 的 Action 来 处 理 用 户 请 求 了 。 
实际 上 , Struts 2 的 Action 只 是 用 户 请 求 和 业务 逻辑 方法 之 间 的 纽带 : Action 需要 调用 业务 逻辑 组 
件 的 方法 来 处 理 用 户 请 求 ， 而 系统 的 所 有 业务 逻辑 组 件 都 由 Spring 负责 管理 ， 所 以 需要 在 web.xml 文 
件 中 使 用 load-on-startup 的 Servlet 或 Listener 来 初始 化 Spring 容器 ， 为 此 我 们 在 web.xml 文件 中 增加 
如 下 配置 片段 : 
<!-- 配置 Spring 配置 文件 的 位 置 --> 
<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/applicationContext .xml, 
/WEB-INF/daoContext.xml</param-value> 
</context-param> 
<!--~ 使 用 ContextLoaderListener 初始 化 Spring 容器 --> 
<listener> 
<listener-class>org. springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 
上 面 配置 文件 使 用 ContextLoaderListener 来 初始 化 Spring 容器 ， 并 指定 使 用 WEB-INF 路 径 下 的 
applicationContext.xml、daoContext.xml 文件 作为 Spring 配置 文件 。 
- 旦 Spring 容器 初始 化 完成 , Struts 2 的 Action 可 通过 自动 装配 策略 来 访问 Spring 容器 中 的 Bean， 
例如 Action 中 包含 一 个 setA0 方 法 , 如 果 Spring 容器 中 有 一 个 id 为 a 的 Bean 实例 , 则 该 Bean 将 会 被 
自动 装配 给 该 Action。 本 应 用 也 将 采用 这 种 自动 装配 策略 , 由 于 前 面 应 用 中 两 个 业务 逻辑 组 件 在 Spring 
容器 中 的 id 分 别 为 ， empManager 和 mgrManager， 所 以 本 应 用 为 Employee 角色 和 Manager 的 Action 
分 别提 供 了 两 个 基 类 ， 其 中 Employee 角色 的 Action 基 类 如 下 。 
程序 清单 : codes\10\HRSystem\WWEB-INF\src\org\crazyit\hrsystem\action\base\EmpBaseAction.java 
public class EmpBaseAction 
extends ActionSupport 


/ /依赖 的 业务 逻辑 组 件 

protected EmpManager mgr; 

// 依 赖 注入 业务 逻辑 组 件 所 必须 的 sette 方法 
public void setEmpManager (EmpManager mgr) 
{ 


{ 


this.mgr = mgr; 
} 


》>>10.6.2 控制 器 的 处 理 顺 序 


当 控制 器 接收 到 用 户 请 求 后 ， 控 制 器 并 不 会 处 理 用 户 请 求 ， 只 是 将 用 户 的 请 求 参 数 解析 出 来 ， 然 
后 调用 业务 逻辑 方法 来 处 理 用 户 请 求 ， 当 请 求 处 理 完成 后 ， 控 制 器 负责 将 处 理 结果 通过 JSP 页 面 呈现 
给 用 户 。 图 10.5 显示 了 控制 器 的 处 理 顺序 图 。 

对 于 Struts 2 应 用 而 言 ， 控 制 器 实际 上 由 两 个 部 分 组 成 : 系统 的 核心 控制 器 FilterDispatcher 和 业 
务 控制 器 Action。 关 于 两 个 控制 器 相互 协作 的 细节 请 参看 本 书 第 3 章 。 
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下 面 以 几 个 具有 代表 性 的 用 例 来 介绍 控制 器 层 的 实现 。 


通过 JSP 页 面 发 间 请求 


调用 业务 理 加 方法 


图 10.5 控制 器 的 处 理 顺序 图 
和 10.6.3 员工 登录 


本 系统 的 登录 页 面 是 loginjsp 页 面 ， 当 员工 提交 登录 请 求 后 ， 员 工 输入 的 用 户 名 、 密 码 被 提交 到 
processLogin Action, 该 Action 将 会 根据 请 求 参 数 决定 呈现 哪个 视图 资源 。 员 工 登录 的 流程 图 如 图 10.6 
所 示 。 

从 图 10.6 中 可 以 看 出 ， 当 processLogin 处 理 登录 请 求 后 , 程序 可 以 返回 4 个 逻辑 视图 ， 其 中 input 
是 输入 校 验 失败 后 的 逻辑 视图 。 当 员工 登录 成 功 后 ， 如 果 其 身份 是 经 理 ， 则 转 入 manager/index.jsp; 
如 果 其 身份 是 普通 员工 ， 则 转 入 employee/index.jsp 页 面 。 如 果 登 录 失败 ， 则 再 次 返回 login.jsp 页 面 。 


包 要 Fe managerindex jsp 
总 ro 
ss 名 
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图 10.6 员工 登录 流程 图 


处 理 用 户 登录 的 Action 代码 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\action\LoginAction.java 


public class LoginAction 
extends EmpBaseAction 


// 定 义 一 个 常量 作为 员工 登录 成 功 的 Result 名 
private final String EMP_RESULT = "emp"; 
// 定 义 一 个 常量 作为 经 理 登录 成 功 的 Result 名 
Private final String MGR_RESULT = "mgr"; 
// 封 装 请 求 参 数 
private Manager manager; 
7/ 登录 的 验证 码 
Private String vercode; 

。 // 处 理 登录 后 的 提示 信息 
Private String tip; 
// 此 处 省 赂 各 属性 的 setter 和 getter 方法 
7/ 处 理 用 户 请 求 


public String execute() 


{ 
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throws Exception 


// 创 建 ActionContext 实例 

ActionContext ctx = ActionContext.getContext(); 

// 获 取 HttpSession 中 的 rand 属性 

String ver2 = (String)ctx*getSession() .get ("rand"); 
if (vercode.equalsIgnoreCase (ver2)) 


{ 
// 调 用 业务 逻辑 方法 来 处 理 登 录 请 求 
int result = mgr.validLogin(getManager ()); 
// 登 录 结果 为 普通 员工 
if (result == LOGIN_EMP) 
{ 
ctx.getSession() .put (WebConstant .USER 
, manager.getName()); 
ctx.getsession() .put (WebConstant .LEVEL 
， WebConstant .EMP_LEVEL) 7 
setTip(" 您 已 经 成 功 登录 系统 ") 7 
return EMP_RESULT; 


} 
// 登 录 结 果 为 经 理 
else if (result == LOGIN_MGR) 
{ 
ctx.getSession() .put (WebConstant .USER 
， manager.getName () ) 7 
ctx.getSession() .put (WebConstant .LEVEL 
， WebConstant .MGR_LEVEL); 
setTip(" 您 已 经 成 功 登 录 系统 ") ; 
return MGR_RESULT; 


} 

// 用 户 名 和 密码 不 匹配 
else 

和 


setTip ("用户 名 /密码 不 匹配 ") 7 
return ERROR; 
} 


} 
// 验 证 码 不 匹配 
else 的 


人 
setTip ("验证 码 不 匹配 , 请 重新 输入 ") ; 
return ERROR; 


} 
} 


在 上 面 的 Action 处 理 类 中 ， 先 判断 用 户 输入 的 校 验 码 是 否 正确 ， 如 果 校 验 码 正确 ， 才 开始 处 理 用 
户 请 求 ， 否则 直接 退回 登录 页 面 。 如 果 校 验 码 正 确 ， 用 户 登录 所 用 的 用 户 名 和 密码 也 正确 ， 才 表明 登 
录 系 统 成 功 。 
struts.xml 文件 中 配置 该 Action， 配 置 片 段 如 下 : 
<!-- 定义 处 理 登 录 系 统 的 的 Action --> 


<action name="processLoginn 
class="org.crazyit.hrsystem.action.LoginAction"> 
<result name="input">/WEB-INF/content/login.jsp</result> 
<result name="mgr">/WEB-INF/content/manager/index.jsp</result> 
<result name="emp">/WEB-INF/content/employee/index.jsp</result> 
<result name="error">/WEB-INF/content/login.jsp</result> 
</action> 


在 上 面 的 Action 配置 中 , 并 未 指定 该 Action 与 业务 逻辑 组 件 的 耦合 关系 ，Spring 容器 会 将 业务 逻 
辑 组 件 自动 装配 给 该 Action 对 象 。 上 面 Action 还 涉及 输入 校 验 ， 程 序 为 该 Action 提供 了 一 个 校 验 规 
则 文件 ， 该 校 验 规则 文件 的 代码 如 下 。 

程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\action\LoginAction-validation.xml 
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<?xml version="1.0" encoding="GBK"?> 
<!1DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" 
"http://www.opensymphony. com/xwork/xwork-validator-1.0.3.dtd"> 
<validators> 
<field name="manager.name"> 
<field-validator type="requiredstring"> 
<message> 用 户 名 必 填 ! </message> 
</field-validator> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{4,25})]]></param> 
<message> 您 输入 的 用 户 名 只 能 是 字母 和 数字 ， 且 长 度 必 须 在 4 到 25 之 间 </message> 
</field-validator> 
</field> 
<field name="manager.pass"> 
<field-validator type="requiredstring"> 
<message> 窗 码 必 填 ! </message> 
</field-validator> 
<field-validator type="regex"> 
<param name="expression"><! [CDATA[(\w{4,25})]]></param> 
<message> 您 输入 的 密码 只 能 是 字母 和 数字 ， 且 长 度 必须 在 4 到 25 之 间 </message> 
</field-validator> 
</field> 
<field name="vercode"> 
<field-validator type="requiredstring"> 
ssage> 验 证 码 必 填 ! </message> 
</field-validator> 
<field-validator type="regex"> 
<param name="expression"><![CDATA[ (\w{6,6})]]></param> 
<message> 您 输入 的 验证 码 只 能 是 字母 和 数字 ， 且 长 度 必须 在 6 位 </message> 
</field-validator> 
</field> 
</validators> 


当 员 工 登 录 成 功 后 ，processLogin 会 根据 登录 员工 的 身份 决定 跳 转 到 manager/index.jsp 或 者 
employee/index.jsp 页 面 。 


》>》>10.6.4 进入 打卡 


不 管 是 员工 ， 还 是 经 理 ， 他 们 都 可 以 通过 单 击 “ 打 卡 ” 链 接 来 进入 打卡 ， 当 用 户 发 送 “ 打 卡 ” 请 
求 后 ， 该 请 求 将 交 给 *Punch 进行 处 理 ， 该 Action 可 同时 处 理 经 理 打卡 、 员 工 打 卡 两 个 请 求 。 该 Action 
的 结果 会 返回 当前 员工 的 可 打卡 状态 。 

经 理 、 员 工 进入 打卡 、 打 卡 处 理 的 完整 流程 如 图 10.7 所 示 。 
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图 10.7 进入 打卡 、 打 卡 处 理 的 完整 流程 


从 图 10.7 中 可 以 看 出 ， 当 员工 发 送 “ 打 卡 ” 请 求 后 ， 该 请 求 将 由 *Punch Action 处 理 ， 该 Action 
的 name 是 一 个 模式 字符 串 ， 所 以 它 既 可 处 理 employeePunch.action， 也 可 处 理 managerPunch.action。 
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该 Action 类 的 代码 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\action\PunchAction.java 


public class PunchAction 
extends EmpBaseAction 
{ 
// 封 装 处 理 结果 的 punchIsValid 属性 
private int punchIsValid; 
// 省 略 punchIsValid 属性 的 setter 和 getter 方法 


public String execute() 
throws Exception 

{ 
// 创 建 ActionContext 实例 
ActionContext ctx = ActionContext.getContext (); 
// 获 取 HttpSession 中 的 user 属性 
String user = (String)ctxvgetSession() 

.get (WebConstant .USER) 7 

SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd"); 
// 格 式 化 当前 时 间 
String dutyDay = sdf.format (new Date()); 
// 调 用 业务 逻辑 方法 处 理 用 户 请 求 
int result = mgr.validPunch(user , dutyDay); 
setPunchTsValid (result) 
return SUCCESS; 

} 

} 


该 Action 会 调用 业务 逻辑 组 件 的 validPunch 来 处 理 用 户 请 求 ， 处 理 结束 后 返回 "success" 字 符 串 ， 
该 Action 处 理 普通 员工 的 进入 打卡 请 求 后 将 进入 employee/indexjsp， 当 处 理 经 理 的 进入 打卡 请 求 后 ， 
将 进入 manager/index.jsp。 

在 struts.xml 文件 中 配置 该 *Punch Action 的 配置 片段 如 下 : 


Class="org.crazyit. stem.action.PunchAction"> 

<interceptor-ref name="empStack"/> 

<result>/WEB-INF/content/{1}/punch.jsp</result> 
</action> 


“进入 打卡 ”的 请 求 处 理 结束 后 ， 系 统 将 会 根据 当天 的 可 打卡 状态 显示 不 同 的 打卡 按钮 ， 如 图 10.8 
所 示 。 
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图 10.8 系统 打卡 页 面 


在 图 10.8 中 可 以 看 到 当前 员工 只 能 进行 上 班 打卡 ， 这 就 是 程序 中 EmployeeManager 组 件 的 
validPunch0 方 法 返回 的 结果 。 
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>》10.6.5 处 理 打 卡 


当 经 理 、 员 工 单 击 10.8 所 示 的 “上 班 打卡 ”按钮 〔 当 系统 判断 员工 可 以 进行 “上 班 打卡 ”时 
才 会 出 现 该 按钮 ) 时， 系统 将 会 向 *Come 发 送 请 求 ， 单 击 “ 上 班 打卡 ”按钮 ， 系 统 将 会 向 *Leave 发 送 
请 求 ， 这 两 个 Action 采用 了 同一 个 实现 类 ， 也 就 是 同一 个 Action 类 里 包含 两 个 处 理 逻 辑 。 该 Action 
类 代码 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\action\ProcessPunchAction.java 
public class ProcessPunchAction 
extends Actionsupport 


// 该 Action 所 依赖 的 业务 还 辑 组 件 

Private EmpManager empMgr; 

// 封 装 处 理 结果 的 tip 属性 

private String tip; 

// 依 赖 注 入 业务 逻辑 组 件 的 setter 方法 

public void setEmpManager (EmpManager empMgr) 


{ 


this.empMgr = empMgr7 
} 
// 省 略 tip 属性 的 setter 和 getter 方法 


7/ 处 理 上 班 打卡 的 方法 

public String come() 
throws Exception 

{ 
return process (true); 


} 

// 处 理 下 班 打卡 的 方法 

Public String leave() 
throws Exception 

{ 
return process (false); 

上 

private String process (boolean isCome) 
throws Exception 

{ 
// 创 建 ActionContext 实例 
ActionContext ctx = ActionContext.getContext(); 
// 获 取 HttpSession 中 的 user 属性 
String user = (String)ctx.gets: 

.get (WebConstant ,USER); 
System.out .printin("--—--- 打 卡 -- + user); 
String dutyDay = new java.sql.Date( 
System.currentTimeMillis ()) .tostring(); 

// 调 用 业务 逻辑 方法 处 理 打卡 请 求 
int result = empMgr.punch(user ,dutyDay , isCome); 
switch(result) 
{ 


sion() 


Case PUNCH_FAIL: 
setTip ("打卡 失败 ") ; 
break; 
case PUNCHED: 
setTip ("您 已 经 打 过 卡 了 ， 不 要 重复 打卡 "); 
break; 
case PUNCH_SUCC: 
setTip(" 打 卡 成 功 ") 7 
break; 
上 
return SUCCESS; 
} 
} 


上 面 Action 处 理 打卡 的 核心 代码 是 调用 EmployeeManager 组 件 的 punch 方法 , 该 方法 将 会 根据 当 
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前 时 间 决 定 用 户 的 考勤 类 型 。 该 Action 的 业务 控制 方法 是 come0 和 leave0,， 但 这 两 个 方法 实际 由 系统 


的 process0 方 法 完成 。 

配置 文件 通过 为 <action... 人 > 元 素 指定 method 属性 的 方式 将 该 Action 类 配置 成 两 个 逻辑 Action, 在 
struts.xml 文件 中 配置 *Come、*Leave Action 的 配置 片段 如 下 : 

<!-- 处 理 上 班 打 卡 -> 


<action name="*Come" method="come™ 
class="org.crazyit.hrsystem.action. ProcessPunchAction"> 
<interceptor-ref name="empStack"/> 
<result>/WEB-INF/content/{1} /index. jsp</result> 

</action> 

<!-- 处 理 下 班 打卡 --> 

<action name="*Leave" method="leave" 
class="org.crazyit.hrsystem.action. ProcessPunchAction"> 
<interceptor-ref name="empStack"/> 
<result>/WEB-INF/content /{1)/index.jsp</result> 

</action> 


>>10.6.6 进入 申请 


当 员 工 查看 自己 最 近 三 天 的 异常 考勤 时 ， 如 果 对 某 次 考勤 记录 有 异议 ， 可 以 对 此 次 考勤 记录 提出 
申请 改变 ， 这 种 申请 将 自动 提交 给 该 员工 的 所 属 经 理 ， 经 理 有 权 通 过 或 拒绝 此 次 申请 。 

因为 员工 申请 改变 考勤 类 型 时 ， 必 须 指定 申请 转换 成 哪 种 考勤 类 型 ， 所 以 系统 进入 申请 页 面 时 ， 
该 页 面 必须 能 列 出 系统 中 所 有 考勤 类 型 ， 而 这 些 数据 应 该 由 该 Action 提供 。 

员工 查看 异常 考勤 、 进 入 申请 、 提 交 申请 的 处 理 流程 如 图 10.9 所 示 。 


色 过 入 申请 如 Suconss - 包 


employeamem nend sp roomwweeregem 
Wa 全 寺 
Poeseae rporewnaerp 
图 10.9 进入 申请 、 提 交 申 请 的 处 理 流程 
程序 进入 申请 的 Action 类 代码 如 下 。 


程序 清单 :codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\action\AppChangeAction.java 


public class AppchangeAction 
extends EmpBaseAction 


// 封 装 所 有 异动 的 列表 

private List types; 

//types 属性 的 setter 和 getter 方法 
public void setTypes (List types) 
二 


{ 


this.types = types; 


} 
public List getTypes() 
{ 

return this.types; 


» 

// 处 理 用 户 请 求 

public String execute() 
throws Exception 

{ 
setTypes (mgr.getAllType()); 
return SUCCESS; 
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} 


} 


该 Action 的 处 理 比较 简单 ， 它 仅仅 获取 系统 的 全 部 考勤 类 型 ， 全 部 考勤 类 型 以 types 属性 传 入 
employee/appChange.jsp， 该 JSP 页 面 中 会 以 Struts 2 标签 迭代 输出 所 有 考勤 类 型 ， 以 供用 户 选择 。 下 
面 是 appChange.jsp 页 面 中 生成 提交 表单 的 代码 。 

程序 清单 :codes\10\HRSystem\WEB-INF\content\employee\appChange.jsp 

<s:form action="processApp"> 
<tr bgcolor="#elelel" > 
<td colspan="2"><div class="mytitle"> 
当前 用 户 : <s:property value="#session.user"/></div></td> 
</t: 
St gc TenAaan > 
<td colspan="2"> 请 填写 异动 申请 </td> 
</tr> 
<input type="hidden" name="attId" value="${param.attid}"/> 
elect name="typeId"” label=" 申 请 类 别 " labelposition="left" 


listKey="id" 
listValue="name"/> 
<s:textarea name="reason"” rows="5" cols = "20” label=" 申 请 理由 "/> 
<tr><td colspan="2"> 
<s:submit value=" 提 交 申 请 ”theme="simple"/> 
<s:reset theme="simple”value=" 重 新 填写 "/> 
</td></tr> 
</s:form> 


上 面 页 面 的 粗 体 字 代码 使 用 select 标签 输出 types 集合 ， 将 types 集合 元 素 的 name 属性 作为 列表 
选项 的 文本 ， 将 集合 元 素 的 id 作为 列表 选项 的 value。 

在 struts.xml 文件 中 配置 AppChangeAction， 其 配置 片段 如 下 : 

<!1-- 进入 异动 申请 -> 

<action name="appChange" 
class="org.crazyit.hrsystem.action,AppChangeAction"> 
<interceptor-ref name="store"> 

<param name="operationMode">RETRIEVE</param> 

</interceptor-ref> 
<interceptor-ref name="basicstack"/> 
<interceptor-ref name="empAuth"/> 
<result>/WEB-INF/content/employee/appChange.jsp</result> 


</action> 

当 用 户 查 看 到 最 近 三 天 的 非 正常 考勤 ， 并 对 指定 考勤 记录 进入 申请 页 面 后 ， 将 可 看 到 如 图 10.10 
所 示 的 页 面 。 

当 员 工 在 如 图 10.10 所 示 的 表单 页 中 单 击 “ 提 交 申 请 ”之 后 ， 程 序 将 会 向 processApp 发 送 请 求 ， 
也 就 是 用 户 提交 了 申请 。 


>>10.6.7 提交 申请 


当 用 户 提 交 申请 请 求 后 ， 该 请 求 由 processApp Action 处 理 ， 该 Action 的 代码 如 下 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyit\hrsystem\action\ProcessAppAction.java 


public class ProcessAppAction 
extends EmpBaseAction 


// 申 请 异动 的 出 勤 ID 
private int attId; 

// 希 望 改变 到 出 勤 类 型 
private int typeId; 

// 申 请 理由 

private String reason; 


// 处 理 结果 


x 
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private String tip; 
/ /省略 各 属性 的 setter 和 getter 方法 
// 处 理 用 户 请 求 
public String execute() 
throws Exception 


// 处 理 异动 申请 

boolean result = mgr.addhpplication(attId ， 
typeId , reason); 

// 如 果 申 请 成 功 

if (result) 


setTip(" 您 已 经 申请 成 功 ,等 待 经 理 审阅 ") ; 


{ 


else 


setTip ("申请 失败 ， 请 注意 不 要 重复 申请 ") 7 


} 
return SUCCESS; 


图 10.10 进入 申请 页 面 


上 面 Action 直接 调用 业务 逻辑 组 件 的 addApplication0 方 法 来 处 理 用 户 申请 ， 该 Action 还 根据 处 
理 结果 向 视图 页 面 上 呈现 不 同 的 提示 信息 。 
该 Action 也 需要 进行 输入 校 验 , 校 验 用 户 输入 的 申请 理由 等 。 下 面 是 该 Action 对 应 的 校 验 规则 文 
件 代码 。 
程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyithrsystem\action\ProcessAppAction-validation.xml 
<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" 
"http: //www.opensymphony. com/xwork/xwork-validator-1.0.3.dtd"> 
<validators> 
<field name="attId"> 
<field-validator type="required"> 
<message> 出 勤 ID 必 填 ! </message> 
</field-validator> 
</field> 
<field name="typeId"> 
<field-validator type="required"> 
<message> 希 望 申请 的 出 惑 类 型 必 填 ! </message> 
</field-validator> 
</field> 
<field name="reason"> 
<field-validator type="requiredstring"> 
<message> 申 请 理由 必 填 ! </message> 
</field-validator> 
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<field-validator type="regex"> 
<param name="expression"><! [CDATA[ (\w{6,})]]></param> 
<message> 申 请 理由 的 长 度 必须 在 大 于 6 个 字符 </message> 
</field-validator> 
</field> 
</validators> 


该 Action 需要 进行 输入 校 验 ， 所 以 我 们 必须 为 该 Action 配置 一 个 input 视图 ， 该 input 视图 不 能 
直接 返回 指定 JSP 页 面 ， 而 是 应 该 返回 appChange Action， 如 图 10.9 所 示 。 

为 了 让 processApp Action 输入 校 验 失败 后 自动 转 入 appChange Action， 本 配置 文件 中 使 用 了 
redirect 类 型 的 Result 映射 , 当 使 用 redirect 类 型 的 Result 映射 时 ,所 有 请 求 参数 .请 求 属性 , 以 及 OGNL 
表达 式 里 的 属性 会 全 部 丢失 一 一 但 我 们 需要 appChange 能 输出 校 验 失败 提示 ， 所 以 我 们 配置 
processApp 时 显 式 使 用 store 拦截 器 ， 该 拦截 器 用 于 将 本 次 请 求 的 相关 信息 保存 下 来 , 让 这 些 请 求 可 以 
跨 请 求 使 用 。 下 面 是 该 Action 的 配置 片段 


<!-- 提交 异动 申请 --> 
<action name="processApp" 
class="org.crazyit.hrsystem.action.ProcessAppAction"> 
<interceptor-ref name="store"> 
<param name="operationMode">STORE</param> 
</interceptor-ref> 
<interceptor-ref name="empStack"/> 
<result name="input" type="redirect"> 
action?attid=${attId}</result> 
<result>/WEB-INF/content /employee/index.jsp</result> 
</action> 


正如 上 面 粗 体 字 代 码 中 看 到 的 , 配置 文件 中 显 式 指定 使 用 store 拦截 器 , 该 拦截 器 将 会 把 本 次 请 求 
的 相关 信息 保存 起 来 ， 以 备 跨 请 求 取得 相关 信息 。 为 了 在 另 一 个 请 求 中 取得 本 次 请 求 的 相关 信息 ， 程 
序 在 另 一 个 Action 中 也 应 该 使 用 store 拦 鹤 器 , 只 是 使 用 store 拦截 器 的 RETRIEVE 操作 ,所 以 我 们 可 
以 在 前 面 的 appChange Action 中 看 到 如 下 配置 片段 ; 

<interceptor-ref name="store"> 


<param name="operationMode">RETRIEVE</param> 
</interceptor-ref> 


》>》>10.6.8 使 用 拦截 器 完成 权限 管理 


正如 前 面 各 Action 配置 代码 中 看 到 的 ， 每 个 <action... 人 > 元 素 里 都 配置 了 一 个 权限 检查 的 拦 苓 器 ， 该 
拦截 器 负责 检查 当前 用 户 权限 ， 该 权限 是 否 足够 处 理 实际 请 求 。 如 果 权 限 不 够 ， 系 统 将 退回 登录 页 面 。 

本 系统 为 普通 员工 、 经 理 分 别提 供 不 同 的 拦截 器 , 普通 员工 的 拦截 器 只 要 求 HttpSession 里 的 level 
属性 不 为 null， 且 level 属性 为 emp 或 mgr 都 可 以 。 下 面 是 普通 员工 的 权限 检查 拦截 器 代码 。 

程序 清单 : codes\10\HRSystem\WEB-INF\src\org\crazyithrsystem\action\authority\EmpAuthorityInterceptorjava 


public class EmpAuthorityInterceptor 
extends AbstractInterceptor 


{ 
public String intercept (ActionInvocation invocation) 
throws Exception 
{ 
// 创 建 ActionContext 实例 
ActionContext ctx = ActionContext.getContext (); 
// 获 取 Httpsession 中 的 level 属性 
String level = (String)ctx.getsession() 
.get (WebConstant .LEVEL); 
// 如 果 level 不 为 nul1， 且 level 为 emp 或 mgr 
if (level != null 
65 (level.equals (WabConstant.EMP_LEVEL) 
11 level.equals (WebConstant.MGR_LEVEL))) 
{ 
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return invocation.invoke(); 


正如 上 面 文件 中 粗 体 字 代码 所 示 ， 如 果 HttpSession 里 的 level 属性 不 为 null， 且 level 属性 为 emp 
或 mgr 时 ， 该 拦截 器 将 会 “放行 求 ， 该 请 求 就 可 以 得 到 正常 处 理 ， 否 则 ， 系 统 直接 返回 "login" 
字符 串 ， 也 就 是 让 用 户 重新 登录 。 

对 经 理 角色 进行 权限 检查 的 拦截 器 代码 与 此 完全 类 似 ， 只 是 它 需要 HttpSession 里 的 level 属性 为 
mgr， 如 下 面 的 程序 所 示 。 

程序 清单 : codes\10\HRSystem\WWEB-INF\src\org\crazyithrsystem\action\authority\MgrAuthorityInterceptorjava 


public class MgrAuthorityInterceptor 
extends AbstractInterceptor 


public String intercept (ActionInvocation invocation) 
throws Exception 
{ 
// 创 建 ActionContext 实例 
ActionContext ctx = ActionContext.getContext (); 
// 获 取 BttpSession 中 的 level 属性 
String level = (String) ctx.getSession() 
.get (WebConstant .LEVEL) ; 
// 如 果 level 不 为 null, 且 level 为 mgr 
if ( level != null 
65 level.equals (WebConstant.MGR_LEVEL)) 
‘ 
return invocation.invoke(); 


return Action.LOGIN; 


} 
} 


将 这 两 个 拦截 器 配置 在 struts.xml 文件 中 ， 其 配置 片段 如 下 : 
<interceptors> 
<!-- 配置 普通 员工 角色 的 权限 检查 拦截 器 --> 
<interceptor name="empAuth" class= 
"org.crazyit.hrsystem.action.authority.EmpAuthorityInterceptor"/> 
<!-- 配置 经 理 角色 的 权限 检查 拦截 器 -> 
<interceptor name="mgrAuth" class= 
"org.crazyit.hrsystem.action.authority .MgrAuthorityInterceptor"/> 
<!-- 配置 普 通 员工 的 默认 的 拦截 器 栈 -> 
<interceptor-stack name="empStack"> 
<interceptor-ref name="defaultStack"/> 
<interceptor-ref name="empAuth"/> 
</interceptor-stack> 
<!-~ 配置 经 理 的 默认 的 拦截 器 栈 --> 
<interceptor-stack name="mgrStack"> 
<interceptor-ref name="defaultstack"/> 
<interceptor-ref name="mgrAuth"/> 
</interceptor-stack> 
</interceptors> 


- 旦 在 struts.xml 文件 中 配置 了 empAuth、mgrAuth 两 个 拦截 器 , 我 们 就 可 以 在 普通 员工 的 Action、 
经 理 的 Action 中 分 别 应 用 这 两 个 权限 检查 的 拦截 器 ， 为 了 <action... 人 > 元 素 中 拦截 器 的 配置 ， 上 面 配置 
文件 中 还 配置 了 empStack、mgrStack 两 个 拦截 器 栈 , 这 样 使 得 普通 员工 的 Action、 经 理 的 Action 只 需 
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分 别 使 用 这 两 个 拦截 器 栈 即 可 。 
10.7 本章 小 结 


本 章 介绍 了 一 个 完整 的 Java EE 项 目 : 简单 工作 流 系统 ,在 此 系统 的 基础 上 可 扩展 出 企业 OA、 企 
业 工作 流 等 。 因 为 企业 平台 本 身 的 复杂 性 ， 所 以 本 项 目 涉及 的 表达 到 7 个 之 多 ， 而 且 工 作 流 的 业务 逻 
辑 也 比较 复杂 ， 这 些 对 初学 者 可 能 有 一 定 难度 ， 但 只 要 读者 先 认真 阅读 本 书 前 面 9 章 所 介绍 的 知识 ， 
并 结合 本 章 的 讲解 ， 再 配合 光盘 中 的 案例 代码 ， 一 定 可 以 掌握 本 章 所 介绍 的 内 容 。 

本 章 所 介绍 的 Java EE 应 用 综合 了 前 面 介绍 的 三 个 框架 : Struts 2.2 + Spring 3.0 + Hiberate 3.6， 因 
此 本 章 内 容 既 是 对 前 面 知识 点 的 回顾 和 复习 ， 也 是 将 理论 知识 应 用 到 实际 开发 的 典范 。 一 旦 读者 掌握 
了 本 章 案例 的 开发 方法 之 后 ， 就 会 对 实际 Java EE 企业 应 用 的 开发 产生 豁然 开朗 的 感觉 。 
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电子 工党 出 上扬 社 : 


《 轻 量 级 Java EE 企业 应 用 实战 : Struts 2 + Spring 3 
+ Hibernate 整合 开发 》( 第 3 版 ) 读者 交流 区 


尊敬 的 读者 : 
感谢 您 选择 我 们 出 版 的 图 节 ， 您 的 支持 与 信任 是 我 们 持续 上 升 的 动力 。 为 了 使 您 能 通过 本 书 
更 透彻 地 了 解 相关 急 域 ， 更 深入 的 学 习 相关 技术 ,我们 将 特别 为 您 提供 一 系列 后 续 的 服务 , 包括 : 


1 提供 本 书 的 修订 和 升级 内 容 、 相 关 配 套 资料 ; 
2， 本 书 作者 的 见面 会 信息 或 网 络 视频 的 沟通 活动 ; 
3， 相 关 领 域 的 培训 优惠 等 。 
您 可 以 任意 选择 以 下 四 种 方式 之 一 与 我 们 联系 ， 我 们 都 将 记录 和 保存 您 的 信息 ， 并 给 您 提供 
不 定期 的 信息 反馈 。 
1. 在 线 提交 
油 登录 www.broadview.com.cn/12814， 填 写本 书 的 读者 调查 表 。 
: 2. 电子 邮件 
您 可 以 发 邮件 至 jsj@phei.com.cn 或 editor@broadview.com.cn。 
3， 读 者 电话 
您 可 以 直接 拨打 我 们 的 读者 服务 电话 : 010-88254369。 
4. 信件 
您 可 以 写 信 至 如 下 地 址 : 北京 万 寿 路 173 信 箱 博文 视点 ， 邮 编 : 100036。 
您 还 可 以 告诉 我 们 更 多 有 关 您 个 人 的 情况 ， 及 您 对 本 节 的 意见 、 评 论 等 ， 内 容 可 以 包括 ， 
(1) 您 的 姓名 、 职 业 、 您 关注 的 领域 、 您 的 电话 、E-mail 地 址 或 通信 地 址 ; 
(2) 您 了 解 新 节 信 息 的 途径 、 影 响 您 购买 图 书 的 因素 ; 
(3) 您 对 本 节 的 意见 、 您 读 过 的 同 领域 的 图 节 、 您 还 希望 增加 的 图 世 、 您 希望 参加 的 培训 等 。 


如 果 您 在 后 期 想 停止 接收 后 续 资 讯 ， 只 需 编写 邮件 “ 退 订 + 需 退 订 的 邮箱 地 址 ”发 送 至 邮箱 : 
market@broadview.com.cn 即 可 取消 服务 。 


同时 , 我 们 非常 欢迎 您 为 本 书 撰写 书评 , 将 您 的 切身 感受 变 成 文字 与 广大 书 友 共 
享 。 我 们 将 挑选 特别 优秀 的 作品 转载 在 我 们 的 网 站 (www.broadview.ecom.en ) 上 , 或 
推荐 至 CSDN.NET 等 专业 网 站 上 发 表 , 被 发 表 的 书评 的 作者 将 获得 价值 50 元 的 博文 视 
点 图 书 奖励 。 

更 多 信息 ， 请 关注 博文 视点 官方 微 埔 : http://tsina.com.cn/broadviewbj。 
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